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"
    }
  }
}

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 du handshake

1. Le client effectue 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 élimine le besoin d'un client ID 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 ; rafraîchi automatiquement) et les outils Bird apparaissent.

Local : l'exécuter en 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, suivant la même structure que l'e-mail. sms_templates_list et sms_templates_get lisent le catalogue de modèles.
• Envoyer et inspecter des WhatsApp : whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events et whatsapp_media. Les modèles sont une surface de création complète sous whatsapp_templates_*, incluant le contenu par version et par langue.
• Inspecter les appels vocaux : voice_get et voice_list relisent les appels, avec des statistiques par pays et par code de réponse sous voice_stats_*. voice_session_credentials_create génère l'identifiant d'espace de travail avec lequel un SIP ou un client softphone s'authentifie. Aucun outil MCP ne passe d'appel : cela se fait via bird voice tools test-call sur le CLI.
• 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.

Préparer un canal à 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, de campagne et de 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 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é des e-mails

• Créer des modèles d'e-mails : email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate et email_templates_preview (rendre un brouillon avec des valeurs d'exemple sans envoyer). 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 le 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 retirer 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 grants de consentement et les désinscriptions.
• Provisionner Realtime : realtime_apps_* et realtime_apps_keys_* créent les apps 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 lui envoyiez un message.
• Inspecter la configuration : webhooks_list, workspace_get et whoami (l'utilisateur connecté : id, email, 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 ?

Prochaines étapes

• AI onboarding : la version quickstart de cette page, plus le corpus de documentation lisible par machine.
• Agent skills : le plugin bird-ai du marketplace, les skills plus ce serveur MCP, installés en une seule étape.
• CLI pour les 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 comment les requêtes sont autorisées.