MCP — antarmuka terprogram

Selain REST, GetMyBot memiliki antarmuka MCP (Model Context Protocol) — dirancang untuk agen AI dan asisten yang memanggil alat, bukan memicu endpoint secara manual. REST tetap menjadi antarmuka utama; MCP adalah alternatif yang nyaman untuk skenario agen. Nama alat, sumber daya, dan prompt di bawah ini sesuai dengan yang dipublikasikan server.

Alamat dan otorisasi

MCP tersedia di endpoint /mcp (transport Streamable HTTP, metode POST). Otorisasi — token personal yang sama seperti untuk REST: header Authorization: Bearer mbp_…. Tidak perlu membuat token terpisah — satu PAT bekerja untuk REST dan MCP. Setiap alat memerlukan scope yang sama seperti endpoint REST yang sesuai; token dengan scope * memiliki akses penuh. Jika scope tidak mencukupi — panggilan ditolak (fail-closed), seperti di REST.

Menghubungkan ke Claude Code / Cursor

Tambahkan GetMyBot sebagai server MCP jarak jauh. Contoh konfigurasi (mcpServers) — ganti dengan domain dan token Anda:

{
  "mcpServers": {
    "mybot": {
      "url": "https://domain-anda/mcp",
      "headers": {
        "Authorization": "Bearer mbp_TOKEN_ANDA"
      }
    }
  }
}

Claude Code: letakkan blok ini di .mcp.json proyek atau tambahkan server dengan perintah claude mcp add. Cursor: tambahkan blok yang sama ke pengaturan MCP (Settings → MCP → Add server). Setelah terhubung, klien akan menerima daftar alat, sumber daya, dan prompt secara otomatis.

Alat berdasarkan domain

Server mempublikasikan 100 alat — cakupan penuh REST yang dapat diakses PAT. Di bawah ini — alat dan scope yang diperlukan. Nama dalam format kata_kerja_kata_benda (snake_case).

Bot (bots)

  • list_bots — bots:read
  • get_bot — bots:read
  • validate_bot_token — bots:write
  • connect_bot — bots:write
  • update_bot — bots:write
  • delete_bot — bots:write
  • sync_bot — bots:write
  • change_bot_token — bots:write
  • transfer_bot — bots:write
  • get_bot_settings — settings:read
  • update_bot_settings — settings:write

Saluran dan template WhatsApp (bots)

Dukungan multisaluran (Telegram + WhatsApp + VK) juga tersedia melalui MCP. Saluran dan template dikontrol oleh scope bersama bots:read / bots:write — tidak ada scope saluran terpisah.

  • list_channels — bots:read — daftar saluran sebuah bot (platform tg/wa/vk, external_id, nama, enabled, callback_url).
  • connect_channel — bots:write — menghubungkan saluran WhatsApp atau VK (platform + kredensial).
  • delete_channel — bots:write — memutuskan saluran.
  • list_wa_templates — bots:read — katalog template WhatsApp saluran (nama, bahasa, status, kategori, body).
  • sync_wa_templates — bots:write — menyinkronkan ulang katalog template dengan Meta.
  • create_wa_template — bots:write — membuat template WhatsApp dan mengirimkannya ke Meta untuk ditinjau.
  • update_wa_template — bots:write — menyunting template (pada status APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — menghapus template.

Saluran Telegram dihubungkan via connect_bot, bukan connect_channel — yang terakhir hanya menangani wa dan vk. Kategori template: MARKETING / UTILITY / AUTHENTICATION. create_wa_template langsung mengirim draf ke Meta untuk ditinjau; status berubah secara asinkron — baca kembali via list_wa_templates (segarkan katalog dengan sync_wa_templates bila perlu).

Mengunggah media header template (gambar/video/dokumen) via MCP belum didukung — gunakan antarmuka web atau REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

Reaksi (reactions)

  • list_reactions — reactions:read
  • get_reaction — reactions:read
  • create_reaction — reactions:write
  • update_reaction — reactions:write
  • delete_reaction — reactions:write
  • import_reactions — reactions:write
  • test_formula — reactions:write
  • reorder_reaction — reactions:write
  • get_reaction_links — reactions:read
  • list_reaction_folders — reactions:read
  • create_reaction_folder — reactions:write
  • update_reaction_folder — reactions:write
  • delete_reaction_folder — reactions:write
  • add_reaction_to_folder — reactions:write
  • remove_reaction_from_folder — reactions:write
  • add_reactions_to_folder — reactions:write

Impor melalui import_reactions membuat reaksi, tetapi melewatkan media: dalam konteks MCP tidak ada pemeriksaan premium dan penerima Telegram untuk file. Jika bundle SamBot berisi gambar/video/dokumen — gunakan impor REST berfitur lengkap (POST /api/bots/{botID}/reactions/import), yang juga memindahkan media.

Siaran (broadcasts)

  • start_broadcast — broadcasts:write (opsional paid, opsional segmen berdasarkan label)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Label (labels)

  • list_labels — labels:read
  • create_label — labels:write
  • delete_label — labels:write
  • set_label_favorite — labels:write

Koleksi dan record (collections)

  • list_collections — collections:read
  • create_collection — collections:write
  • update_collection — collections:write
  • delete_collection — collections:write
  • list_records — collections:read
  • create_record — collections:write
  • update_record — collections:write
  • delete_record — collections:write

Skenario (flows)

  • list_flows — flows:read
  • get_flow — flows:read
  • create_flow — flows:write
  • update_flow — flows:write
  • delete_flow — flows:write

Integrasi, koneksi, akses (integrations)

  • list_integrations — integrations:read
  • get_integration_sheets — integrations:read
  • get_integration_status — integrations:read
  • create_integration — integrations:write
  • update_integration — integrations:write
  • delete_integration — integrations:write
  • rotate_integration_token — integrations:write
  • list_connections — integrations:read
  • create_connection — integrations:write
  • test_connection — integrations:write
  • update_connection — integrations:write
  • delete_connection — integrations:write
  • list_credentials — integrations:read
  • create_credential — integrations:write
  • update_credential — integrations:write
  • delete_credential — integrations:write

Media (media)

  • upload_media — media:write
  • get_media — media:write

Template (templates)

  • list_templates — templates:read
  • delete_template — templates:write
  • create_template_from_bot — templates:write
  • apply_template — templates:write

Pelanggan, obrolan, dialog — baca (subscribers)

  • list_subscribers — subscribers:read (paginasi offset/limit, filter berdasarkan label)
  • list_chats — subscribers:read
  • list_dialogs — subscribers:read
  • read_dialog — subscribers:read
  • send_dialog_message — subscribers:write
  • send_dialog_reaction — subscribers:write
  • transcribe_dialog_message — subscribers:write

Statistik dan analitik (stats)

  • get_stats — stats:read
  • get_stats_summary — stats:read
  • get_stats_recent — stats:read
  • get_stats_log — stats:read
  • get_reaction_health — stats:read
  • get_analytics — stats:read
  • get_analytics_chats — stats:read
  • get_funnel — stats:read

Penagihan — baca (billing)

  • get_balance — billing:read
  • list_tariffs — billing:read
  • get_transactions — billing:read

Pengiriman pesan

  • send_message — broadcasts:write — mengirim pesan atas nama bot; pengeluaran saldo dihitung otomatis berdasarkan pemilik token.

Sumber daya

Selain alat, server menyajikan sumber daya — dapat dibaca agar tidak perlu menebak strukturnya:

  • mybot://openapi.yaml — spesifikasi OpenAPI lengkap (sama seperti yang disajikan di /openapi.yaml).
  • mybot://reference — referensi kompak: daftar alat dengan scope dan konvensinya (alamat dasar, paginasi, format error, limit).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — skema JSON untuk konfigurasi. Paling berharga untuk pembuatan reaksi yang benar (pemicu, kondisi, obrolan, aksi), skenario, dan koleksi.
  • mybot://bots — daftar dinamis bot Anda (konteks cepat tanpa memanggil alat).

Prompt

Skenario siap pakai (perintah slash di klien MCP):

  • setup_autoresponder — membangun bot autoresponder (argumen: bot, topik/set pertanyaan).
  • segment_broadcast — siaran berdasarkan segmen label (argumen: bot, label, reaksi/teks).
  • diagnose_reaction — memahami mengapa reaksi tidak terpicu (membaca reaksi, reaction-health, dan urutan).
  • import_from_sambot — melakukan impor bundle SamBot dan memverifikasi hasilnya.
  • weekly_report — ringkasan statistik/analitik bot untuk suatu periode.

Kapan memilih MCP, kapan REST

  • Menulis integrasi, sinkronisasi, skrip, atau panel Anda sendiri — gunakan REST.
  • Menghubungkan GetMyBot ke asisten AI atau agen yang mendukung MCP — gunakan /mcp.

Kedua antarmuka bekerja dengan satu token dan tunduk pada hak pemilik yang sama. Jika alat untuk tugas tidak ditemukan — endpoint REST yang sesuai selalu ada di referensi interaktif.

Selanjutnya