Untuk developer · Mendukung Claude & Cursor

Panduan integrasi MCP

Gunakan Model Context Protocol agar Claude, Cursor, atau agen AI Anda sendiri dapat melihat data DEXUN AdWhiz Anda: akun iklan yang terhubung di tiga platform, rekomendasi AI, dan aktivitas terbaru. Hanya-baca.

Apa itu MCP?

MCP (Model Context Protocol) adalah standar terbuka yang diluncurkan Anthropic pada 2024 untuk mengatur cara aplikasi AI mengakses data dan alat eksternal secara aman. Anggap saja sebagai "USB-C untuk AI" — satu antarmuka agar klien MCP apa pun (Claude Desktop, Cursor, agen Anda sendiri) dapat memanggil server MCP apa pun (DEXUN AdWhiz, Notion, GitHub, dll.).

Server MCP DEXUN AdWhiz menyediakan 5 alat hanya-baca: akun iklan yang terhubung, rekomendasi AI yang masih terbuka, ringkasan penghematan, aktivitas akun terbaru, dan kuota API Anda. Server ini tidak dapat mengubah, menjeda, atau membuat apa pun di akun iklan Anda. Setiap panggilan diautentikasi dengan API key Anda dan mengikuti batas laju per paket yang sama dengan REST API kami.

Mulai cepat

Tiga langkah. Sekitar lima menit sampai Anda bisa bertanya kepada asisten AI tentang akun iklan Anda.

1

Konfigurasi Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) lalu tambahkan:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Konfigurasi Cursor

Melalui .cursor/mcp.json tingkat proyek atau konfigurasi global:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Verifikasi

Mulai ulang Claude atau Cursor, lalu coba prompt ini. Jika AI memanggil list_ad_accounts atau list_recommendations dan mengembalikan data asli Anda, Anda sudah terhubung.

Tanya Claude:

“Tampilkan akun iklan saya yang terhubung dan rangkum rekomendasi AI yang masih terbuka — kampanye mana yang disarankan untuk diubah, dan apa alasannya?”

Katalog alat

Server MCP menyediakan 5 alat, semuanya hanya-baca. Setiap alat memiliki JSON Schema lengkap, sehingga AI memutuskan sendiri kapan memanggil alat yang mana.

list_ad_accounts

Hanya-baca

Akun Google Ads, Meta Ads, dan TikTok Ads yang terhubung beserta status koneksinya.

list_recommendations

Hanya-baca

Rekomendasi optimasi AI yang masih terbuka (naikkan anggaran, turunkan, jeda), masing-masing dengan alasan, dampak yang diharapkan, dan tingkat keyakinan.

get_savings_summary

Hanya-baca

Ringkasan penghematan: mengarahkan ke angka penghematan di dasbor Anda, beserta paket Anda.

get_recent_activity

Hanya-baca

Aktivitas akun terbaru: login, perubahan API key, koneksi akun iklan, dan perubahan langganan.

get_quota

Hanya-baca

Batas laju API Anda saat ini: permintaan per menit, sisa kuota, dan kapan jendela waktu direset.

Klien AI Anda menampilkan alat yang sama beserta parameternya melalui permintaan MCP standar tools/list.

Contoh sesi

Contoh percakapan (data contoh) yang menunjukkan seperti apa akses hanya-baca:

Akun iklan apa saja yang saya hubungkan ke AdWhiz?

Anda punya tiga akun yang terhubung: masing-masing satu di Google Ads, Meta Ads, dan TikTok Ads. Ketiganya berstatus terhubung.

list_ad_accounts

Apa rekomendasi AI saat ini?

Ada 2 rekomendasi yang masih terbuka: ① turunkan anggaran harian kampanye Meta “Lookalike 1%” — ROAS-nya di bawah rata-rata akun selama seminggu terakhir; ② naikkan anggaran sebuah kampanye TikTok Spark Ads. Masing-masing disertai alasan dan tingkat keyakinan. Jika ingin menerapkannya, lakukan di platform iklan Anda — dari sini saya tidak bisa mengubah apa pun.

list_recommendations

Apakah ada perubahan di akun saya belakangan ini?

Dalam 7 hari terakhir: 2 kali login, 1 API key baru, dan akun TikTok Ads Anda dihubungkan ulang. Tidak ada catatan lain.

get_recent_activity

Keamanan & izin

  • Kelima alat bersifat hanya-baca: AI dapat melihat data Anda, tetapi tidak dapat mengubah anggaran, menjeda iklan, atau membuat kampanye
  • Server MCP berjalan secara lokal — API key dxk_ Anda tidak pernah keluar dari mesin Anda ke pihak ketiga
  • Panggilan diautentikasi dengan API key Anda dan berbagi batas laju REST API sesuai paket Anda (cek dengan get_quota)
  • Perubahan pada kampanye Anda dilakukan sendiri oleh Anda, bukan melalui MCP
  • Cabut akses MCP kapan saja di dasbor → Pengaturan → API Keys