Símbolo da AmivuSímbolo da AmivuDevelopers

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.

Terminal
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.

A mensagem sai de verdade
Mandar mensagem ao cliente entrega pelo canal da conversa, com chave de produção, e não volta. Se o assistente não precisa falar com o cliente, não dê 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.