Un asistente que organiza una notificación de entrega necesita acceso al remitente, al destinatario y al contenido del mensaje. Una herramienta conectada le permite enviar esos campos sin exponer tu credencial en la conversación.
MCP es el protocolo que conecta la aplicación con esas herramientas.
¿Qué proporciona el servidor MCP?
El servidor da a tu cliente de IA nombres de herramientas, esquemas de entrada y operaciones invocables.
Bajo el modelo de herramientas de MCP, el cliente descubre herramientas. Envía argumentos estructurados cuando el agente selecciona una.
Las herramientas de Bird incluyen envío de correo electrónico, mensajes de SMS y WhatsApp. Las herramientas de configuración gestionan dominios de envío, números y requisitos del remitente. Las herramientas de verificación inician una verificación. También comprueban códigos. Una herramienta separada avanza a otro canal.
La lista de herramientas disponibles en tu cliente identifica cada operación y sus entradas requeridas. Consulta esa lista cuando una operación esperada no aparezca.
¿Cómo me conecto al servidor alojado?
Agrega https://mcp.bird.com como servidor MCP remoto. Inicia sesión a través del navegador.
No necesitas instalar CLI ni proporcionar una clave de API. El inicio de sesión en el navegador permite al cliente mantener un token con un subconjunto de tus permisos. Bird valida cada solicitud contra los permisos de ese token.
Algunos clientes muestran el servidor como pendiente de autenticación hasta que inicias sesión. Un cliente con solo la URL puede listar herramientas. Sin autenticación, una llamada a herramienta puede devolver 401.
Completa la autenticación antes de probar una llamada a herramienta. La guía de conexión describe los pasos de configuración para los clientes compatibles.
¿Cómo envía y verifica un mensaje un agente?
Confirma que el destinatario ha dado su consentimiento al mensaje y que el contenido cumple tu política aplicable. Llama a la herramienta de envío del canal. Lee los eventos de entrega del mensaje resultante.
Para correo electrónico, la secuencia es:
- Confirma el espacio de trabajo, la identidad de envío, el destinatario y el contenido.
- Llama a
email_sendcon los campos requeridos de su esquema de entrada. - Guarda el ID de mensaje devuelto.
- Usa
email_getpara inspeccionar el estado de entrega, los resultados del destinatario y la línea de tiempo de eventos.
Un envío aceptado no prueba la llegada. Un rebote o rechazo posterior requiere que tu agente o aplicación gestione el fallo.
Un remitente o permiso faltante puede impedir el envío. Las herramientas de configuración y diagnóstico permiten al agente inspeccionar esos requisitos antes de reintentar.
¿Puedo ejecutar el servidor localmente?
Sí. Instala Bird CLI. Inicia sesión con bird auth login. Configura tu cliente para lanzar bird mcp.
El cliente inicia el proceso. Se comunica a través de los flujos de entrada y salida del proceso. Necesita bird como comando y mcp como argumento.
Los servidores local y alojado exponen el mismo conjunto de herramientas. Ejecutar el proceso localmente sigue requiriendo acceso a la red para las operaciones de Bird API.
Usa el proceso local cuando quieras gestionarlo tú mismo. Tu cliente debe poder lanzar comandos. Usa la URL alojada cuando no pueda ejecutar un binario local.
¿Qué controla las acciones que el agente puede realizar?
La credencial conectada limita el acceso. Tu host de IA controla cuándo la ejecución de herramientas necesita confirmación.
Bird anota las herramientas destructivas para que el host pueda reconocerlas. Por ejemplo, eliminar una supresión de correo electrónico se marca como destructiva porque puede reanudar envíos no deseados.
Las anotaciones no fuerzan por sí solas un aviso de aprobación. Configura la política de tu host antes de permitir cambios en recursos de producción.
Un agente que puede redactar y enviar una plantilla de correo electrónico también puede publicarla. Un paso de borrador por sí solo no impide que el agente llame a la herramienta de envío.
El envío de plantillas de WhatsApp manda la plantilla a Meta para revisión. No proporciona un paso de aprobación humana para cada otra acción que el agente pueda realizar.
Las herramientas de voz inspeccionan llamadas. También emiten credenciales de cliente. Ninguna herramienta de MCP realiza una llamada de voz. CLI proporciona la operación de llamada de prueba.
Para agentes con acceso a shell, CLI proporciona salida de JSON y códigos de salida. Elige la interfaz que tu host pueda ejecutar. Configura su política de confirmación para las acciones previstas.
En resumen
Conéctate e inicia sesión.
El servidor alojado necesita su URL y autorización en el navegador. Agregar solo la URL no autoriza las llamadas a herramientas.
Elige acceso alojado o local.
Usa https://mcp.bird.com para clientes remotos, o deja que tu cliente lance bird mcp después de iniciar sesión en CLI.
Sigue el mensaje después de enviarlo.
Un resultado de envío confirma la aceptación. Lee el mensaje y sus eventos para determinar la entrega.
Configura la política de confirmación del host.
Las anotaciones de herramientas describen acciones, pero no fuerzan la aprobación. Tu host decide cuándo preguntar antes de ejecutarlas.