MCP — Programmierschnittstelle

Neben REST bietet GetMyBot die Schnittstelle MCP (Model Context Protocol) — sie ist für KI-Agenten und Assistenten ausgelegt, die Werkzeuge aufrufen, anstatt Endpunkte manuell anzusprechen. REST bleibt die primäre Schnittstelle; MCP ist eine komfortable Alternative für agentische Szenarien. Die Namen der Werkzeuge, Ressourcen und Prompts unten stimmen mit dem überein, was der Server veröffentlicht.

Adresse und Autorisierung

MCP ist über den Endpunkt /mcp erreichbar (Transport Streamable HTTP, Methode POST). Autorisierung — dasselbe persönliche Token wie für REST: Header Authorization: Bearer mbp_…. Separate Tokens sind nicht erforderlich — ein PAT funktioniert sowohl für REST als auch für MCP. Jedes Werkzeug erfordert denselben Scope wie der entsprechende REST-Endpunkt; ein Token mit Scope * hat vollen Zugriff. Fehlt der Scope, wird der Aufruf abgelehnt (fail-closed), wie auch in REST.

Verbindung mit Claude Code / Cursor

Fügen Sie GetMyBot als Remote-MCP-Server hinzu. Konfigurationsbeispiel (mcpServers) — ersetzen Sie Ihre Domain und Ihr Token:

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

Claude Code: Legen Sie diesen Block in die .mcp.json des Projekts oder fügen Sie den Server mit dem Befehl claude mcp add hinzu. Cursor: Fügen Sie denselben Block in die MCP-Einstellungen ein (Settings → MCP → Add server). Nach der Verbindung erhält der Client automatisch die Liste der Werkzeuge, Ressourcen und Prompts.

Werkzeuge nach Domänen

Der Server veröffentlicht 100 Werkzeuge — vollständige Abdeckung des PAT-zugänglichen REST. Unten — Werkzeug und erforderlicher Scope. Namen im Format verb_noun (snake_case).

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

Kanäle & WhatsApp-Vorlagen (bots)

Die Mehrkanalfähigkeit (Telegram + WhatsApp + VK) steht auch über MCP zur Verfügung. Kanäle und Vorlagen werden über die gemeinsamen Scopes bots:read / bots:write abgesichert — einen separaten Kanal-Scope gibt es nicht.

  • list_channels — bots:read — die Kanäle eines Bots auflisten (Plattform tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — einen WhatsApp- oder VK-Kanal anbinden (platform + Zugangsdaten).
  • delete_channel — bots:write — einen Kanal trennen.
  • list_wa_templates — bots:read — der WhatsApp-Vorlagenkatalog des Kanals (name, language, status, category, body).
  • sync_wa_templates — bots:write — den Vorlagenkatalog erneut aus Meta synchronisieren.
  • create_wa_template — bots:write — eine WhatsApp-Vorlage erstellen und zur Prüfung an Meta senden.
  • update_wa_template — bots:write — eine Vorlage bearbeiten (im Status APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — eine Vorlage löschen.

Telegram-Kanäle werden über connect_bot angebunden, nicht über connect_channel — Letzteres behandelt nur wa und vk. Vorlagenkategorien: MARKETING / UTILITY / AUTHENTICATION. create_wa_template sendet den Entwurf sofort zur Prüfung an Meta; der Status ändert sich asynchron — lesen Sie ihn per list_wa_templates zurück (den Katalog bei Bedarf mit sync_wa_templates aktualisieren).

Das Hochladen einer Medien-Kopfzeile für eine Vorlage (Bild/Video/Dokument) über MCP wird noch nicht unterstützt — nutzen Sie die Weboberfläche oder REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

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

Der Import über import_reactions erstellt Reaktionen, überspringt jedoch Medien: Im MCP-Kontext gibt es keine Premium-Prüfung und keinen Telegram-Empfänger für Dateien. Wenn das SamBot-Bundle Bilder/Videos/Dokumente enthält — verwenden Sie den vollfunktionalen REST-Import (POST /api/bots/{botID}/reactions/import), der auch Medien überträgt.

Broadcasts (broadcasts)

  • start_broadcast — broadcasts:write (opt. paid, opt. Segment nach Labels)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Labels (labels)

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

Sammlungen und Datensätze (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

Szenarien (flows)

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

Integrationen, Verbindungen, Zugänge (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

Medien (media)

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

Vorlagen (templates)

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

Abonnenten, Chats, Dialoge — Lesen (subscribers)

  • list_subscribers — subscribers:read (Paginierung offset/limit, Filter nach Labels)
  • 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 und Analytik (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

Abrechnung — Lesen (billing)

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

Nachrichten senden

  • send_message — broadcasts:write — sendet eine Nachricht im Namen des Bots; die Kontobelastung wird automatisch nach dem Token-Inhaber berechnet.

Ressourcen

Neben den Werkzeugen liefert der Server Ressourcen — sie können gelesen werden, um die Struktur nicht erraten zu müssen:

  • mybot://openapi.yaml — vollständige OpenAPI-Spezifikation (dieselbe, die unter /openapi.yaml geliefert wird).
  • mybot://reference — kompakte Referenz: Liste der Werkzeuge mit ihren Scopes und Konventionen (Basisadresse, Paginierung, Fehlerformat, Limits).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — JSON-Schemas der Konfigurationen. Am wertvollsten für die korrekte Generierung von Reaktionen (Trigger, Bedingungen, Chats, Aktionen), Szenarien und Sammlungen.
  • mybot://bots — dynamische Liste Ihrer Bots (schneller Kontext ohne Werkzeugaufruf).

Prompts

Fertige Szenarien (Slash-Befehle beim MCP-Client):

  • setup_autoresponder — einen Autoresponder-Bot zusammenstellen (Argumente: Bot, Thema/Fragenkatalog).
  • segment_broadcast — Broadcast nach Label-Segment (Argumente: Bot, Labels, Reaktion/Text).
  • diagnose_reaction — herausfinden, warum eine Reaktion nicht auslöst (liest Reaktion, Reaction-Health und Reihenfolge).
  • import_from_sambot — ein SamBot-Bundle importieren und das Ergebnis prüfen.
  • weekly_report — Zusammenfassung der Bot-Statistik/Analytik für einen Zeitraum.

Wann MCP, wann REST wählen

  • Sie schreiben eine Integration, Synchronisierung, ein Skript oder ein eigenes Dashboard — nehmen Sie REST.
  • Sie verbinden GetMyBot mit einem KI-Assistenten oder Agenten, der MCP unterstützt — nehmen Sie /mcp.

Beide Schnittstellen funktionieren unter demselben Token und unterliegen denselben Berechtigungen des Inhabers. Wenn kein Werkzeug für die Aufgabe gefunden wurde — der entsprechende REST-Endpunkt ist immer in der interaktiven Referenz verfügbar.

Weiter