Um bom servidor MCP dá ao agente o mesmo acesso que o usuário tem. Ele traz um humano para o fluxo apenas onde um erro poderia ser caro, e deixa o agente lidar com todo o resto sozinho. Veja o que isso exige.
Ferramentas que o agente consegue escolher corretamente
O agente precisa escolher uma operação a partir da sua solicitação e fornecer os argumentos corretos. Verifique se as descrições das ferramentas explicam o que cada operação faz e quais argumentos ela aceita.
Tente pesquisar com uma tarefa como configurar um domínio de envio. Os resultados devem incluir a ferramenta correspondente e seu esquema de entrada.
Bird gera suas ferramentas a partir do catálogo de operações API. As descrições para agentes explicam como usá-las. O endpoint dinâmico MCP oferece search e execute. A pesquisa retorna ferramentas correspondentes, seus esquemas, anotações de efeito e procedimentos relevantes. O agente pode inspecionar uma ferramenta antes de chamá-la.
Humano no fluxo onde um erro poderia ser caro
O agente precisa de um humano no fluxo onde um erro poderia ser caro. Verifique se a tela de revisão mostra o que vai acontecer. Verifique se o agente consegue retomar a partir do resultado registrado.
Detalhes faltantes precisam de uma pergunta separada. MCP chama isso de elicitation: o servidor pede ao cliente que obtenha informações do humano. A elicitation por URL abre uma interação externa, como uma tela de revisão no navegador.
Bird usa confirmação no navegador para operações marcadas, incluindo pedidos de números, pedidos de eSIM, operações de registro 10DLC e chamadas de voz de saída. O agente prepara a solicitação e retorna um link de revisão. Você revisa e executa a solicitação no seu navegador. Aceitar a elicitation abre a revisão. O resultado registrado da operação permite que o agente retome. O guia de configuração MCP explica como conectar seu cliente.
Erros que o agente consegue corrigir sozinho
O agente precisa saber o que falhou, o que mudar e o que chamar em seguida. Verifique um campo rejeitado: o erro deve identificar o problema e a ação que o resolve.
Para uma falha temporária, a resposta deve informar se é possível tentar novamente e quanto tempo esperar. Depois de uma resposta perdida para uma ação consequente, o agente precisa verificar o que aconteceu antes de tentar de novo.
As respostas de erro MCP do Bird incluem um código estável, detalhes de campo e uma correção quando disponível. O campo next descreve a próxima ação. retryable e retry_after informam ao agente se deve repetir a chamada e quando. Um identificador de confirmação permite recuperar o status e o resultado salvos. O guia de erros do API descreve os campos de erro.
Seguro para agir
O agente precisa distinguir leituras, escritas e ações destrutivas. Inspecione as indicações de efeito da ferramenta e suas regras para repetir uma solicitação.
Uma chave de idempotência identifica a ação pretendida para que uma operação compatível possa retornar uma resposta retida em uma solicitação repetida. Verifique a janela de replay e o que o agente deve fazer após ela expirar.
As ferramentas do Bird carregam indicações de somente leitura, destrutivo e idempotente. Em operações com replay de resposta em cache, a janela padrão é de três horas. Reutilize a mesma chave e solicitação dentro dessa janela. Depois que ela expira, uma nova tentativa pode executar a ação novamente. Verifique o status da operação antes de outra tentativa. O guia de idempotência explica as regras específicas de cada operação.
Conhece o produto
O agente precisa de instruções do produto enquanto trabalha. Faça uma pergunta de configuração e verifique se ele consegue encontrar a documentação relevante e ler a página completa.
O servidor também deve expor procedimentos reutilizáveis. Skills fornecem ao agente instruções de tarefa e arquivos de apoio que ele pode carregar quando necessário.
O Bird fornece docs_search para seções de documentação ranqueadas e docs_read para uma página completa. Suas instruções de servidor incluem procedimentos escritos. Skills sobre MCP expõe os skills bird-cli e email-audit com arquivos legíveis e resumos de arquivo. O guia de skills do agente descreve as tarefas que eles cobrem.
Mantém o agente informado
O agente precisa distinguir aceitação de conclusão. Verifique se o resultado inclui identificadores e campos estruturados que ele possa consultar depois.
Para trabalhos que terminam depois, o cliente deve conseguir receber as mudanças relevantes. Uma notificação de entrega, por exemplo, permite que o agente continue após a resposta inicial de envio.
Bird retorna resultados de confirmação registrados como JSON estruturado. Leituras de e-mail incluem status da mensagem, status do destinatário e eventos. O MCP Events hospedado permite que agentes listem eventos e assinem notificações assinadas digitalmente.
Mostra resultados
O humano precisa inspecionar resultados detalhados e agir sobre eles. Verifique se o seu cliente renderiza MCP Apps, a extensão para interfaces interativas dentro de uma conversa.
Uma interface útil permite inspecionar os registros subjacentes ou atualizar o status deles. ChatGPT, Claude web e Desktop, e VS Code GitHub Copilot suportam a renderização de MCP Apps.
O endpoint padrão MCP do Bird inclui widgets de verificação de DNS e entrega de e-mail. Você pode inspecionar registros DNS e verificar novamente um domínio de envio. As visualizações de e-mail mostram status de entrega, destinatários e uma linha do tempo de eventos. O guia de configuração de cliente MCP explica como conectar seu cliente.
Conecta em um clique
O humano precisa de uma forma clara de conectar o agente. Verifique se o cliente consegue descobrir o servidor e iniciar o login.
O servidor hospedado do Bird se conecta por meio de OAuth no navegador. As instruções de conexão do cliente cobrem configuração e login.
O Bird está listado no registro oficial MCP e no diretório de conectores do Claude. As instruções do diretório Bird explicam como conectar a partir do Claude.
Como avaliar um servidor MCP
Execute uma tarefa real do início ao fim e pergunte:
- O agente recebe o mesmo acesso que o usuário tem, sem configuração extra?
- Ele escolhe a ferramenta e os argumentos certos a partir de uma solicitação simples?
- Antes de qualquer ação custosa, um humano tem a chance de aprovar?
- Quando uma chamada falha, o erro diz o que corrigir, o que chamar em seguida e se deve tentar novamente?
- O agente consegue tentar novamente sem executar a mesma ação duas vezes?
- Ele consegue consultar a documentação e os guias do produto por conta própria?
- Ele consegue verificar o que aconteceu depois e receber notificações de mudanças?
- Você consegue ver o resultado no seu cliente, e não apenas ler sobre ele?