MCP — interface programmatique

En plus de REST, GetMyBot dispose d'une interface MCP (Model Context Protocol) — conçue pour les agents IA et assistants qui appellent des outils plutôt que des endpoints manuellement. REST reste l'interface primaire ; MCP est une alternative pratique pour les scénarios agentiques. Les noms des outils, ressources et prompts ci-dessous correspondent exactement à ce que publie le serveur.

Adresse et autorisation

MCP est accessible via l'endpoint /mcp (transport Streamable HTTP, méthode POST). L'autorisation utilise le même jeton personnel que pour REST : en-tête Authorization: Bearer mbp_…. Il n'est pas nécessaire de créer des jetons séparés — un seul PAT fonctionne pour REST et MCP. Chaque outil requiert le même scope que l'endpoint REST correspondant ; un jeton avec le scope * dispose d'un accès complet. Si le scope est insuffisant, l'appel est rejeté (fail-closed), comme en REST.

Connexion à Claude Code / Cursor

Ajoutez GetMyBot en tant que serveur MCP distant. Exemple de configuration (mcpServers) — remplacez votre domaine et votre jeton :

{
  "mcpServers": {
    "mybot": {
      "url": "https://votre-domaine/mcp",
      "headers": {
        "Authorization": "Bearer mbp_VOTRE_JETON"
      }
    }
  }
}

Claude Code : placez ce bloc dans le fichier .mcp.json de votre projet ou ajoutez le serveur avec la commande claude mcp add. Cursor : ajoutez le même bloc dans les paramètres MCP (Settings → MCP → Add server). Une fois connecté, le client récupère automatiquement la liste des outils, ressources et prompts.

Outils par domaine

Le serveur publie 100 outils — couverture complète de l'accès REST par PAT. Ci-dessous : l'outil et le scope requis. Les noms sont au format verbe_nom (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

Canaux & modèles WhatsApp (bots)

Le support multicanal (Telegram + WhatsApp + VK) est aussi disponible via MCP. Les canaux et les modèles sont protégés par les portées partagées bots:read / bots:write — il n'y a pas de portée dédiée aux canaux.

  • list_channels — bots:read — lister les canaux d'un bot (plateforme tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — connecter un canal WhatsApp ou VK (platform + identifiants).
  • delete_channel — bots:write — déconnecter un canal.
  • list_wa_templates — bots:read — le catalogue de modèles WhatsApp du canal (name, language, status, category, body).
  • sync_wa_templates — bots:write — resynchroniser le catalogue de modèles depuis Meta.
  • create_wa_template — bots:write — créer un modèle WhatsApp et l'envoyer à Meta pour vérification.
  • update_wa_template — bots:write — modifier un modèle (au statut APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — supprimer un modèle.

Les canaux Telegram se connectent via connect_bot, pas via connect_channel — ce dernier ne gère que wa et vk. Catégories de modèles : MARKETING / UTILITY / AUTHENTICATION. create_wa_template envoie aussitôt le brouillon à Meta pour vérification ; le statut change de façon asynchrone — relisez-le via list_wa_templates (en actualisant le catalogue avec sync_wa_templates si nécessaire).

Le téléversement d'un en-tête média de modèle (image/vidéo/document) via MCP n'est pas encore pris en charge — utilisez l'interface web ou REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

Réactions (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

L'import via import_reactions crée les réactions, mais ignore les médias : dans le contexte MCP, il n'y a ni vérification premium ni récepteur Telegram pour les fichiers. Si le bundle SamBot contient des images, vidéos ou documents, utilisez l'import REST complet (POST /api/bots/{botID}/reactions/import), qui transfère également les médias.

Diffusions (broadcasts)

  • start_broadcast — broadcasts:write (option paid, option segment par étiquettes)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Étiquettes (labels)

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

Collections et enregistrements (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

Scénarios (flows)

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

Intégrations, connexions et accès (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

Médias (media)

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

Modèles (templates)

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

Abonnés, chats, dialogues — lecture (subscribers)

  • list_subscribers — subscribers:read (pagination offset/limit, filtres par étiquettes)
  • 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

Statistiques et analytique (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

Facturation — lecture (billing)

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

Envoi de messages

  • send_message — broadcasts:write — envoie un message au nom du bot ; la consommation du solde est comptabilisée automatiquement selon le propriétaire du jeton.

Ressources

En plus des outils, le serveur expose des ressources — vous pouvez les lire pour ne pas avoir à deviner la structure :

  • mybot://openapi.yaml — la spécification OpenAPI complète (la même que celle disponible sur /openapi.yaml).
  • mybot://reference — référence compacte : liste des outils avec leur scope et les conventions (adresse de base, pagination, format des erreurs, limites).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — schémas JSON des configurations. Très utiles pour générer correctement des réactions (déclencheur, conditions, chats, actions), des scénarios et des collections.
  • mybot://bots — liste dynamique de vos bots (contexte rapide sans appel d'outil).

Prompts

Scénarios prêts à l'emploi (slash-commandes chez le client MCP) :

  • setup_autoresponder — créer un bot de réponse automatique (arguments : bot, sujet/ensemble de questions).
  • segment_broadcast — diffusion par segment d'étiquettes (arguments : bot, étiquettes, réaction/texte).
  • diagnose_reaction — comprendre pourquoi une réaction ne se déclenche pas (lit la réaction, reaction-health et l'ordre).
  • import_from_sambot — effectuer l'import d'un bundle SamBot et vérifier le résultat.
  • weekly_report — récapitulatif des statistiques/analytiques du bot sur une période.

Quand choisir MCP plutôt que REST

  • Vous développez une intégration, une synchronisation, un script ou votre propre tableau de bord — utilisez REST.
  • Vous connectez GetMyBot à un assistant IA ou un agent compatible MCP — utilisez /mcp.

Les deux interfaces fonctionnent avec le même jeton et respectent les mêmes droits du propriétaire. Si vous ne trouvez pas d'outil pour votre besoin, l'endpoint REST correspondant est toujours disponible dans la référence interactive.

Pour aller plus loin