O que é um servidor MCP e como um agente usa um para enviar mensagens?

Um assistente organizando uma notificação de entrega precisa de acesso ao remetente, destinatário e conteúdo da mensagem. Uma ferramenta conectada permite que ele envie esses campos sem expor sua credencial na conversa.

MCP é o protocolo que conecta a aplicação a essas ferramentas.

O que o servidor MCP fornece?

O servidor entrega ao seu cliente de IA nomes de ferramentas, schemas de entrada e operações invocáveis.

No modelo de ferramentas MCP, o cliente descobre as ferramentas. Ele envia argumentos estruturados quando o agente seleciona uma.

As ferramentas da Bird incluem envio de email, mensagens SMS e WhatsApp. Ferramentas de configuração gerenciam domínios de envio, números e requisitos de remetente. Ferramentas de verificação iniciam uma verificação. Elas também validam códigos. Uma ferramenta separada avança para outro canal.

A lista de ferramentas disponíveis no seu cliente identifica cada operação e suas entradas obrigatórias. Consulte essa lista quando uma operação esperada estiver ausente.

Como me conecto ao servidor hospedado?

Adicione https://mcp.bird.com como um servidor MCP remoto. Faça login pelo navegador.

Você não precisa instalar o CLI nem fornecer uma chave API. O login pelo navegador permite que o cliente mantenha um token com um subconjunto das suas permissões. Bird valida cada solicitação contra as permissões desse token.

Alguns clientes mostram o servidor como precisando de autenticação até você iniciar o login. Um cliente com apenas a URL pode listar ferramentas. Sem autenticação, uma chamada de ferramenta pode retornar 401.

Conclua a autenticação antes de testar uma chamada de ferramenta. O guia de conexão apresenta os passos de configuração para clientes compatíveis.

Como um agente envia e verifica uma mensagem?

Confirme que o destinatário consentiu com a mensagem e que o conteúdo atende à sua política aplicável. Chame a ferramenta de envio do canal. Leia os eventos de entrega da mensagem resultante.

Para email, a sequência é:

1. Confirme o espaço de trabalho, a identidade de envio, o destinatário e o conteúdo.
2. Chame email_send com os campos obrigatórios do seu schema de entrada.
3. Salve o ID da mensagem retornado.
4. Use email_get para inspecionar o status de entrega, os resultados por destinatário e a linha do tempo de eventos.

Um envio aceito não prova a chegada. Um bounce ou rejeição posterior exige que seu agente ou aplicação trate a falha.

Um remetente ou permissão ausente pode impedir o envio. Ferramentas de configuração e diagnóstico permitem que o agente inspecione esses requisitos antes de tentar novamente.

Posso executar o servidor localmente?

Sim. Instale o Bird CLI. Faça login com bird auth login. Configure seu cliente para iniciar bird mcp.

O cliente inicia o processo. Ele se comunica pelos fluxos de entrada e saída do processo. Ele precisa de bird como comando e mcp como argumento.

Os servidores local e hospedado expõem o mesmo conjunto de ferramentas. Executar o processo localmente ainda requer acesso à rede para operações Bird API.

Use o processo local quando quiser gerenciá-lo você mesmo. Seu cliente precisa conseguir executar comandos. Use a URL hospedada quando ele não puder executar um binário local.

O que controla quais ações o agente pode executar?

A credencial conectada limita o acesso. Seu host de IA controla quando a execução de uma ferramenta precisa de confirmação.

Bird anota ferramentas destrutivas para que o host possa reconhecê-las. Por exemplo, remover uma supressão de email é marcado como destrutivo porque pode retomar envios indesejados.

Anotações por si só não forçam um prompt de aprovação. Configure a política do seu host antes de permitir alterações em recursos de produção.

Um agente que pode rascunhar e enviar um template de email também pode publicá-lo. Uma etapa de rascunho sozinha não impede o agente de chamar a ferramenta de envio.

O envio de template da WhatsApp envia o template para análise da Meta. Ele não fornece uma etapa de aprovação humana para todas as outras ações que o agente pode executar.

Ferramentas de voz inspecionam chamadas. Elas também emitem credenciais de cliente. Nenhuma ferramenta MCP realiza uma chamada de voz. O CLI fornece a operação de chamada de teste.

Para agentes com acesso a shell, o CLI fornece saída JSON e códigos de saída. Escolha a interface que seu host pode executar. Defina sua política de confirmação para as ações pretendidas.