Onboarding de IA
Use a bird CLI e as skills do Bird quando seu agente de código pode executar comandos no shell. Use o servidor MCP hospedado quando seu cliente chama ferramentas em vez disso. As duas superfícies podem pesquisar a documentação, e agentes sem ferramentas podem ler o corpus Markdown publicado. Comece pelo CLI, a menos que seu cliente exija MCP.
1. Configure seu agente (CLI + skills)
Cole o prompt de configuração no seu agente de código. Ele instala a bird CLI, faz login com bird auth login, instala as skills do Bird e envia um e-mail de teste para confirmar a configuração. Os botões Claude Code, Codex e Cursor nas páginas de produto do Bird copiam um prompt adaptado a cada cliente. Configure seu agente de código mostra o mesmo fluxo passo a passo.
2. Conecte o servidor MCP (quando for adequado)
Se seu cliente chama ferramentas em vez de executar um shell, aponte-o para o servidor MCP hospedado do Bird. Você só precisa da URL e de um login no navegador:
Exemplo de código
https://mcp.bird.comO endpoint usa OAuth, então autentique uma vez em cada cliente. Seu navegador abre uma tela de consentimento Bird onde você faz login, escolhe um espaço de trabalho e permissões e aprova o acesso. Você não precisa de uma chave API nem de um segredo na configuração do cliente. Siga os passos de conexão para o seu cliente. O guia do servidor MCP também cobre a superfície de ferramentas, OAuth delegado e a opção bird mcp local.
3. Dê a documentação ao seu agente
Se seu agente tem as ferramentas Bird do passo 1 ou 2, ele já pode ler esta documentação: docs_search encontra páginas por consulta e docs_read retorna uma como Markdown. No shell, esses comandos são bird docs search "ip warmup" e bird docs read <slug>. Prefira isso a carregar o corpus, porque o agente busca apenas a página atual de que precisa.
Para agentes que não podem chamar ferramentas, o site inteiro é publicado como Markdown:
- /llms.txt: o índice, um resumo plano e rico em links de todas as páginas, um ponto de partida a partir do qual o agente pode seguir links.
- /llms-full.txt: o corpus completo, todas as páginas de documentação concatenadas como Markdown, para agentes que querem tudo no contexto.
Ambos os arquivos são regenerados a cada deploy do site. Você também pode usar as ferramentas de IA na barra lateral de uma página de documentação: Copy as Markdown copia a página e Open llms-full.txt abre o corpus. A página de onboarding de e-mail do dashboard oferece os mesmos atalhos Copy for AI.
Os formatos, dimensionamento e dicas de recuperação estão no guia llms.txt.
4. Teste
Quando seu agente estiver configurado, dê a ele uma tarefa real de ponta a ponta:
Find my email with whoami, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.
O agente lê seu endereço com whoami, envia a partir do domínio de onboarding compartilhado do Bird e consulta o status até a mensagem chegar à sua caixa de entrada. O domínio de onboarding pode enviar para membros verificados do seu espaço de trabalho sem verificação de domínio. Para uma verificação determinística sem caixa de entrada real, envie para delivered@messagebird.dev; veja o sandbox de testes.
Próximos passos
- Cadastro self-service: para um agente que precisa de sua própria conta Bird em vez da sua. Crie a conta, organização e espaço de trabalho pelo terminal, sem navegador.
- CLI para agentes: o contrato de agente da bird CLI. Saída JSON, códigos de saída semânticos, login OAuth.
- Skills de agente: o plugin bird-ai do marketplace e o que cada cliente recebe.
- Servidor MCP: o endpoint hospedado, a superfície completa de ferramentas, o modelo OAuth delegado e a opção local-stdio.
- llms.txt e documentação Markdown: como o corpus legível por máquina é construído e como recuperar informações dele.
- Envie seu primeiro e-mail: complete o mesmo fluxo de e-mail sem um agente.
- Configurar o seu agente de código: um vídeo que conecta um agente e envia um e-mail de teste por ele
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaTesting email without spamming anyoneEntenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agentsSiga o percurso de aprendizagemBuild with AI agents
Obtenha um resumo de implementação