MCP — програмний інтерфейс

Крім REST, у GetMyBot є інтерфейс MCP (Model Context Protocol) — він розрахований на ШІ-агентів і асистентів, які викликають інструменти, а не звертаються до ендпоінтів вручну. REST залишається основним інтерфейсом; MCP — зручна альтернатива для агентних сценаріїв. Імена інструментів, ресурсів і промптів нижче збігаються з тим, що публікує сервер.

Адреса та авторизація

MCP доступний за ендпоінтом /mcp (транспорт Streamable HTTP, метод POST). Авторизація — той самий персональний токен, що й для REST: заголовок Authorization: Bearer mbp_…. Окремі токени заводити не потрібно — один PAT працює і для REST, і для MCP. Кожен інструмент вимагає того самого scope, що й відповідний REST-ендпоінт; токен зі scope * має повний доступ. Якщо scope недостатньо — виклик відхиляється (fail-closed), як і в REST.

Підключення до Claude Code / Cursor

Додайте GetMyBot як віддалений MCP-сервер. Приклад конфігурації (mcpServers) — підставте свій домен і токен:

{
  "mcpServers": {
    "mybot": {
      "url": "https://ваш-домен/mcp",
      "headers": {
        "Authorization": "Bearer mbp_ВАШ_ТОКЕН"
      }
    }
  }
}

Claude Code: покладіть цей блок у .mcp.json проєкту або додайте сервер командою claude mcp add. Cursor: додайте той самий блок у налаштування MCP (Settings → MCP → Add server). Після підключення клієнт отримає список інструментів, ресурсів і промптів автоматично.

Інструменти за доменами

Сервер публікує 100 інструменти — повне покриття PAT-доступного REST. Нижче — інструмент і необхідний scope. Імена у форматі дієслово_іменник (snake_case).

Боти (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

Канали та WhatsApp-шаблони (bots)

Мультиканальність (Telegram + WhatsApp + VK) доступна і через MCP. Канали та шаблони гейтяться спільними scope bots:read / bots:write — окремого channel-scope немає.

  • list_channels — bots:read — список каналів бота (platform tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — підключити канал WhatsApp або VK (platform + creds).
  • delete_channel — bots:write — відключити канал.
  • list_wa_templates — bots:read — каталог WhatsApp-шаблонів каналу (name, language, status, category, body).
  • sync_wa_templates — bots:write — пересинхронізувати каталог шаблонів з Meta.
  • create_wa_template — bots:write — створити WhatsApp-шаблон і надіслати на модерацію Meta.
  • update_wa_template — bots:write — змінити шаблон (у статусах APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — видалити шаблон.

Telegram-канали підключаються через connect_bot, а не connect_channel — останній розрахований лише на wa і vk. Категорії шаблонів: MARKETING / UTILITY / AUTHENTICATION. create_wa_template одразу надсилає чернетку на модерацію Meta; статус змінюється асинхронно — читайте його через list_wa_templates (за потреби оновивши каталог sync_wa_templates).

Завантаження медіа-заголовка шаблону (зображення/відео/документ) через MCP поки що не підтримується — лише через web-інтерфейс або REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

Реакції (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 створює реакції, але пропускає медіа: у MCP-контексті немає premium-перевірки і Telegram-приймача для файлів. Якщо в бандлі SamBot є зображення/відео/документи — використовуйте повнофункціональний REST-імпорт (POST /api/bots/{botID}/reactions/import), він переносить і медіа.

Розсилки (broadcasts)

  • start_broadcast — broadcasts:write (необов'язк. paid, необов'язк. сегмент за мітками)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Мітки (labels)

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

Колекції та записи (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

Сценарії (flows)

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

Інтеграції, підключення, доступи (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)

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

Шаблони (templates)

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

Підписники, чати, діалоги — читання (subscribers)

  • list_subscribers — subscribers:read (пагінація offset/limit, фільтри за мітками)
  • 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

Статистика та аналітика (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

Білінг — читання (billing)

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

Надсилання повідомлень

  • send_message — broadcasts:write — надсилання повідомлення від імені бота; витрата балансу враховується автоматично за власником токена.

Ресурси

Крім інструментів, сервер віддає ресурси — їх можна читати, щоб не вгадувати структуру:

  • mybot://openapi.yaml — повна OpenAPI-специфікація (та сама, що віддається за /openapi.yaml).
  • mybot://reference — компактний довідник: список інструментів з їхніми scope та конвенції (базова адреса, пагінація, формат помилок, ліміти).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — JSON-схеми конфігів. Найцінніше для коректної генерації реакцій (тригер, умови, чати, дії), сценаріїв і колекцій.
  • mybot://bots — динамічний список ваших ботів (швидкий контекст без виклику інструмента).

Промпти

Готові сценарії (slash-команди у MCP-клієнті):

  • setup_autoresponder — зібрати бота-автовідповідач (аргументи: бот, тема/набір питань).
  • segment_broadcast — розсилка за сегментом міток (аргументи: бот, мітки, реакція/текст).
  • diagnose_reaction — розібратися, чому реакція не спрацьовує (читає реакцію, reaction-health і порядок).
  • import_from_sambot — провести імпорт бандла SamBot і перевірити результат.
  • weekly_report — зведення за статистикою/аналітикою бота за період.

Коли обирати MCP, а коли REST

  • Пишете інтеграцію, синхронізацію, скрипт або власну панель — беріть REST.
  • Підключаєте GetMyBot до ШІ-асистента або агента, що вміє MCP — беріть /mcp.

Обидва інтерфейси працюють під одним токеном і підпорядковуються одним і тим самим правам власника. Якщо інструмента під завдання не знайшлося — відповідний REST-ендпоінт завжди є в інтерактивному довіднику.

Що далі