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.
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
- Abra Configurações → Desenvolvimento → API Keys.
- Clique em Nova chave.
- Dê um nome que a identifique, por exemplo Servidor MCP - Claude.
- 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.
- Marque os scopes correspondentes (veja a tabela abaixo). Se você não marcar nenhum, a chave fica com acesso total.
- Opcionalmente, defina uma data de expiração.
- 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_tagemerge_contactsnão podem ser desfeitas. Se você não quer que seu assistente possa excluir contatos, não dê a ele owrite: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.404em um registro que existe: os ids são por espaço de trabalho; a chave está presa a outro espaço.
Artigos relacionados
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.