Sign inGet Started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

Incorporación con IA

Usa la bird CLI y las skills de Bird cuando tu agente de código pueda ejecutar comandos de shell. Usa el servidor MCP alojado cuando tu cliente llame herramientas en su lugar. Ambas superficies pueden buscar en la documentación, y los agentes sin herramientas pueden leer el corpus Markdown publicado. Empieza con CLI a menos que tu cliente requiera MCP.

1. Configura tu agente (CLI + skills)

Pega el prompt de configuración en tu agente de código. Instala la bird CLI, inicia sesión con bird auth login, instala las skills de Bird, y envía un correo de prueba para confirmar la configuración. Los botones Claude Code, Codex y Cursor en las páginas de producto de Bird copian un prompt adaptado a cada cliente. Configura tu agente de código recorre el mismo flujo.

2. Conecta el servidor MCP (cuando encaje)

Si tu cliente llama herramientas en lugar de ejecutar un shell, apúntalo al servidor MCP alojado de Bird. Solo necesitas la URL y un inicio de sesión en el navegador:
Ejemplo de código
https://mcp.bird.com
El endpoint usa OAuth, así que autentícate una vez en cada cliente. Tu navegador abre una pantalla de consentimiento de Bird donde inicias sesión, eliges un espacio de trabajo y permisos, y apruebas el acceso. No necesitas una clave API ni un secreto en la configuración del cliente. Sigue los pasos de conexión para tu cliente. La guía del servidor MCP también cubre la superficie de herramientas, OAuth delegado y la opción bird mcp local.

3. Dale la documentación a tu agente

Si tu agente tiene las herramientas Bird del paso 1 o 2, ya puede leer esta documentación: docs_search encuentra páginas por consulta y docs_read devuelve una como Markdown. Desde un shell son bird docs search "ip warmup" y bird docs read <slug>. Prefiere esto a cargar el corpus porque el agente obtiene solo la página actual que necesita.
Para agentes que no pueden llamar herramientas, todo el sitio se publica como Markdown:
  • /llms.txt: el índice, un resumen plano y rico en enlaces de cada página, un punto de partida desde el que el agente puede seguir enlaces.
  • /llms-full.txt: el corpus completo, todas las páginas de documentación concatenadas como Markdown, para agentes que quieran todo el contenido en contexto.
Ambos archivos se regeneran con cada despliegue del sitio. También puedes usar las herramientas de IA en la barra lateral de una página de documentación: Copy as Markdown copia esa página y Open llms-full.txt abre el corpus. La página de incorporación de email del dashboard ofrece los mismos atajos Copy for AI.
La página de incorporación de email en el dashboard de Bird, con el paso de la clave API, un fragmento de envío ejecutable y la acción Copy for AI
Los formatos, el tamaño y los consejos de recuperación se cubren en la guía de llms.txt.

4. Pruébalo

Una vez que tu agente esté configurado, dale una tarea real de principio a fin:
Find my email with whoami, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.
El agente lee tu dirección con whoami, envía desde el dominio de incorporación compartido de Bird y consulta el estado hasta que el mensaje llegue a tu bandeja de entrada. El dominio de incorporación puede enviar a miembros verificados de tu espacio de trabajo sin verificación de dominio. Para una comprobación determinista sin bandeja real, envía a delivered@messagebird.dev en su lugar; consulta el sandbox de pruebas.

Próximos pasos

  • Registro autoservicio: para un agente que necesita su propia cuenta Bird en lugar de la tuya. Crea la cuenta, la organización y el espacio de trabajo desde la terminal, sin navegador.
  • CLI para agentes: el contrato de agente de bird CLI. Salida JSON, códigos de salida semánticos, login OAuth.
  • Skills de agente: el plugin bird-ai del marketplace y lo que obtiene cada cliente.
  • Servidor MCP: el endpoint alojado, la superficie completa de herramientas, el modelo OAuth delegado y la opción local-stdio.
  • llms.txt y documentación Markdown: cómo se construye el corpus legible por máquinas y cómo recuperar contenido de él.
  • Envía tu primer email: completa el mismo flujo de email sin un agente.
  • Configura tu agente de código: un vídeo que conecta un agente y envía un correo de prueba a través de él

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaTesting email without spamming anyoneComprender el conceptoWhat is an MCP server, and how does an agent use one to send messages?Explorar la funcionalidadCoding agentsSeguir la ruta de aprendizajeBuild with AI agents
Obtener un resumen de implementación