Skip to main content

​
Ikhtisar

Nudgen menyediakan server MCP di endpoint /mcp pada origin aplikasi Anda. Server ini menggunakan MCP 2026-07-28 melalui Streamable HTTP dan memerlukan OAuth 2.1. Hubungkan klien yang mendukung transport tersebut. Masuk ke Nudgen di browser, pilih ruang kerja, lalu setujui izin yang diminta klien. Koneksi Anda tetap terikat ke ruang kerja tersebut, meskipun nanti Anda beralih ruang kerja di dasbor.

​
Mengapa hal ini penting

Asisten Anda dapat membaca kontak dan kampanye, menemukan bisnis di sekitar, membuat draf konten, dan menyiapkan kampanye untuk diluncurkan tanpa menangani sesi dasbor atau Personal Access Token. Anda meninjau setiap pengiriman nyata atau penjadwalan di browser sebelum tindakan tersebut dapat dilanjutkan.

​
Hubungkan klien Anda

Endpoint produksi adalah:
Tambahkan endpoint tersebut sebagai server MCP HTTP jarak jauh di klien yang mendukung OAuth. Klien akan menemukan server otorisasi Nudgen dari endpoint tersebut, lalu membuka alur masuk dan persetujuan di browser. Pilih ruang kerja yang ingin diakses klien dan setujui hanya cakupan yang diperlukan. Dokumen discovery: Server otorisasi menggunakan authorization code dengan PKCE S256, resource binding, dan rotasi refresh token. Server ini menerima Client ID Metadata Documents dan pendaftaran klien dinamis. Untuk Codex CLI, gunakan:
Jika klien bernama nudgen sudah dikonfigurasi, perbarui entri tersebut dengan URL /mcp. Jika Anda hanya perlu memeriksa data, minta campaigns:read. Tambahkan campaigns:write jika klien perlu mengubah kontak, draf, pengaturan merek, atau prospek yang diimpor. Tambahkan campaigns:send hanya jika klien perlu meminta persetujuan peluncuran.
Personal Access Token mengautentikasi API Pengembang, tetapi tidak mengautentikasi /mcp. Klien MCP harus menyelesaikan proses masuk OAuth.

​
Alat yang tersedia

create_campaign menyimpan draf kampanye (one-time, drip, atau lifetime). Alat ini tidak dapat langsung mengirim atau menjadwalkan kampanye. get_campaign memungkinkan Anda memeriksa subjek, konten, tautan, audiens, dan pengirim sebelum peluncuran. Server juga menyediakan sumber daya hanya-baca melalui campaigns:read:

​
Temukan dan impor prospek dari peta

  1. Minta asisten memanggil search_map_leads dengan lokasi dan kata kunci bisnis, seperti kota dan marketing agency.
  2. Filter opsionalnya adalah radiusKm (1–100), lat dan lng, serta emailOnly untuk mempertahankan bisnis yang mencantumkan email.
  3. Jika hasil menyertakan nextPageToken, teruskan nilainya sebagai pageToken untuk memuat halaman berikutnya.
  4. Minta asisten memanggil import_map_leads dengan lokasi dan kata kunci yang sama, beserta objek prospek yang akan disimpan. Setiap panggilan menerima hingga 200 prospek.
Proses impor menulis kontak ke ruang kerja yang terhubung. Prospek tanpa email akan dilewati. Prospek yang sudah ada akan diperbarui.

​
Setujui peluncuran kampanye

  1. Minta asisten memeriksa draf dengan get_campaign.
  2. Minta asisten memanggil prepare_campaign_launch dengan ID kampanye dan waktu kirim sekarang atau waktu terjadwal yang persis Anda inginkan. Panggilan ini mengembalikan URL persetujuan sekali pakai; belum ada email yang dikirim.
  3. Buka URL tersebut, tinjau ruang kerja, perkiraan penerima, konten, pengirim, dan waktu, lalu klik Setujui peluncuran.
  4. Kembali ke klien agar klien dapat memanggil launch_campaign dengan ID kampanye, waktu, dan approvalId yang sama.
Persetujuan kedaluwarsa setelah 10 menit dan hanya dapat digunakan sekali. Jika kampanye atau pengirim berubah, minta persetujuan baru. Saat peluncuran, Nudgen kembali memeriksa kesiapan pengirim, penerima yang memenuhi syarat, langganan, kuota, dan ketersediaan antrean. Pengiriman baru dimulai setelah worker kampanye memproses peluncuran.
Menyetujui dan menyelesaikan launch_campaign dapat mengirim email nyata. Gunakan alur kirim percobaan di dasbor untuk memeriksa pratinjau kotak masuk sebelum menyetujui audiens nyata.

​
Kelola akses

Buka Pengaturan → Kunci API → Aplikasi MCP terhubung untuk melihat ruang kerja dan cakupan setiap klien yang terhubung. Cabut koneksi di sana jika klien tidak lagi boleh memiliki akses. Pencabutan menonaktifkan token dan persetujuan peluncuran tertundanya. Anda dapat menghubungkannya kembali melalui OAuth nanti. Izin OAuth berlaku paling lama 90 hari. Kehilangan akses ke ruang kerja juga mencegah klien menggunakan koneksi ruang kerja tersebut.

​
Pemecahan masalah

Untuk skrip yang menggunakan bearer token dan endpoint REST langsung, lihat API Pengembang.

​
Radius pencarian dan pengayaan

API dan MCP memakai 5 km secara default dan menerima bilangan bulat radiusKm 1–100 tanpa dialog konfirmasi dasbor. Pertahankan parameter saat mengirim nextPageToken sebagai pageToken. Halaman kosong masih dapat memiliki halaman berikutnya. enrichmentPending menandai riset situs yang belum selesai. Tinjau businessSummary dan businessSources jika tersedia. Konteks bisnis yang diimpor dapat membantu pembuka kampanye yang dipersonalisasi. Email yang belum ada mungkin masih diteliti. Jika ada enrichmentRetryToken, panggil retry_map_leads_enrichment dengan token dan campaigns:read. Token terikat ke ruang kerja tersambung, berlaku 15 menit, dan hanya sekali pakai. Gabungkan hasil berdasarkan placeId sebelum impor. emailOnly menyaring respons saat ini; lead dapat muncul setelah percobaan ulang.

​
Mengedit draf dan cakupan produk

Gunakan update_campaign untuk mengedit draf yang ada dan delete_campaign untuk menghapus draf. Keduanya memerlukan campaigns:write; keduanya tidak mengirim atau menjadwalkan email. Area produk baru memerlukan izin OAuth tersendiri. Hubungkan kembali dan setujui izin tersebut saat diminta. Daftar alat menampilkan alat yang tersedia beserta argumennya. Pengalihan ke browser tidak menjalankan tindakan: selesaikan pembayaran, otorisasi penyedia, pengiriman undangan, perpindahan ruang kerja, dan pengaturan pencairan sensitif di browser. Koneksi MCP tetap terikat pada ruang kerja yang diotorisasi. Administrasi, kredensial, webhook, callback pelacakan, dan asisten internal tidak disertakan. Gunakan get_api_capabilities untuk memeriksa cakupan API. Untuk pengiriman uji, aktivasi lifetime, atau peristiwa lifetime, minta persetujuan browser terlebih dahulu melalui prepare_campaign_action. Lalu gunakan send_test_email, activate_lifetime_campaign, atau trigger_lifetime_campaign dengan argumen yang sama. Persetujuan berlaku sepuluh menit dan hanya sekali pakai.