Configure seu agente de programação

Conecte seu agente de programação ao Bird, confirme o espaço de trabalho que ele pode usar e conclua uma primeira tarefa para o produto que você está desenvolvendo. Use uma conexão MCP existente ou uma CLI com login já realizado, se disponível. O prompt de configuração orienta o agente nessa escolha.

Uma conexão bem-sucedida permite acessar seu espaço de trabalho. Para enviar uma mensagem, fazer uma chamada ou configurar outro produto, também é necessário configurar a conta, o remetente, o número ou o dispositivo desse produto. Siga o guia do produto correspondente antes de executar a primeira operação.

Copie este prompt para seu agente

Exemplo 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.

Algumas páginas de marketing oferecem um prompt de configuração para Claude Code, Codex e Cursor, com a página atual como contexto. As etapas por cliente explicam as diferenças na instalação das habilidades.

Ou configure manualmente para cada cliente

Todos os clientes começam da mesma forma; apenas a etapa das habilidades é diferente.

Exemplo 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

Exemplo de código

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

Codex

Exemplo de código

codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-ai

Cursor

O botão do Cursor na página inicial abre o Cursor com o prompt de configuração preenchido (um link direto de prompt); revise e envie. O prompt instala as habilidades do Bird ao buscá-las em github.com/messagebird/bird-ai e copiar suas pastas para .agents/skills/, um dos diretórios de onde o Cursor carrega Agent Skills. Para fazer isso manualmente, instale o plugin: adicione o marketplace messagebird/bird-ai em Settings > Plugins, ou use cursor.directory. Os dois caminhos fornecem as mesmas duas habilidades ao Cursor.

Qualquer cliente compatível com Agent Plugins

O plugin do Bird segue Agent Plugins, o formato portátil de plugins. Um cliente que implementa a especificação instala o plugin de github.com/messagebird/bird-ai sem alterações e recebe as habilidades e o servidor MCP em uma etapa, em vez de duas. Use o comando de instalação de plugins do próprio cliente e indique esse repositório.

OpenCode

Exemplo de código

opencode plugin github:messagebird/bird-ai --global
opencode mcp auth bird

O plugin adiciona as skills e o servidor MCP em um único passo; reinicie o OpenCode para carregá-lo.

Qualquer outro agente (Zed, Amp, Goose, pi, Cline, …)

Para um cliente que não lê nenhum dos dois formatos, copie a skill para o diretório de skills do agente:

Exemplo 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/

A maioria dos agentes lê .agents/skills/; o Cline usa .clinerules/skills/. Isso é opcional: a bird CLI funciona sem isso.

Autentique

bird auth login executa um fluxo de OAuth no navegador com escopo restrito ao seu espaço de trabalho, então você não precisa manter uma chave ou segredo API em nenhuma configuração. bird auth status exibe o espaço de trabalho, a região e os escopos concedidos.

O que as skills oferecem ao seu agente

Skill	O que faz
bird-cli	Direciona uma solicitação para uma referência por grupo de comandos CLI, abrangendo cada canal que Bird opera e a configuração necessária antes de enviar
email-audit	Avalia os registros DMARC, SPF, DKIM, BIMI e MX ativos de um domínio e retorna as descobertas como uma lista de correções priorizada

Agent skills detalha o conteúdo de cada uma, como o plugin é instalado por cliente e como as skills se relacionam com o servidor MCP.

Conecte o servidor MCP em vez disso

Para clientes que chamam ferramentas em vez de executar um shell, conecte-se ao servidor MCP hospedado de Bird em https://mcp.bird.com. Isso inclui Claude Desktop, ChatGPT e clientes móveis. Autentique após adicionar a URL; clientes não autenticados conseguem listar as ferramentas de Bird, mas toda chamada falha. Cada host usa um gatilho diferente: Claude Code usa /mcp > bird > Authenticate, Claude Desktop usa Connect e Cursor usa Needs login. Veja os passos de conexão por cliente. O guia do servidor MCP também cobre stdio local.

Próximos passos

CLI para agentes: o contrato de agente da bird CLI.
Agent skills: o que cada skill ensina e a matriz de compatibilidade por cliente.
Servidor MCP: o endpoint hospedado e a superfície de ferramentas.

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaSetting up your coding agent Entenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agents Siga o percurso de aprendizagemBuild with AI agents

Obtenha um resumo de implementação