Serveur MCP

1. Hébergé (mcp.bird.com) : une URL et une connexion via le navigateur. Rien à installer, pas de CLI, pas de clé API. C'est le chemin recommandé.
2. Local en stdio (bird mcp) : des outils exécutés sur votre machine dans le bird CLI, pour les agents shell ou pour l'exécuter vous-même.

• auth_signup, auth_verify_email et auth_create_org : ces outils créent votre premier identifiant, avant que vous puissiez vous authentifier auprès du serveur hébergé.
• compliance_attachments_upload : cet outil lit un chemin de fichier local. Sur le serveur hébergé, ce chemin ferait référence au système de fichiers du serveur et pourrait envoyer le mauvais fichier.

Hébergé : se connecter à mcp.bird.com

Choisir un endpoint

1. Ajouter le serveur : donnez au client l'URL de l'endpoint choisi.
2. S'authentifier : connectez-vous via votre navigateur pour que le client détienne un jeton qui agit en votre nom.

Utiliser la découverte dynamique d'outils

• search trouve des outils par nom ou mots-clés de description. Chaque résultat inclut son nom, sa description, son schéma d'entrée et des annotations indiquant s'il lit ou modifie des données.
• execute appelle un outil sélectionné avec ses arguments. Il peut lire des données, envoyer des messages, modifier des enregistrements ou les supprimer, selon l'outil sélectionné.

{
  "name": "search",
  "arguments": { "query": "workspace_get", "limit": 3 }
}

{
  "name": "execute",
  "arguments": { "tool": "workspace_get", "arguments": {} }
}

Connecter un client

Claude Code

claude mcp add --transport http bird https://mcp.bird.com

1. Exécutez /mcp.
2. Sélectionnez bird et appuyez sur Entrée.
3. Choisissez Authenticate. Votre navigateur ouvre l'écran de consentement de Bird ; approuvez-le à cet endroit.

Cursor

{
  "mcpServers": {
    "bird": {
      "url": "https://mcp.bird.com"
    }
  }
}

OpenCode

opencode plugin github:messagebird/bird-ai --global

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bird": {
      "type": "remote",
      "url": "https://mcp.bird.com/dynamic"
    }
  },
  "permission": {
    "bird_execute": "ask"
  }
}

opencode mcp auth bird

VS Code

{
  "servers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com"
    }
  }
}

Codex

[mcp_servers.bird]
url = "https://mcp.bird.com"

codex mcp login bird

Claude Desktop

ChatGPT

Muse

Set up a custom connector to the Bird MCP server at https://mcp.bird.com following https://bird.com/docs/ai/mcp-server.md so you can work with my Bird workspace.

Factory Droid

droid mcp add bird https://mcp.bird.com --type http

Agent Plugins

Tout autre hôte

Ce qui se passe quand vous vous connectez

Fonctionnement de la poignée de main

1. Le client envoie une requête non authentifiée et reçoit 401 avec un en-tête WWW-Authenticate pointant vers les métadonnées de ressource protégée RFC 9728 de Bird (/.well-known/oauth-protected-resource).
2. À partir de là, il découvre le serveur d'autorisation, puis s'enregistre dynamiquement (RFC 7591). L'enregistrement dynamique supprime le besoin d'un identifiant client pré-partagé ou d'une configuration manuelle.
3. Votre navigateur ouvre l'écran de consentement de Bird.
4. Le client échange le résultat contre un jeton d'accès (PKCE ; renouvelé automatiquement) et les outils Bird apparaissent.

Local : exécution via stdio avec le CLI

Cursor

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

VS Code

{
  "servers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

Claude Code

claude mcp add bird -- bird mcp

Authentification du serveur local

Ce que couvrent les outils

Messagerie

• Envoyer et inspecter des e-mails : email_send, email_send_batch, email_list et email_get, qui renvoie le message avec son statut de livraison agrégé. Les statuts de livraison par destinataire et le journal d'événements sont des appels d'outils séparés.
• Envoyer et inspecter des SMS : sms_send, sms_send_batch, sms_get, sms_list et sms_list_events, calqués sur la structure e-mail. sms_templates_list et sms_templates_get lisent le catalogue de templates.
• Envoyer et inspecter des WhatsApp : whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events et whatsapp_media. Les templates sont une surface de rédaction complète sous whatsapp_templates_*, incluant le contenu par version et par langue.
• Consulter les segments d'appels vocaux : voice_legs_get et voice_legs_list consultent les segments d'appels, avec des statistiques par pays et par code de réponse sous voice_stats_*. voice_session_credentials_create crée les informations d'identification de l'espace de travail qu'un client SIP ou softphone utilise pour s'authentifier.
• Vérifier un destinataire : verify_verifications_create envoie un code de vérification à usage unique, verify_verifications_check valide ce que le destinataire a soumis, et verify_verifications_next_channel bascule sur un autre canal.
• Créer un appel vocal (aperçu) : voice_calls_create prépare un appel sortant à l'aide de la publication active d'une séquence activée et non archivée. Une personne examine et exécute la requête dans le navigateur ; sa préparation ne lance pas l'appel. Consultez Créer un appel vocal pour les autorisations et les instructions de nouvelle tentative. Le serveur local bird mcp nécessite une version du CLI qui inclut cet outil.

Préparer un canal pour l'envoi

• Configurer les domaines d'envoi : email_domains_create ajoute un domaine d'envoi et renvoie les enregistrements DNS à publier ; email_domains_verify les revérifie ; plus email_domains_list et email_domains_get.
• Revendiquer et enregistrer des expéditeurs SMS : sms_senders_create revendique un expéditeur, sms_senders_requirements indique ce qu'un pays exige de lui, et sms_senders_registrations_create l'enregistre. Le trafic A2P aux États-Unis passe par les outils de marque, campagne et soumission sms_10dlc_*.
• Provisionner des numéros : numbers_available_list recherche, numbers_orders_create achète et numbers_release restitue. whatsapp_numbers_precheck indique si WhatsApp acceptera un numéro avant que vous ne le commandiez.
• Vérifier que le compte peut envoyer : les outils trust_* signalent les exigences de l'organisation qui conditionnent l'achat d'un numéro ou l'enregistrement d'un expéditeur.

Délivrabilité e-mail

• Créer des templates e-mail : email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate et email_templates_preview (rendu d'un brouillon avec des valeurs d'exemple sans envoi). Les versions se trouvent sous email_templates_versions_*, où email_templates_versions_submit fige un brouillon et en fait la version servie par les envois, et email_templates_versions_languages_* modifie le contenu par langue d'un brouillon. Rien de ce qu'un agent écrit n'atteint un destinataire tant qu'il ne soumet pas.
• Gérer les suppressions : email_suppressions_list, email_suppressions_check (cette adresse est-elle sûre pour l'envoi ?), email_suppressions_add et email_suppressions_remove (annoté destructif, car supprimer une suppression sans raison nuit à la réputation de l'expéditeur).
• Gérer les IP dédiées et les pools : email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (déplacer une IP dans un pool) et email_dedicated_ips_delete ; plus email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update et email_ip_pools_delete pour les pools via lesquels vous routez vos envois.

Audience et configuration

• Gérer les contacts et les audiences : contacts_* et contact_properties_* pour les personnes à qui vous envoyez, audiences_* pour les listes auxquelles vous envoyez, et preferences_* pour les consentements et les désinscriptions.
• Provisionner Realtime : realtime_apps_* et realtime_apps_keys_* créent les applications et les clés avec lesquelles les clients Realtime se connectent.
• Rechercher quelqu'un : lookup_phone_number et lookup_email indiquent ce que Bird sait d'une adresse avant que vous ne lui envoyiez un message.
• Inspecter la configuration : webhooks_list, workspace_get et whoami (l'utilisateur connecté : id, e-mail, nom).

Call whoami to find my email, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.

MCP ou le CLI ?

Étapes suivantes

• AI onboarding : la version quickstart de cette page, plus le corpus de documentation lisible par les machines.
• Agent skills : le plugin marketplace bird-ai, skills plus ce serveur MCP, installé en une étape.
• CLI pour agents : pilotez Bird depuis des agents capables d'utiliser un shell sans MCP : sortie JSON, codes de sortie sémantiques, connexion OAuth.
• Authentication : clés API, régions et mode d'autorisation des requêtes.