Servidor MCP
Conecte o seu assistente à conta pelo MCP: ele lê e configura com a chave de API, no alcance dela.
O servidor MCP da Amivu, em https://mcp.amivu.com.br, deixa um assistente de IA ler e mudar a sua conta conversando: buscar contatos, abrir e encerrar conversas, deixar nota, criar etiquetas e campos, montar automações, ensinar a Ami e cadastrar webhooks. Você pede em português e ele escolhe a ferramenta.
Como ele funciona
Cada ferramenta é uma rota da API pública, rodada com a chave que o assistente mandou. Por isso vale tudo o que vale numa chamada da API: o alcance da chave, o limite por organização, a validação do corpo e o isolamento entre organizações. Uma ferramenta não alcança nada que a chave não alcance.
Toda chamada aparece no registro de chamadas do painel, em Configurações → Desenvolvedores, com o nome do assistente seguido de (via MCP).
Conectar
Crie uma chave para o assistente
No painel, em Configurações → Desenvolvedores, crie uma chave só para ele, com os alcances que a tarefa pede. Para experimentar, use o ambiente Sandbox (ver Ambientes): nada do que ele fizer chega a um cliente de verdade. A exceção é a configuração da conta (canais, automações e a Ami), que é uma só para os dois ambientes: com a chave de sandbox ele a lê, e para mudá-la precisa de uma chave de produção.
export AMIVU_API_KEY="amivu_test_..."
Adicione o servidor
O endereço é https://mcp.amivu.com.br, por HTTP, e a chave vai no cabeçalho Authorization: Bearer, como na API. No Cursor, a configuração mora em .cursor/mcp.json. Em outro cliente, procure a opção de servidor remoto por HTTP com cabeçalho próprio.
claude mcp add --transport http amivu https://mcp.amivu.com.br \
--header "Authorization: Bearer $AMIVU_API_KEY"Confira a conexão
Uma chave errada, revogada ou vencida aparece já ao conectar, e não na primeira pergunta. Depois, peça algo simples, como “quais etiquetas a conta tem?”.
$ claude
> /mcp
amivu · connected
O que ele faz
A lista completa, com a descrição de cada ferramenta e o alcance que ela exige, chega ao assistente ao conectar. Por recurso:
- Contatos — buscar, ver, criar, atualizar, apagar, pôr e tirar etiqueta (
contacts:read,contacts:write). - Conversas — listar, ver, abrir, mudar a situação, encerrar, reabrir, atribuir a uma pessoa ou time e tirar o responsável (
conversations:read,conversations:write); pôr e tirar etiqueta (tags:write). - Mensagens e notas — ler as mensagens e as notas internas, escrever nota e mandar mensagem de texto ao cliente ou a um grupo do WhatsApp, marcando todos do grupo (
mention_all) ou só alguns números (mentions) (messages:read,messages:write,notes:read,notes:write; ver Marcar pessoas no grupo). - Equipe e catálogo — listar pessoas, times, etiquetas e campos personalizados; criar time, etiqueta e campo; renomear, mudar a cor e apagar etiqueta (
users:read,teams:read,teams:write,tags:read,tags:write,custom_fields:read,custom_fields:write). - Canais — listar, ver, renomear e ligar ou desligar a Ami respondendo sozinha no canal (
channels:read,channels:write); listar os grupos de um WhatsApp pareado por QR Code (conversations:read). - Automações — listar, ver, criar, trocar o fluxo, ligar, desligar e apagar, no mesmo formato do construtor do painel (
automations:read,automations:write; ver Automações). - Ami — ver e mudar a configuração, e criar, mudar e apagar papéis e o acervo de perguntas e respostas (
ami:read,ami:write; ver A Ami). - Formulários — listar, ver as perguntas de um e ler as respostas dele (
forms:read; ver Formulários). - Webhooks — listar, criar, atualizar e apagar (
webhooks:read,webhooks:write).
A ferramenta que a chave não alcança responde com insufficient_scope e o alcance que falta. Quem resolve é você: criando a chave de novo com ele.
Escrita com confirmação
Cada ferramenta diz ao cliente o que faz: se só lê, se apaga ou muda o que existe, e se fala com alguém de fora. Os clientes usam isso para pedir a sua confirmação antes de escrever — mas quem decide é o cliente, e muitos deixam você liberar uma ferramenta de vez.
messages:write à chave dele.Mudar canal, automação ou a Ami também vale na hora para os clientes de verdade. Por isso a automação que o assistente cria nasce desligada, a menos que ele peça ligada: abra no painel, confira o fluxo e ligue você.
Quando a rota recusa um argumento, o assistente recebe a mensagem dela com o nome do argumento, e corrige a chamada sozinho na maior parte das vezes.
O que ele ainda não faz
- Login pelo navegador (OAuth). O servidor pede a chave no cabeçalho. Por isso, clientes que só conectam servidor com login, como os conectores do app do Claude, ainda não o adicionam.
- Mídia e modelo aprovado. A mensagem pelo MCP é só de texto: subir anexo é um envio de arquivo, que o protocolo não carrega, e modelo aprovado ainda não sai pela API.
- Conectar canal. Parear o WhatsApp e entrar no Instagram passam pelo login no provedor, e ficam no painel.
- Incluir quem já tem a etiqueta. A automação por etiqueta criada por ele vale para quem ganhar a etiqueta dali em diante; pôr na sequência quem já a tem é pelo painel.
- Escolher o modelo da Ami. Ele depende do plano e do crédito da conta.
Escrevemos sobre operação de atendimento, canais e IA no blog da Amivu.