Configura tu agente de programación
Conecta tu agente de programación a Bird, confirma el espacio de trabajo que puede usar y completa una primera tarea para el producto que estás desarrollando. Usa una conexión MCP existente o una CLI con sesión iniciada, si están disponibles. El prompt de configuración guía al agente en esa elección.
Una conexión correcta permite acceder a tu espacio de trabajo. Para enviar un mensaje, hacer una llamada o configurar otro producto, también necesitas la cuenta, el remitente, el número o el dispositivo de ese producto. Sigue la guía del producto correspondiente antes de ejecutar la primera operación.
Copia este prompt en tu agente
Ejemplo de código
Help me connect my coding agent to Bird and complete a first task.
1. Inspect the available Bird MCP connection or CLI installation and its sign-in state. Use whichever is already authenticated, and confirm its account and workspace; either is sufficient.
2. If neither is authenticated, follow the current per-client setup instructions at https://bird.com/docs/ai/set-up-your-agent.md. Read the Markdown guide. Complete the browser sign-in and confirm the account and workspace you will use.
3. Read the Bird product guide for my task. Before proposing changes, make a read-only inventory of my integration's call sites, identifiers and configured URLs. Identify the required permissions and account, sender, number or device setup.
4. Prepare a first example for the product and the recipient or destination I choose. Use published operations from the available CLI or MCP surface. Before any paid send or submission, show me the exact prepared action and applicable charges, and get my explicit approval. If the surface does not quote a price, ask the account owner to confirm the charges before proceeding; do not estimate them or submit the operation while they remain unknown.
5. Follow the operation through to its actual result. Explain remaining setup, rejected work or an uncertain outcome, and help me choose the next step.Algunas páginas de marketing ofrecen un prompt de configuración para Claude Code, Codex y Cursor, con la página actual como contexto. Los pasos para cada cliente explican las diferencias en la instalación de habilidades.
O configúralo manualmente según el cliente
Todos los clientes empiezan de la misma forma; solo cambia el paso de las habilidades.
Ejemplo de código
curl -fsSL https://cli.bird.com/install.sh | sh # install the CLI
bird auth login # sign in (browser, no API key)Claude Code
Ejemplo de código
claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-aiCodex
Ejemplo de código
codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-aiCursor
El botón de Cursor en la página de inicio abre Cursor con el prompt de configuración ya rellenado (un enlace profundo de prompt); revísalo y envíalo. El prompt instala las habilidades de Bird obteniéndolas de github.com/messagebird/bird-ai y copiando las carpetas de habilidades en .agents/skills/, uno de los directorios desde los que Cursor carga Agent Skills. Para hacerlo a mano, instala el plugin: añade el marketplace messagebird/bird-ai en Settings > Plugins, o usa cursor.directory. Ambas opciones proporcionan a Cursor las mismas dos habilidades.
Cualquier cliente compatible con Agent Plugins
El plugin de Bird sigue Agent Plugins, el formato de plugins portátil. Un cliente que implemente la especificación instala el plugin desde github.com/messagebird/bird-ai sin cambios y obtiene las habilidades y el servidor MCP en un solo paso en lugar de dos. Usa el comando de instalación de plugins del propio cliente e indica ese repositorio.
OpenCode
Ejemplo de código
opencode plugin github:messagebird/bird-ai --global
opencode mcp auth birdEl plugin añade las skills y el servidor MCP en un solo paso; reinicia OpenCode para cargarlo.
Cualquier otro agente (Zed, Amp, Goose, pi, Cline, …)
Si el cliente no lee ninguno de los dos formatos, copia la skill en el directorio de skills del agente:
Ejemplo de código
git clone --depth 1 https://github.com/messagebird/bird-ai /tmp/bird-ai
mkdir -p .agents/skills && cp -r /tmp/bird-ai/plugins/bird/skills/. .agents/skills/La mayoría de los agentes leen .agents/skills/; Cline usa .clinerules/skills/. Esto es opcional: el bird CLI funciona sin ello.
Autenticación
bird auth login ejecuta un flujo OAuth en el navegador con alcance limitado a tu espacio de trabajo, así que no necesitas guardar una clave API ni un secreto en ninguna configuración. bird auth status muestra el espacio de trabajo, la región y los permisos concedidos.
Qué aportan las skills a tu agente
| Skill | Qué hace |
|---|---|
| bird-cli | Dirige una solicitud a una referencia por grupo de comandos CLI, en todos los canales que Bird gestiona y la configuración que cada uno necesita antes de enviar |
| email-audit | Evalúa los registros DMARC, SPF, DKIM, BIMI y MX activos de un dominio y devuelve los hallazgos como una lista de correcciones priorizada |
Agent skills describe qué contiene cada una, cómo se instala el plugin en cada cliente y cómo se relacionan las skills con el servidor MCP.
Conecta el servidor MCP en su lugar
Para clientes que llaman herramientas en vez de ejecutar una shell, conéctate al servidor MCP alojado de Bird en https://mcp.bird.com. Esto incluye Claude Desktop, ChatGPT y clientes móviles. Autentícate después de añadir la URL; los clientes sin autenticar pueden listar las herramientas de Bird, pero todas las llamadas fallan. Cada host usa un disparador diferente: Claude Code usa /mcp > bird > Authenticate, Claude Desktop usa Connect y Cursor usa Needs login. Consulta los pasos de conexión por cliente. La guía del servidor MCP también cubre stdio local.
Próximos pasos
- CLI para agentes: el contrato de agente del bird CLI.
- Agent skills: qué enseña cada skill y la matriz de compatibilidad por cliente.
- Servidor MCP: el endpoint alojado y la superficie de herramientas.
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íaSetting up your coding agentComprender 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