# Hubungkan Asisten AI (MCP)

<span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> untuk Anda.

Ini adalah API v1 yang sama yang didokumentasikan di [bagian API](../api/getting-started.md), 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 <span data-t="appName">DM Champ</span> Anda (dikirim sebagai header `X-API-Key`)
- **Persyaratan:** paket dengan akses API. [Buat kunci API →](api-access.md#generating-your-api-key)

> 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

```bash
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:

```json
{
  "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:

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

Mulai ulang Claude Desktop. Alat <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> tanpa klien terpisah:

```json
{
  "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](../agency/api-for-agencies.md), 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.dmchamp.com/llms.txt` (indeks setiap halaman bantuan dengan tautan ke versi Markdown setiap halaman) atau `https://docs.dmchamp.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](../api/getting-started.md#reading-these-docs-as-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](api-access.md#generating-your-api-key) 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](api-access.md) — buat atau rotasi kunci yang digunakan koneksi ini.
- [Webhook](webhooks.md) — mitra berbasis push untuk koneksi MCP berbasis pull ini.