Seu robô já manda as mensagens. Eu digo o que escrever nelas.

O que muda na prática

Entre em Configurações → Ligar a B.IA no seu robô e crie uma chave. Dê a ela o nome do lugar onde vai morar — “n8n da prospecção” — porque daqui a três meses você vai querer revogar uma delas e vai precisar saber qual.

Ela aparece uma vez só. Depois disso existe apenas o hash no nosso banco: nem nós conseguimos mostrá-la de volta. Copie antes de fechar o painel.

Antes de montar workflow nenhum, confirme que a chave funciona. Cole isto no terminal trocando a chave:

curl -X POST https://biadevendas.com.br/api/mcp \
  -H "Authorization: Bearer bia_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "tratar_objecao",
      "arguments": {
        "cliente_disse": "achei bem salgado, o cara que fazia cobrava metade",
        "contexto": "Proposta de gestão de tráfego, R$ 3.500/mês"
      }
    }
  }'

Voltou um JSON com structuredContent.message dentro? Pronto, o resto é encanamento. Voltou 401? A chave está errada ou foi revogada. Voltou 402? A conta está no gratuito, ou a cota do mês acabou.

Quer só ver quais ferramentas existem, sem gastar nada? tools/list responde sem chave — é de propósito, para você inspecionar o servidor antes de configurar qualquer coisa.

Referência

As quatro ferramentas

Quanto mais específico o contexto, menos genérica a resposta. “Cliente achou caro” devolve conselho de livro; “proposta de R$ 3.500/mês, ele compara com um freelancer, já fizemos uma call” devolve a pergunta certa para aquele cliente.

O que volta

Sempre o mesmo formato, nas quatro ferramentas. O campo que você manda para o cliente é message; os outros são para o seu agente decidir o que fazer depois.

{
  "message":        "o que enviar, palavra por palavra",
  "interpretation": "o que a frase dele provavelmente esconde",
  "strategy":       "por que esta mensagem e não outra",
  "nextStep":       "o que fazer com a resposta dele",
  "warnings":       ["o que não dizer", "..."]
}

Leia os warnings antes de deixar o seu agente improvisar em cima do texto. Eles são a parte que evita a besteira cara — o desconto oferecido antes da hora, o “mas o nosso é melhor” que transforma uma conversa em discussão.

A parte que ninguém faz

Mande o lead_id. É o que separa um follow-up de um incômodo.

Sem ele, cada chamada é um estranho: no quarto follow-up o seu robô recebe o mesmo ângulo da primeira mensagem — porque, do nosso lado, era a primeira. Quem percebe é o lead, e o que ele faz é bloquear.

Passe o id que você já tem — o do CRM, o telefone, um uuid. Ele é opaco para nós; quem decide o que é “o mesmo lead” é você, e isso está certo: só você sabe se dois telefones são a mesma pessoa.

Guardamos resumo, não arquivo: um recorte da situação e a mensagem sugerida, as doze últimas. Quando o negócio fecha ou morre, chame esquecer_lead — não gasta mensagem e apaga tudo daquele lead.

Cota, limite e preço

• Cada chamada bem-sucedida vale uma mensagem da sua cota, a mesma do chat. Chamada que falha não desconta.
• esquecer_lead e tools/list não gastam nada — não chamam o modelo.
• A cota renova na data da sua assinatura, não no dia 1º. Assinou dia 15, renova dia 15.
• É dos planos pagos. Um robô faz centenas de chamadas por dia; no gratuito ele gastaria as mensagens em segundos — e aí o guia não serviria para nada.
• Até cinco chaves vivas por conta. Revogar libera vaga, e o que estiver usando a chave revogada para de funcionar na hora.

Quando dá errado

A última linha é de propósito. Erro de JSON-RPC quer dizer “a chamada não aconteceu”; isError quer dizer “a ferramenta rodou e deu ruim”. Seu agente pode tentar de novo na segunda sem derrubar a conversa inteira.

Para quem já conhece MCP

• Falamos a revisão 2026-07-28 e também as anteriores (2025-11-25, 2025-06-18, 2025-03-26).
• Sem sessão. A partir da 2026-07-28 o MCP é stateless: não há handshake, Mcp-Session-Id nem stream de GET. Na prática é um POST com JSON-RPC 2.0. O initialize continua respondido, para cliente antigo conectar.
• Chave no cabeçalho, não OAuth. A especificação recomenda OAuth 2.1 e permite, com todas as letras, que cliente e servidor combinem a própria estratégia. Nenhum n8n faz fluxo de consentimento com PKCE; uma chave é o que essas ferramentas sabem usar.