MCP: a conta num app de agentes de IA

O BoaVoz tem um servidor MCP, em https://www.boavoz.com/mcp, para usar a conta num app de agentes de IA (como o agentes.chat) ou em qualquer cliente de MCP. As ferramentas são as operações da API: ler as conversas, o histórico, os contatos e os leads, enviar mensagem, pausar e retomar a IA numa conversa, mudar etiquetas e datas do contato, mandar campanhas, cuidar das fontes e do aviso do momento, e, com as permissões certas, criar clientes e chatbots e ver o uso e o crédito. A primeira ferramenta é o whoami, que diz a conta, as permissões e os chatbots que a conexão alcança. É do pacote Integrações, como a API (no teste grátis, enquanto houver respostas de teste, também funciona).

Há duas formas de conectar. Pelo login do BoaVoz, com um clique no app: ele abre a tela "quer usar a sua conta do BoaVoz", você entra, escolhe o escopo (a conta inteira, um cliente ou alguns chatbots) e as permissões, e autoriza. Quem autoriza é o dono ou um administrador, com o segundo fator; a permissão de cobrança vem desligada, e só o dono pode dar. Quem ainda não tem conta entra ou cria a conta pela mesma tela e volta para ela: a conta nova começa no teste grátis, cadastra o app autenticador ali mesmo e conecta o app (os chatbots se montam depois, no painel); enquanto o BoaVoz abre por convite, quem não tem o convite entra na lista de espera. Ou pela chave da API, no cabeçalho Authorization, para o cliente de MCP que não faz login. A conexão pelo login aparece em Configurações → Ações, webhooks e API, na aba Chaves de API, como "App conectado", com o escopo, as permissões, para onde o app volta e o último uso; no "…", "Desconectar o app" tira o acesso na hora (e o dono recebe o alerta quando um app é conectado). Quem sai da conta, ou deixa de ser dono ou administrador, leva as conexões que autorizou junto. As ferramentas que enviam, apagam e cobram vêm marcadas para o app pedir a aprovação de uma pessoa. O passo a passo fica na documentação, em "MCP para agentes de IA".

Ainda com dúvida? Pergunte ao assistente da BoaVoz no WhatsApp (o número fica em Meu perfil, no painel) ou busque outro assunto na Central de ajuda.