MCP — interfejs programowy

Oprócz REST, GetMyBot udostępnia interfejs MCP (Model Context Protocol) — przeznaczony dla agentów AI i asystentów, które wywołują narzędzia zamiast ręcznie odpytywać endpointy. REST pozostaje interfejsem podstawowym; MCP to wygodna alternatywa dla scenariuszy agentowych. Nazwy narzędzi, zasobów i promptów poniżej odpowiadają dokładnie temu, co publikuje serwer.

Adres i autoryzacja

MCP jest dostępny pod endpointem /mcp (transport Streamable HTTP, metoda POST). Autoryzacja — ten sam token osobisty co dla REST: nagłówek Authorization: Bearer mbp_…. Nie trzeba tworzyć osobnych tokenów — jeden PAT działa zarówno dla REST, jak i dla MCP. Każde narzędzie wymaga tego samego scope co odpowiadający mu endpoint REST; token ze scope * ma pełny dostęp. Jeśli scope jest niewystarczający — wywołanie jest odrzucane (fail-closed), tak samo jak w REST.

Podłączenie do Claude Code / Cursor

Dodaj GetMyBot jako zdalny serwer MCP. Przykładowa konfiguracja (mcpServers) — wstaw własną domenę i token:

{
  "mcpServers": {
    "mybot": {
      "url": "https://twoja-domena/mcp",
      "headers": {
        "Authorization": "Bearer mbp_TWÓJ_TOKEN"
      }
    }
  }
}

Claude Code: umieść ten blok w pliku .mcp.json projektu lub dodaj serwer poleceniem claude mcp add. Cursor: dodaj ten sam blok w ustawieniach MCP (Settings → MCP → Add server). Po podłączeniu klient automatycznie pobierze listę narzędzi, zasobów i promptów.

Narzędzia według domen

Serwer publikuje 100 narzędzia — pełne pokrycie REST dostępnego przez PAT. Poniżej — narzędzie i wymagany scope. Nazwy w formacie czasownik_rzeczownik (snake_case).

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

Kanały i szablony WhatsApp (bots)

Obsługa wielokanałowa (Telegram + WhatsApp + VK) jest dostępna również przez MCP. Kanały i szablony są chronione wspólnymi zakresami bots:read / bots:write — nie ma osobnego zakresu dla kanałów.

  • list_channels — bots:read — lista kanałów bota (platform tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — podłącz kanał WhatsApp lub VK (platform + creds).
  • delete_channel — bots:write — odłącz kanał.
  • list_wa_templates — bots:read — katalog szablonów WhatsApp kanału (name, language, status, category, body).
  • sync_wa_templates — bots:write — zresynchronizuj katalog szablonów z Meta.
  • create_wa_template — bots:write — utwórz szablon WhatsApp i wyślij do moderacji Meta.
  • update_wa_template — bots:write — edytuj szablon (w statusach APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — usuń szablon.

Kanały Telegram podłącza się przez connect_bot, a nie connect_channel — ten drugi obsługuje tylko wa i vk. Kategorie szablonów: MARKETING / UTILITY / AUTHENTICATION. create_wa_template od razu wysyła wersję roboczą do moderacji Meta; status zmienia się asynchronicznie — odczytuj go przez list_wa_templates (w razie potrzeby odświeżając katalog sync_wa_templates).

Przesyłanie nagłówka multimedialnego szablonu (obraz/wideo/dokument) przez MCP na razie nie jest obsługiwane — użyj interfejsu web lub REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

Reakcje (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 przez import_reactions tworzy reakcje, ale pomija media: w kontekście MCP nie ma weryfikacji premium ani odbiornika Telegram dla plików. Jeśli bundle SamBot zawiera obrazy/wideo/dokumenty — użyj pełnofunkcjonalnego importu REST (POST /api/bots/{botID}/reactions/import), który przenosi również media.

Wysyłki masowe (broadcasts)

  • start_broadcast — broadcasts:write (opcjonalnie paid, opcjonalnie segment według etykiet)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Etykiety (labels)

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

Kolekcje i rekordy (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

Scenariusze (flows)

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

Integracje, połączenia, dostępy (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

Szablony (templates)

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

Subskrybenci, czaty, dialogi — odczyt (subscribers)

  • list_subscribers — subscribers:read (paginacja offset/limit, filtry według etykiet)
  • 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

Statystyki i analityka (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

Płatności — odczyt (billing)

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

Wysyłanie wiadomości

  • send_message — broadcasts:write — wysłanie wiadomości w imieniu bota; koszt jest automatycznie rozliczany według właściciela tokenu.

Zasoby

Oprócz narzędzi serwer udostępnia zasoby — można je odczytać, aby nie zgadywać struktury:

  • mybot://openapi.yaml — pełna specyfikacja OpenAPI (ta sama, co zwracana pod /openapi.yaml).
  • mybot://reference — kompaktowy przewodnik: lista narzędzi z ich scope oraz konwencje (adres bazowy, paginacja, format błędów, limity).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — schematy JSON konfiguracji. Najbardziej przydatne do poprawnego generowania reakcji (wyzwalacz, warunki, czaty, akcje), scenariuszy i kolekcji.
  • mybot://bots — dynamiczna lista Twoich botów (szybki kontekst bez wywoływania narzędzia).

Prompty

Gotowe scenariusze (polecenia slash u klienta MCP):

  • setup_autoresponder — zbudowanie bota-autorespondera (argumenty: bot, temat/zestaw pytań).
  • segment_broadcast — wysyłka do segmentu etykiet (argumenty: bot, etykiety, reakcja/tekst).
  • diagnose_reaction — ustalenie, dlaczego reakcja nie wyzwala się (odczytuje reakcję, reaction-health i kolejność).
  • import_from_sambot — przeprowadzenie importu bundle SamBot i weryfikacja wyniku.
  • weekly_report — podsumowanie statystyk/analityki bota za okres.

Kiedy wybrać MCP, a kiedy REST

  • Piszesz integrację, synchronizację, skrypt lub własny panel — użyj REST.
  • Podłączasz GetMyBot do asystenta AI lub agenta obsługującego MCP — użyj /mcp.

Oba interfejsy działają na tym samym tokenie i podlegają tym samym uprawnieniom właściciela. Jeśli nie znalazłeś narzędzia dla zadania — odpowiedni endpoint REST zawsze znajdziesz w interaktywnym przewodniku.

Co dalej