Un buen servidor MCP da al agente el mismo acceso que tiene el usuario. Involucra a un humano en el proceso solo cuando un error podría ser costoso, y deja que el agente se encargue de todo lo demás por su cuenta. Esto es lo que se necesita.
Herramientas que el agente puede elegir correctamente
El agente necesita elegir una operación a partir de tu solicitud y proporcionar los argumentos correctos. Comprueba si las descripciones de las herramientas explican qué hace cada operación y qué argumentos acepta.
Prueba buscando con una tarea como configurar un dominio de envío. Los resultados deberían incluir la herramienta correspondiente y su esquema de entrada.
Bird genera sus herramientas a partir del catálogo de operaciones de API. Las descripciones para agentes explican cómo usarlas. El endpoint dinámico de MCP ofrece search y execute. La búsqueda devuelve herramientas coincidentes, sus esquemas, anotaciones de efecto y procedimientos relevantes. El agente puede inspeccionar una herramienta antes de llamarla.
Humano en el proceso cuando un error podría ser costoso
El agente necesita un humano en el proceso cuando un error podría ser costoso. Comprueba que la pantalla de revisión muestre qué va a ocurrir. Comprueba si el agente puede continuar a partir del resultado registrado.
Los detalles faltantes necesitan una pregunta aparte. MCP llama a esto elicitación: el servidor pide al cliente que obtenga información del humano. La elicitación por URL abre una interacción externa, como una pantalla de revisión en el navegador.
Bird usa confirmación en el navegador para operaciones marcadas, incluidas pedidos de números, pedidos de eSIM, operaciones de registro 10DLC y llamadas de voz salientes. El agente prepara la solicitud y devuelve un enlace de revisión. Tú revisas y ejecutas la solicitud en tu navegador. Aceptar la elicitación abre la revisión. El resultado registrado de la operación permite que el agente continúe. La guía de configuración de MCP explica cómo conectar tu cliente.
Errores que el agente puede corregir solo
Un agente necesita saber qué falló, qué cambiar y qué llamar a continuación. Comprueba un campo rechazado: el error debe identificar el problema y la acción que lo resuelve.
Ante un fallo temporal, la respuesta debe indicar si conviene reintentar y cuánto esperar. Si se pierde la respuesta de una acción con consecuencias, el agente necesita verificar qué ocurrió antes de intentarlo de nuevo.
Las respuestas de error MCP de Bird incluyen un código estable, detalles de campo y una corrección cuando hay una disponible. El campo next describe la siguiente acción. retryable y retry_after indican al agente si debe repetir la llamada y cuándo. Un identificador de confirmación permite recuperar el estado y el resultado guardados. La guía de errores de API describe los campos de error.
Seguro para actuar
El agente necesita distinguir lecturas, escrituras y acciones destructivas. Inspecciona las anotaciones de efecto de la herramienta y sus reglas para repetir una solicitud.
Una clave de idempotencia identifica la acción prevista para que una operación compatible pueda devolver una respuesta retenida en una solicitud repetida. Comprueba la ventana de repetición y qué debe hacer el agente cuando expira.
Las herramientas de Bird llevan anotaciones de solo lectura, destructivo e idempotente. En operaciones con repetición de respuesta en caché, la ventana predeterminada es de tres horas. Reutiliza la misma clave y solicitud dentro de esa ventana. Cuando expira, un reintento puede ejecutar la acción de nuevo. Comprueba el estado de la operación antes de otro intento. La guía de idempotencia explica las reglas específicas de cada operación.
Conoce el producto
El agente necesita instrucciones del producto mientras trabaja. Haz una pregunta de configuración y comprueba si puede encontrar la documentación relevante y leer la página completa.
El servidor también debe exponer procedimientos reutilizables. Las habilidades proporcionan al agente instrucciones de tarea y archivos de apoyo que puede cargar cuando los necesite.
Bird ofrece docs_search para secciones de documentación ordenadas por relevancia y docs_read para una página completa. Sus instrucciones de servidor incluyen procedimientos redactados. Skills sobre MCP expone las habilidades bird-cli y email-audit con archivos legibles y resúmenes de archivos. La guía de habilidades del agente describe las tareas que cubren.
Mantiene informado al agente
El agente necesita distinguir aceptación de finalización. Comprueba si un resultado incluye identificadores y campos estructurados que pueda consultar después.
Para trabajo que termina más tarde, el cliente debería poder recibir los cambios relevantes. Una notificación de entrega, por ejemplo, permite al agente continuar después de la respuesta inicial de envío.
Bird devuelve los resultados de confirmación registrados como JSON estructurado. Las lecturas de correo incluyen estado del mensaje, estado del destinatario y eventos. MCP Events alojado permite a los agentes listar eventos y suscribirse a notificaciones firmadas.
Muestra resultados
El humano necesita inspeccionar resultados detallados y actuar sobre ellos. Comprueba si tu cliente renderiza MCP Apps, la extensión para interfaces interactivas dentro de una conversación.
Una interfaz útil te permite inspeccionar los registros subyacentes o actualizar su estado. ChatGPT, Claude web y Desktop, y VS Code GitHub Copilot admiten el renderizado de MCP Apps.
El endpoint estándar MCP de Bird incluye widgets de verificación DNS y entrega de correo. Puedes inspeccionar registros DNS y volver a comprobar un dominio de envío. Las vistas de correo muestran el estado de entrega, los destinatarios y una línea de tiempo de eventos. La guía de configuración del cliente MCP explica cómo conectar tu cliente.
Se conecta en un clic
El humano necesita una forma clara de conectar al agente. Comprueba si el cliente puede descubrir el servidor e iniciar sesión.
El servidor alojado de Bird se conecta mediante OAuth en el navegador. Las instrucciones de conexión del cliente cubren la configuración y el inicio de sesión.
Bird aparece en el registro oficial de MCP y en el directorio de conectores de Claude. Las instrucciones del directorio Bird explican cómo conectar desde Claude.
Cómo evaluar un servidor MCP
Ejecuta una tarea real de principio a fin y pregunta:
- ¿El agente obtiene el mismo acceso que el usuario, sin configuración adicional?
- ¿Elige la herramienta y los argumentos correctos a partir de una solicitud en lenguaje natural?
- Antes de cualquier acción costosa, ¿un humano tiene la oportunidad de aprobarla?
- Cuando una llamada falla, ¿el error indica qué corregir, qué llamar después y si se debe reintentar?
- ¿Puede el agente reintentar sin ejecutar la misma acción dos veces?
- ¿Puede consultar la documentación y las guías del producto por su cuenta?
- ¿Puede verificar qué ocurrió después y recibir notificaciones de cambios?
- ¿Puedes ver el resultado en tu cliente, no solo leer sobre él?