Hubungkan Asisten AI (MCP)

DM Champ menyediakan server MCP resmi — sebuah endpoint Model Context Protocol yang memungkinkan asisten AI seperti Claude Code, Claude Desktop, ChatGPT, Cursor, dan aplikasi Anda sendiri untuk mengoperasikan akun DM Champ Anda secara langsung. Tanyakan dalam bahasa sehari-hari (“tampilkan kampanye langsung saya”, “tambahkan prospek ini”, “berapa biaya AI saya minggu ini?”) dan asisten akan memanggil API DM Champ untuk Anda.

Ini adalah API v1 yang sama yang didokumentasikan di bagian API, diautentikasi dengan kunci API Anda sendiri. Server MCP membangun satu alat untuk setiap operasi dalam spesifikasi API kami yang dipublikasikan, sehingga mencakup sebagian besar, namun tidak semua, API v1: kontak, pesan, kampanye, agen AI, basis pengetahuan, janji temu, analitik, tag, daftar, dan sub-akun. Siaran, Otomatisasi, dan Transaksi belum tersedia sebagai alat MCP — gunakan REST API secara langsung untuk fitur tersebut. Dalam apa yang dieksposnya, tidak ada izin per alat dan tidak ada default baca-saja, jadi kunci API adalah satu-satunya kontrol akses.

Endpoint: https://mcp.youraiconnector.com/mcp
Otentikasi: kunci API DM Champ Anda (dikirim sebagai header X-API-Key)
Persyaratan: paket dengan akses API. Buat kunci API →

Kunci API Anda bertindak atas akun Anda sendiri, dengan izin yang sama seperti sisa API lainnya — dan dapat membaca akun klien yang Anda kelola, jika Anda menggunakan paket agensi (lihat di bawah). Perlakukan kunci ini seperti kata sandi. Anda dapat mencabutnya kapan saja dari Pengaturan → Integrasi → Kunci API, yang akan langsung memutus akses asisten.

Claude Code

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Kemudian jalankan /mcp di dalam Claude Code untuk memastikan bahwa dm-champ ✓ terhubung.

Secara default, server ditambahkan pada cakupan lokal (hanya Anda, proyek ini). Gunakan --scope user untuk membuatnya tersedia di semua proyek Anda, atau --scope project to commit it to a repo’s .mcp.json untuk tim Anda:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json Anda (Pengaturan → Pengembang → Edit Konfigurasi) dan tambahkan:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Mulai ulang Claude Desktop. Alat DM Champ akan muncul di menu alat.

ChatGPT

Konektor MCP kustom tersedia di ChatGPT Business, Enterprise, dan Pro. Pemilik atau admin ruang kerja harus mengaktifkan developer mode / custom connectors di pengaturan ruang kerja terlebih dahulu — tanpanya, opsi untuk membuat konektor tidak akan muncul.

Kemudian buat konektor dengan:

URL: https://mcp.youraiconnector.com/mcp
Otentikasi: Header kustom
Nama header: X-API-Key
Nilai header: kunci API DM Champ Anda

URL harus diakhiri dengan /mcp. Menempelkan hanya https://mcp.youraiconnector.com adalah kesalahan yang paling umum — ChatGPT memeriksa alamat tersebut, tidak menemukan apa pun di sana, dan menampilkan “Unable to add connector URL”.

Cursor & klien MCP lainnya

Sebagian besar editor yang mendukung MCP menggunakan format .mcp.json yang sama seperti yang ditunjukkan di atas (server HTTP dengan url dan header X-API-Key). Tambahkan server dm-champ yang mengarah ke https://mcp.youraiconnector.com/mcp dan tempel kunci API Anda di header.

API Claude (bangun ke dalam aplikasi Anda sendiri)

Anda dapat menghubungkan server MCP secara terprogram dengan konektor MCP API Claude, sehingga agen yang Anda bangun dapat menggunakan alat DM Champ tanpa klien terpisah:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

Apa yang dapat Anda lakukan

Dalam bagian API v1 yang diekspos oleh server MCP, asisten akan memilih alat yang tepat secara otomatis:

Kampanye: mencantumkan, membuat, memperbarui, menjeda/melanjutkan, memeriksa konfigurasi bot.
Kontak: mencari, membuat, memberi tag, menambahkan ke daftar, mengimpor.
Basis pengetahuan / FAQ: menambahkan, mengedit, impor massal, menyetujui saran AI.
Pesan: membaca percakapan, mengirim pesan ke kontak.
Janji temu: mencantumkan, memesan, membatalkan.
Tugas: membuat, menyelesaikan, mencantumkan.
Analitik: statistik pesan, penggunaan kredit, biaya AI.
Saluran: memeriksa status koneksi, memulai alur koneksi.

Bertanya tentang akun klien Anda (agensi)

Satu koneksi mencakup setiap akun yang Anda kelola. Anda tidak perlu menambahkan koneksi kedua per klien: pada paket agensi, asisten dapat membaca akun klien mana pun di bawah Anda, sehingga Anda dapat bertanya tentang semuanya dalam satu percakapan. Cukup sebutkan nama kliennya:

“Berapa banyak kontak yang dimiliki Bella’s Bistro?”
“Berapa biaya AI untuk masing-masing klien saya minggu ini?”
“Kampanye mana yang sedang aktif untuk Northside Dental, dan bagaimana status saluran mereka?” Ini mencakup pembacaan kontak, pesan, obrolan, kampanye, janji temu, tugas, tag, acara, FAQ, sumber basis pengetahuan, nomor telepon, saluran, webhook, dan analitik. Kami memeriksa apakah akun tersebut benar-benar milik Anda sebelum menjalankan apa pun — meminta akun yang bukan milik Anda akan menghasilkan respons “tidak ditemukan”. Abaikan klien dan asisten akan membaca akun Anda sendiri, persis seperti sebelumnya. Mengubah akun klien lebih terbatas. Menyiapkan agen AI, fungsi kustom, templat WhatsApp, titik masuk, koneksi saluran, status kampanye, dan membeli nomor semuanya berfungsi untuk klien yang disebutkan; sebagian besar tindakan tulis lainnya masih berjalan di akun Anda sendiri, jadi lakukan tindakan tersebut dari kunci klien itu sendiri atau dari REST API, yang mencakup lebih banyak hal.

Ini juga merupakan jawaban bagi klien yang menjalankan beberapa bisnis di bawah satu login. Berikan setiap bisnis akunnya sendiri, lalu undang email klien sebagai anggota tim di semua akun tersebut: mereka masuk sekali dan beralih antar merek mereka dengan pemilih akun di bilah sisi.

Memberikan dokumen bantuan kepada asisten Anda

Server MCP memberikan akun Anda kepada asisten; server tersebut tidak memberikan dokumentasi ini. Jika Anda juga ingin asisten menjawab pertanyaan “bagaimana cara saya…” dengan benar, arahkan asisten ke https://docs.youraiconnector.com/llms.txt (indeks setiap halaman bantuan dengan tautan ke versi Markdown setiap halaman) atau https://docs.youraiconnector.com/llms-full.txt (seluruh dokumentasi dalam satu file Markdown). Keduanya bersifat publik, tidak memerlukan kunci, dan dibangun ulang setiap kali ada perubahan dokumentasi. Lihat Membaca dokumen ini sebagai Markdown.

Menemukan atau Membuat Kunci API Anda

Kunci API yang digunakan koneksi ini berada di Pengaturan → Integrasi → Kunci API — bagian tersendiri, terpisah dari Webhook. Lihat Akses API untuk langkah-langkah pastinya.

Pemecahan Masalah

“Unable to add connector URL” (ChatGPT) / “connection refused” — alamatnya tidak menyertakan /mcp di bagian akhir. Gunakan https://mcp.youraiconnector.com/mcp, bukan https://mcp.youraiconnector.com.
Needs authentication / 401 — kunci API Anda hilang atau salah. Tambahkan kembali server dengan X-API-Key yang valid.
A tool returns 403 — paket atau peran tim Anda tidak mengizinkan tindakan tersebut; server MCP tidak menerapkan batasan tambahan apa pun, ini adalah pemeriksaan izin yang sama dengan API.
Tool not found — daftar alat dibuat secara langsung dari API, sehingga selalu sesuai dengan versi saat ini; sambungkan kembali untuk menyegarkan.
Peringatan keamanan atau sertifikat pada domain Anda sendiri — mengarahkan catatan DNS ke kami saja tidak cukup: subdomain juga harus diverifikasi di dasbor sebelum dapat menyajikan koneksi yang aman. Agensi white-label dapat menempatkan alamat MCP pada domain mereka sendiri (misalnya mcp.youragency.com) dari kartu Custom domain di bawah Settings → White Labeling — tambahkan CNAME di registrar Anda terlebih dahulu, lalu masukkan nama host di blok MCP domain (AI assistants) dan klik Verify, alur yang sama seperti subdomain bermerek Anda yang lain. Sampai diverifikasi, gunakan alamat standar di atas — alamat tersebut tidak bermerek, jadi aman untuk dibagikan kepada klien.

Langkah Selanjutnya

Akses API — buat atau rotasi kunci yang digunakan koneksi ini.
Webhook — mitra berbasis push untuk koneksi MCP berbasis pull ini.

Hubungkan Asisten AI (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor & klien MCP lainnya #

API Claude (bangun ke dalam aplikasi Anda sendiri) #

Apa yang dapat Anda lakukan #

Bertanya tentang akun klien Anda (agensi) #

Memberikan dokumen bantuan kepada asisten Anda #

Menemukan atau Membuat Kunci API Anda #

Pemecahan Masalah #

Langkah Selanjutnya #