Permissões e segurança da chave usada pelo servidor MCP

Como emitir a chave de API para o servidor MCP, quais permissões marcar de acordo com o que você quer que seu assistente faça e como revogá-la.

Aug 19, 2026

Veja este passo no vídeo · MCP: que uma IA opere o Omnifox

O servidor MCP se autentica com uma chave de API pessoal da Omnifox, enviada como Authorization: Bearer em cada chamada. Como o assistente de IA decide sozinho qual ferramenta usar, é recomendável que essa chave tenha apenas as permissões de que você realmente precisa.

Criar a chave

  1. Abra Configurações → Desenvolvimento → API Keys.
  2. Clique em Nova chave.
  3. Dê um nome que a identifique, por exemplo Servidor MCP - Claude.
  4. Escolha o espaço de trabalho. É obrigatório e não pode ficar em branco: a chave só vai enxergar os dados desse espaço.
  5. Marque os scopes correspondentes (veja a tabela abaixo). Se você não marcar nenhum, a chave fica com acesso total.
  6. Opcionalmente, defina uma data de expiração.
  7. Salve e copie a chave nesse momento: é a única vez que ela é exibida por completo.

Qual scope cada grupo de ferramentas precisa

O que você quer que o assistente faça Scopes a marcar
Ler contatos, buscá-los, ver os canais deles read:contacts
Criar, atualizar, etiquetar ou mesclar contatos write:contacts
Ler conversas, mensagens e notas internas read:messages
Enviar mensagens, notas, atribuir, encerrar ou adiar write:messages
Ver os canais conectados e os modelos read:channels
Ler oportunidades, empresas e funis read:crm
Criar ou mover registros do CRM write:crm
Ler projetos e quadros read:projects
Escrever em projetos e quadros write:projects
Registrar ou listar webhooks manage:webhooks
Tudo o que está acima admin

Se você deixar a lista vazia, a chave equivale a acesso total. É cômodo para testar, mas para o uso diário marque só o que for necessário.

Combinação recomendada para começar

Para um assistente que atende a caixa de entrada, mas não mexe em faturamento nem em configurações: read:contacts, write:contacts, read:messages, write:messages e read:channels.

Revogar o acesso

Em API Keys, exclua a chave. O servidor MCP vai parar de funcionar na chamada seguinte, com um 401. Não é preciso mexer na configuração do cliente de IA para cortar o acesso.

Dicas

  • Uma chave por integração. Se você compartilhar a mesma chave com o n8n, um script próprio e o servidor MCP, revogá-la quebra todos.
  • Defina data de expiração nas chaves que você emitir para testes.
  • As ferramentas destrutivas existem: delete_contact, delete_tag e merge_contacts não podem ser desfeitas. Se você não quer que seu assistente possa excluir contatos, não dê a ele o write:contacts.

Se algo não funcionar

  • 401: a chave foi revogada, expirou ou foi copiada errado.
  • 403: falta à chave o scope daquele módulo, ou o plano não inclui o módulo.
  • 404 em um registro que existe: os ids são por espaço de trabalho; a chave está presa a outro espaço.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp