MCP — Programatik Arayüz

REST'in yanı sıra GetMyBot'un bir de MCP (Model Context Protocol) arayüzü vardır — bu arayüz, uç noktaları elle çağırmak yerine araçları kullanan IA ajanları ve asistanlar için tasarlanmıştır. REST birincil arayüz olmaya devam eder; MCP ise ajanlı senaryolar için kullanışlı bir alternatiftir. Aşağıdaki araç, kaynak ve promt isimleri, sunucunun yayımladığı isimlerle birebir eşleşir.

Adres ve Yetkilendirme

MCP, /mcp uç noktasından (Streamable HTTP taşıması, POST yöntemi) kullanılabilir. Yetkilendirme — REST için kullandığınız aynı kişisel token: Authorization: Bearer mbp_… başlığı. Ayrı token oluşturmanıza gerek yok — tek bir PAT hem REST hem MCP için çalışır. Her araç, ilgili REST uç noktasıyla aynı scope'u gerektirir; * scope'lu bir token tam erişime sahiptir. Scope yetersizse çağrı reddedilir (fail-closed), tıpkı REST'te olduğu gibi.

Claude Code / Cursor'a Bağlanma

GetMyBot'u uzak bir MCP sunucusu olarak ekleyin. Örnek yapılandırma (mcpServers) — kendi alan adınızı ve tokenınızı girin:

{
  "mcpServers": {
    "mybot": {
      "url": "https://sizin-alan-adiniz/mcp",
      "headers": {
        "Authorization": "Bearer mbp_TOKENINIZ"
      }
    }
  }
}

Claude Code: Bu bloğu projenizin .mcp.json dosyasına yerleştirin veya claude mcp add komutuyla sunucu ekleyin. Cursor: Aynı bloğu MCP ayarlarına ekleyin (Settings → MCP → Add server). Bağlantı kurulduktan sonra istemci araç, kaynak ve promt listesini otomatik olarak alır.

Alana Göre Araçlar

Sunucu 100 araç yayımlar — PAT erişimli REST'in eksiksiz karşılığı. Aşağıda her araç ve gerektirdiği scope belirtilmiştir. İsimler eylem_nesne biçimindedir (snake_case).

Botlar (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

Kanallar ve WhatsApp şablonları (bots)

Çok kanallı destek (Telegram + WhatsApp + VK) MCP üzerinden de kullanılabilir. Kanallar ve şablonlar ortak scope'lar bots:read / bots:write ile korunur — ayrı bir kanal scope'u yoktur.

  • list_channels — bots:read — botun kanallarını listeler (platform tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — WhatsApp veya VK kanalı bağlar (platform + creds).
  • delete_channel — bots:write — bir kanalı çözer.
  • list_wa_templates — bots:read — kanalın WhatsApp şablon kataloğu (name, language, status, category, body).
  • sync_wa_templates — bots:write — şablon kataloğunu Meta'dan yeniden senkronize eder.
  • create_wa_template — bots:write — bir WhatsApp şablonu oluşturur ve Meta moderasyonuna gönderir.
  • update_wa_template — bots:write — bir şablonu düzenler (APPROVED/REJECTED/PAUSED durumlarında).
  • delete_wa_template — bots:write — bir şablonu siler.

Telegram kanalları connect_channel ile değil connect_bot ile bağlanır — ikincisi yalnızca wa ve vk içindir. Şablon kategorileri: MARKETING / UTILITY / AUTHENTICATION. create_wa_template taslağı hemen Meta moderasyonuna gönderir; durum asenkron olarak değişir — bunu list_wa_templates ile geri okuyun (gerekirse kataloğu sync_wa_templates ile yenileyerek).

Bir şablonun medya başlığını (görsel/video/belge) MCP üzerinden yükleme henüz desteklenmiyor — web arayüzünü veya REST POST /api/bots/{botID}/channels/{channelID}/templates/media'yı kullanın.

Tepkiler (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

import_reactions aracıyla içe aktarma tepkileri oluşturur ancak medyayı atlar: MCP bağlamında premium kontrolü ve dosyalar için Telegram alıcısı yoktur. SamBot paketinde resim/video/belge varsa — tam özellikli REST içe aktarmayı kullanın (POST /api/bots/{botID}/reactions/import), bu yöntem medyayı da taşır.

Toplu Gönderimleri (broadcasts)

  • start_broadcast — broadcasts:write (isteğe bağlı paid, isteğe bağlı etiket segmenti)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Etiketler (labels)

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

Koleksiyonlar ve Kayıtlar (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

Senaryolar (flows)

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

Entegrasyonlar, Bağlantılar, Erişimler (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

Medya (media)

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

Şablonlar (templates)

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

Aboneler, Sohbetler, Diyaloglar — Okuma (subscribers)

  • list_subscribers — subscribers:read (sayfalama offset/limit, etiket filtreleri)
  • 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 ve 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

Faturalama — Okuma (billing)

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

Mesaj Gönderme

  • send_message — broadcasts:write — bot adına mesaj gönderir; bakiye harcaması token sahibine göre otomatik hesaplanır.

Kaynaklar

Araçların yanı sıra sunucu kaynaklar da sunar — yapıyı tahmin etmeden okumak için bunlardan yararlanabilirsiniz:

  • mybot://openapi.yaml — tam OpenAPI spesifikasyonu (/openapi.yaml adresinde döndürülenin aynısı).
  • mybot://reference — özet referans: scope'larıyla araç listesi ve kurallar (temel adres, sayfalama, hata formatı, limitler).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — yapılandırmaların JSON şemaları. Tepkileri (tetikleyici, koşullar, sohbetler, eylemler), senaryoları ve koleksiyonları doğru şekilde oluşturmak için en değerli kaynaklardır.
  • mybot://bots — botlarınızın dinamik listesi (araç çağırmadan hızlı bağlam).

Promtlar

Hazır senaryolar (MCP istemcisinde slash komutları):

  • setup_autoresponder — otomatik yanıtlayıcı bot oluşturur (argümanlar: bot, konu/soru seti).
  • segment_broadcast — etiket segmentine toplu gönderim (argümanlar: bot, etiketler, tepki/metin).
  • diagnose_reaction — bir tepkinin neden tetiklenmediğini araştırır (tepkiyi, reaction-health'i ve sıralamayı okur).
  • import_from_sambot — SamBot paketini içe aktarır ve sonucu doğrular.
  • weekly_report — belirli bir dönem için bot istatistik/analitik özeti.

MCP mi, REST mi Seçmeli

  • Entegrasyon, senkronizasyon, betik veya özel panel yazıyorsanız — REST kullanın.
  • GetMyBot'u MCP destekleyen bir IA asistanına veya ajana bağlıyorsanız — /mcp kullanın.

Her iki arayüz de aynı token altında çalışır ve aynı sahip izinlerine tabidir. İşinize uygun bir araç bulamazsanız — ilgili REST uç noktası her zaman interaktif referansta mevcuttur.

Sonraki Adımlar