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 la méthode recommandée.
2. Local via stdio (bird mcp) : des outils exécutés sur votre machine dans le CLI bird, pour les agents shell ou l'exécution en autonomie.

• auth_signup, auth_verify_email et auth_create_org : ces outils créent vos premiers identifiants, 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 désignerait le système de fichiers du serveur et pourrait téléverser le mauvais fichier.

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

Choisir un point de terminaison

1. Ajouter le serveur : donnez au client l'URL du point de terminaison 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 par mots-clés de leur description. Chaque résultat inclut le nom, la description, le schéma d'entrée et des annotations indiquant si l'outil 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 Bird ; approuvez-le là-bas.

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

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

Comment fonctionne la négociation

1. Le client fait une requête non authentifiée et reçoit un 401 avec un en-tête WWW-Authenticate pointant vers les métadonnées de ressource protégée Bird RFC 9728 (/.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 identifiant client pré-partagé ou d'une configuration manuelle.
3. Votre navigateur ouvre l'écran de consentement 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 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

Comment le serveur local s'authentifie

Ce que couvrent les outils

Messagerie

• Envoyer et inspecter des emails : 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, reflétant la structure email. 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 lisent 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 client SIP ou softphone s'authentifie. Aucun outil MCP ne passe d'appel : c'est bird voice tools test-call sur le CLI.
• Vérifier un destinataire : verify_verifications_create envoie un code à usage unique, verify_verifications_check valide ce que le destinataire a soumis, et verify_verifications_next_channel bascule vers un autre canal.

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 celui-ci, et sms_senders_registrations_create l'enregistre. Le trafic A2P américain passe par les outils sms_10dlc_* de marque, campagne et soumission.
• 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_* indiquent les exigences organisationnelles qui conditionnent l'achat d'un numéro ou l'enregistrement d'un expéditeur.

Délivrabilité email

• Créer des modèles d'email : 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_* édite 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 (est-il sûr d'envoyer à cette adresse ?), email_suppressions_add et email_suppressions_remove (annotée destructive, car supprimer une suppression sans raison endommage 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 à travers lesquels vous routez les envois.

Audience et configuration

• Gérer les contacts et audiences : contacts_* et contact_properties_* pour les personnes à qui vous envoyez, audiences_* pour les listes auxquelles vous envoyez, et preferences_* pour les autorisations de consentement et les désinscriptions.
• Provisionner Realtime : realtime_apps_* et realtime_apps_keys_* créent les applications et 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.
• Inspecter la configuration : webhooks_list, workspace_get et whoami (l'utilisateur connecté : id, email, nom).

Appelez whoami pour trouver mon email, puis envoyez-moi un email de test depuis onboarding@messagebird.dev et dites-moi quand il est livré.

MCP ou le CLI ?

Prochaines étapes

• Intégration IA : la version démarrage rapide de cette page, plus le corpus de documentation lisible par machine.
• Compétences agent : le plugin marketplace bird-ai, compétences plus ce serveur MCP, installés en une étape.
• CLI pour les agents : pilotez Bird depuis des agents capables d'utiliser le shell sans MCP : sortie JSON, codes de sortie sémantiques, connexion OAuth.
• Authentification : clés API, régions et comment les requêtes sont autorisées.