Qu'est-ce qu'un serveur MCP, et comment un agent l'utilise-t-il pour envoyer des messages ?

Un assistant qui prépare une notification de livraison a besoin d'accéder à l'expéditeur, au destinataire et au contenu du message. Un outil connecté lui permet de soumettre ces champs sans exposer votre identifiant dans la conversation.

MCP est le protocole qui connecte l'application à ces outils.

Que fournit le serveur MCP ?

Le serveur fournit à votre client IA les noms d'outils, les schémas d'entrée et les opérations appelables.

Selon le modèle d'outils MCP, le client découvre les outils. Il soumet des arguments structurés lorsque l'agent en sélectionne un.

Les outils de Bird incluent l'envoi d'e-mails, de messages SMS et WhatsApp. Les outils de configuration gèrent les domaines d'envoi, les numéros et les exigences d'expéditeur. Les outils de vérification démarrent une vérification. Ils vérifient aussi les codes. Un outil distinct permet de passer à un autre canal.

La liste des outils disponibles dans votre client identifie chaque opération et ses entrées requises. Consultez cette liste lorsqu'une opération attendue est absente.

Comment me connecter au serveur hébergé ?

Ajoutez https://mcp.bird.com comme serveur MCP distant. Authentifiez-vous via le navigateur.

Vous n'avez pas besoin d'installer le CLI ni de fournir une clé API. L'authentification via le navigateur permet au client de détenir un jeton avec un sous-ensemble de vos permissions. Bird vérifie chaque requête par rapport aux permissions de ce jeton.

Certains clients affichent le serveur comme nécessitant une authentification tant que vous n'avez pas lancé la procédure. Un client disposant uniquement de l'URL peut lister les outils. Sans authentification, un appel d'outil peut renvoyer 401.

Terminez l'authentification avant de tester un appel d'outil. Le guide de connexion donne les étapes de configuration pour les clients pris en charge.

Comment un agent envoie-t-il et vérifie-t-il un message ?

Confirmez que le destinataire a consenti au message et que le contenu respecte votre politique applicable. Appelez l'outil d'envoi du canal. Consultez les événements de livraison du message résultant.

Pour l'e-mail, la séquence est :

1. Confirmez l'espace de travail, l'identité d'envoi, le destinataire et le contenu.
2. Appelez email_send avec les champs requis de son schéma d'entrée.
3. Enregistrez l'identifiant de message renvoyé.
4. Utilisez email_get pour inspecter le statut de livraison, les résultats par destinataire et la chronologie des événements.

Un envoi accepté ne prouve pas la réception. Un rebond ou un rejet ultérieur nécessite que votre agent ou votre application gère l'échec.

Un expéditeur ou une permission manquante peut empêcher l'envoi. Les outils de configuration et de diagnostic permettent à l'agent d'inspecter ces exigences avant de réessayer.

Puis-je exécuter le serveur localement ?

Oui. Installez le Bird CLI. Authentifiez-vous avec bird auth login. Configurez votre client pour lancer bird mcp.

Le client démarre le processus. Il communique via les flux d'entrée et de sortie du processus. Il a besoin de bird comme commande et de mcp comme argument.

Les serveurs local et hébergé exposent le même ensemble d'outils. L'exécution locale du processus nécessite toujours un accès réseau pour les opérations Bird API.

Utilisez le processus local lorsque vous voulez le gérer vous-même. Votre client doit pouvoir lancer des commandes. Utilisez l'URL hébergée lorsqu'il ne peut pas exécuter un binaire local.

Qu'est-ce qui contrôle les actions que l'agent peut effectuer ?

L'identifiant connecté limite l'accès. Votre hôte IA contrôle quand l'exécution d'un outil nécessite une confirmation.

Bird annote les outils destructifs pour que l'hôte puisse les identifier. Par exemple, la suppression d'une exclusion e-mail est marquée comme destructive car elle peut reprendre un envoi non souhaité.

Les annotations n'imposent pas en elles-mêmes une demande d'approbation. Configurez la politique de votre hôte avant d'autoriser des modifications sur les ressources de production.

Un agent capable de rédiger et soumettre un modèle d'e-mail peut aussi le publier. Une étape de brouillon seule n'empêche pas l'agent d'appeler l'outil de soumission.

La soumission de modèle WhatsApp envoie le modèle à Meta pour examen. Elle ne fournit pas d'étape d'approbation humaine pour chaque autre action que l'agent peut effectuer.

Les outils vocaux inspectent les appels. Ils émettent aussi des identifiants client. Aucun outil MCP ne passe d'appel vocal. Le CLI fournit l'opération d'appel de test.

Pour les agents capables d'exécuter un shell, le CLI fournit une sortie JSON et des codes de retour. Choisissez l'interface que votre hôte peut exécuter. Définissez sa politique de confirmation pour les actions prévues.