Laissez votre agent faire l'envoi
Le serveur MCP, le CLI et les compétences de Bird offrent à un agent de code les mêmes opérations d'e-mail, SMS et vérification que celles disponibles via l'API. Un seul prompt connecte les trois à l'agent que vous utilisez déjà.
> send a test to my own address and tell me if it landed
$ curl -fsSL https://cli.bird.com/install.sh | sh
$ bird auth login
Opening your browser to authorize Bird CLI…
{ "workspace_id": "ws_01k…", "region": "eu1",
"credentials_path": "~/.config/bird/credentials.json" }
$ bird email send \
--from "onboarding@messagebird.dev" \
--to "you@example.com" \
--subject "Ping from your agent"
{ "id": "em_3Nf2c", "status": "accepted" }
# accepted is not delivered, so read it back
$ bird email get em_3Nf2c
{ "status": "delivered", "attempts": 1 }
landed in 1.2s. Want me to set up your own domain next?
Mes confirmations de commande ne sont plus délivrées depuis ce matin. Que s'est-il passé ?
bird · list messages
41 rebonds au cours de la dernière heure, tous provenant de acme-mail.dev.
bird · get domain
Trouvé : l'enregistrement DKIM a disparu à 04:12. Il est de nouveau publié et le domaine vient d'être re-vérifié, vos confirmations sont donc délivrées.
Connectez le client que vous utilisez déjà
Toujours la même URL. Ce qui change, c'est l'emplacement de la config, qui lance l'authentification, et à quoi ressemble la réponse une fois que ça fonctionne.
$ claude mcp add --transport http bird https://mcp.bird.com
Les bonnes pratiques pour garantir la fiabilité
Une API pensée pour les agents nécessite toujours la bonne boucle autour. Voici les modes d'échec qui cassent réellement les intégrations d'agents — ils s'appliquent que vous utilisiez le serveur MCP ou le CLI.
- 01
Une opération par appel
Chaque outil renvoie du JSON structuré dont l'étape suivante vérifie les champs. Lisez chaque condition de sortie depuis la réponse de l'étape précédente au lieu de la déduire.
- 02
Accepté ne veut pas dire délivré
Un envoi renvoie 202 avec status: accepted, ce qui signifie que Bird a pris en charge le message. La délivrance est asynchrone : relisez le message pour connaître le résultat réel.
- 03
Branchez sur le code de sortie, pas sur le message
2 signifie corriger l'entrée, 3 signifie que l'id est incorrect — ne retentez pas, 4 signifie ré-authentifiez-vous. Pas de correspondance de chaînes.
- 04
Trouvez l'expéditeur avant d'envoyer
Une adresse d'expédition nécessite un domaine d'envoi vérifié. La propagation DNS est asynchrone, donc vérifier juste après la création renvoie presque toujours pending.
- 05
Retentez en toute sécurité
--dry-run prévisualise la requête, --example affiche un corps valide, et --idempotency-key rend la nouvelle tentative sûre à répéter.
Un agent peut ouvrir son propre compte. Misez sur la rapidité et la simplicité.
Pas de navigateur, pas de mot de passe, pas de tableau de bord. Trois commandes suffisent pour passer d'un agent sans rien à un identifiant enregistré, et le serveur MCP expose le même flux via les outils signup, verify_email et create_org.
$ bird auth signup --email agent@example.com
{ "status": "pending_verification" }
$ bird auth verify-email --code 481920
{ "status": "verified" }
$ bird org create --name "Acme"
{ "org": "org_5Kd21", "region": "eu1", "credential": "stored" }
# the same three steps are the signup, verify_email
# and create_org tools on the MCP server
Là où Bird est déjà entièrement intégré et connecté
Les agents de codage installent le plugin et acquièrent les compétences nativement. Les créateurs d'applications connectent le même serveur MCP depuis leurs paramètres, et l'agent génère lui-même la clé API de l'application.
Claude Code. Le plugin fournit les compétences et déclare le serveur MCP.
Cursor. Le plugin apporte les compétences ; le serveur est une simple entrée de configuration.
Codex. Marketplace de plugins, puis connexion depuis le terminal.
GitHub Copilot. Lit directement le manifeste du plugin au format Claude.
Factory Droid. Un seul droid mcp add, puis les compétences copiées à la main.
Tout client MCP. Une URL et une connexion via le navigateur, c'est tout.
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Connectez votre agent à Bird
Collez un seul prompt et regardez l'e-mail de test arriver dans votre boîte de réception. Démarrage gratuit, et le premier envoi prend environ deux minutes.