Un bon serveur MCP donne à un agent le même accès que l'utilisateur. Il ne fait intervenir un humain que lorsqu'une erreur pourrait coûter cher, et laisse l'agent gérer tout le reste de façon autonome. Voici ce que cela exige.
Des outils que l'agent peut choisir correctement
L'agent doit choisir une opération à partir de votre requête et fournir les bons arguments. Vérifiez si les descriptions des outils expliquent ce que fait chaque opération et les arguments qu'elle accepte.
Essayez une recherche avec une tâche comme la configuration d'un domaine d'envoi. Les résultats devraient inclure l'outil correspondant et son schéma d'entrée.
Bird génère ses outils à partir du catalogue d'opérations API. Les descriptions pour agents expliquent comment les utiliser. Le point de terminaison dynamique MCP propose search et execute. La recherche renvoie les outils correspondants, leurs schémas, les annotations d'effet et les procédures pertinentes. L'agent peut inspecter un outil avant de l'appeler.
Intervention humaine là où une erreur pourrait coûter cher
L'agent a besoin d'une intervention humaine là où une erreur pourrait coûter cher. Vérifiez que l'écran de révision montre ce qui va se passer. Vérifiez si l'agent peut reprendre à partir du résultat enregistré.
Les détails manquants nécessitent une question séparée. MCP appelle cela l'élicitation : le serveur demande au client d'obtenir des informations auprès de l'humain. L'élicitation par URL ouvre une interaction externe, comme un écran de révision dans le navigateur.
Bird utilise la confirmation par navigateur pour les opérations marquées, notamment les commandes de numéros, les commandes d'eSIM, les opérations d'enregistrement 10DLC et les appels vocaux sortants. L'agent prépare la requête et renvoie un lien de révision. Vous examinez et exécutez la requête dans votre navigateur. Accepter l'élicitation ouvre la révision. Le résultat d'opération enregistré permet à l'agent de reprendre. Le guide de configuration MCP explique comment connecter votre client.
Erreurs que l'agent peut corriger seul
Un agent doit savoir ce qui a échoué, ce qu'il doit modifier et quel appel effectuer ensuite. Testez un champ rejeté : l'erreur doit identifier le problème et l'action qui le résout.
Pour une défaillance temporaire, la réponse doit indiquer s'il faut réessayer et combien de temps attendre. Après une réponse perdue à une action conséquente, l'agent doit établir ce qui s'est passé avant de retenter.
Les réponses d'erreur MCP de Bird incluent un code stable, le détail des champs et une correction quand elle est disponible. Le champ next décrit l'action suivante. retryable et retry_after indiquent à l'agent s'il doit répéter l'appel et quand le faire. Un identifiant de confirmation lui permet de récupérer le statut et le résultat enregistrés. Le guide des erreurs API décrit les champs d'erreur.
Sûr pour agir
L'agent doit distinguer les lectures, les écritures et les actions destructrices. Inspectez les indicateurs d'effet de l'outil et ses règles de répétition d'une requête.
Une clé d'idempotence identifie l'action visée afin qu'une opération compatible puisse renvoyer une réponse conservée lors d'une requête répétée. Vérifiez la fenêtre de rejeu et ce que l'agent doit faire après son expiration.
Les outils de Bird portent des indicateurs lecture seule, destructif et idempotent. Sur les opérations avec rejeu de réponse en cache, la fenêtre par défaut est de trois heures. Réutilisez la même clé et la même requête dans cette fenêtre. Après son expiration, une nouvelle tentative peut exécuter l'action à nouveau. Vérifiez le statut de l'opération avant un autre essai. Le guide d'idempotence explique les règles propres à chaque opération.
Connaît le produit
L'agent a besoin d'instructions produit pendant qu'il travaille. Posez une question de configuration et vérifiez s'il peut trouver la documentation pertinente et lire la page complète.
Le serveur doit aussi exposer des procédures réutilisables. Les skills fournissent à l'agent des instructions de tâche et des fichiers associés qu'il peut charger au besoin.
Bird fournit docs_search pour des sections de documentation classées et docs_read pour une page complète. Ses instructions serveur incluent des procédures rédigées. Skills over MCP expose les skills bird-cli et email-audit avec des fichiers lisibles et des empreintes de fichiers. Le guide des skills d'agent décrit les tâches couvertes.
Tient l'agent informé
L'agent doit distinguer l'acceptation de l'achèvement. Vérifiez si le résultat inclut des identifiants et des champs structurés qu'il peut relire par la suite.
Pour un travail qui se termine plus tard, le client doit pouvoir recevoir les changements pertinents. Une notification de livraison, par exemple, permet à l'agent de continuer après la réponse initiale d'envoi.
Bird renvoie les résultats de confirmation enregistrés sous forme de JSON structuré. Les lectures d'e-mails incluent le statut du message, le statut du destinataire et les événements. MCP Events hébergé permet aux agents de lister les événements et de s'abonner à des notifications signées.
Affiche les résultats
L'utilisateur doit pouvoir inspecter les résultats détaillés et agir dessus. Vérifiez si votre client affiche MCP Apps, l'extension pour les interfaces interactives dans une conversation.
Une interface utile vous permet d'inspecter les enregistrements sous-jacents ou d'actualiser leur statut. ChatGPT, Claude web et Desktop, et VS Code GitHub Copilot prennent en charge le rendu MCP Apps.
Le point de terminaison MCP standard de Bird inclut des widgets de vérification DNS et de livraison d'e-mails. Vous pouvez inspecter les enregistrements DNS et revérifier un domaine d'envoi. Les vues e-mail affichent le statut de livraison, les destinataires et une chronologie des événements. Le guide de configuration du client MCP explique comment connecter votre client.
Connexion en un clic
L'utilisateur a besoin d'un moyen clair de connecter l'agent. Vérifiez si le client peut découvrir le serveur et lancer l'authentification.
Le serveur hébergé de Bird se connecte via OAuth dans le navigateur. Les instructions de connexion du client couvrent la configuration et l'authentification.
Bird est répertorié dans le registre officiel MCP et dans le répertoire de connecteurs de Claude. Les instructions du répertoire Bird expliquent comment se connecter depuis Claude.
Comment évaluer un serveur MCP
Exécutez une tâche réelle du début à la fin et posez-vous ces questions :
- L'agent obtient-il le même accès que l'utilisateur, sans configuration supplémentaire ?
- Choisit-il le bon outil et les bons arguments à partir d'une requête en langage courant ?
- Avant toute action coûteuse, un humain peut-il l'approuver ?
- Quand un appel échoue, l'erreur indique-t-elle ce qu'il faut corriger, quelle opération appeler ensuite et s'il faut réessayer ?
- L'agent peut-il réessayer sans exécuter la même action deux fois ?
- Peut-il consulter la documentation et les guides pratiques du produit par lui-même ?
- Peut-il vérifier ce qui s'est passé ensuite et être informé des changements ?
- Pouvez-vous voir le résultat dans votre client, et pas seulement en lire la description ?