API keys e acesso de IA (MCP)

O que são API keys

Em Configurações → API keys, o admin do workspace cria chaves pra conectar sistemas externos ao CRM (n8n, formulários do site, automações, IA).

Cada chave pertence a um único workspace: só enxerga os dados daquele workspace. O token completo aparece uma única vez, na criação; depois, só o prefixo. Chave vazada? Revogue na hora (ícone de lixeira) e crie outra.

Permissões da chave (escopos de IA)

A mesma chave tem dois usos, com regras diferentes:

• API REST tradicional (n8n, site, automações): toda chave válida tem leitura e escrita completas no workspace. Trate qualquer chave como uma senha poderosa.
• Acesso de IA (MCP): por padrão a IA só lê. Alterar dados via IA é permissão extra, marcada chave a chave na criação:
• Escrita via IA (MCP) — atualizar o perfil da empresa (o cérebro da IA), etiquetas de conversa, estágios do funil (excluir estágio só quando está vazio, igual na tela de funis) e criar campos personalizados de oportunidade, empresa ou contato. Editar ou excluir campo continua sendo na tela de Campos Personalizados.
• Importação via IA (MCP) — importar contatos e empresas em lote, inclusive campos personalizados de contato.
• Oportunidades via IA (MCP) — criar e editar oportunidades, mover de etapa, marcar ganho/perda, adicionar notas e criar, reagendar ou concluir atividades. Toda ação aparece na linha do tempo da oportunidade identificada pelo nome da chave.

Chaves criadas antes desses escopos não têm nenhum deles: via MCP elas só leem (na API REST seguem como sempre). Crie uma chave separada por uso e marque só o que aquele uso precisa.

O que é o acesso de IA (MCP)

MCP é o protocolo que permite a assistentes de IA (como o Claude) operarem o CRM: a IA se conecta em https://crmdojordao.com.br/api/mcp usando uma API key do workspace e ganha ferramentas pra consultar funil, contatos, oportunidades, o perfil da empresa e o status de ativação da conta.

Com os escopos acima marcados, ela também preenche o perfil da empresa, organiza o funil, cria etiquetas, cria campos personalizados e importa contatos.

Limites de proteção:

• A IA só acessa o workspace da chave.
• Em conta suspensa, a IA só lê.
• Toda alteração de oportunidade feita por IA fica identificada na linha do tempo pelo nome da chave.
• Há limite de requisições por minuto por chave.