Conectar assistentes de IA (MCP)
O MCP (Model Context Protocol) permite que um assistente de IA, como Claude, Cursor ou VS Code, consulte e altere dados da sua conta no DeepLead. O assistente se identifica com uma chave criada só para isso.
# Onde fica
- No seletor de módulo, no topo, escolha CRM.
- No rodapé do menu, clique em Configurações.
- Na lista de seções, clique em MCP.
# Quem pode usar
Só o perfil Admin vê a seção MCP. Para os outros perfis ela não aparece na lista.
# Conectar um assistente
- No bloco API Keys MCP, clique em Nova Chave.
- Em Nome da chave, identifique o uso (por exemplo
Claude Desktop) e clique em Criar chave. - Copie a chave com o botão ao lado dela. A tela avisa: “Copie esta chave agora. Ela não será exibida novamente.”. Depois clique em Fechar.
- No bloco Configuração (mcp.json), clique no botão de copiar. Aparece “Configuração copiada!”.
- Cole o texto no arquivo
mcp.jsondo seu assistente. - No texto colado, troque
<SUA_API_KEY_AQUI>pela chave que você copiou no passo 3. - Peça ao assistente para chamar
get_help. Ele devolve a lista de ações disponíveis.
# O que o assistente consegue fazer
| Área | Consulta | Cria e altera |
|---|---|---|
| Contatos | Listar, ver um contato, exportar | Criar e atualizar contatos |
| Tags | Listar | Criar tag, adicionar e remover de um contato ou de vários de uma vez |
| Listas | Listar | Criar, atualizar e excluir (os contatos da lista não são excluídos) |
| Segmentos | Listar | Criar, atualizar e excluir |
| Pipeline | Etapas, negócios, histórico de etapas, usuários da conta | Criar, atualizar, mover e excluir negócios, um a um ou vários de uma vez |
| Campanhas e templates de e-mail | Listar e ver | Não |
| Conversas, mensagens de uma conversa e templates de mensagem | Não | |
| Automações e fluxos de chatbot | Listar | Não |
| Formulários e Landing Pages | Listar | Não |
| Dashboard | Métricas | Não |
# Gerenciar as chaves
A lista API Keys MCP mostra Nome, Chave (o começo dela), Status (Ativa ou Inativa), Criada e Último uso.
- Desativar / Ativar (ícone de chave alternadora): a chave inativa é recusada na hora. Aparece “Chave desativada” ou “Chave ativada”.
- Excluir (lixeira): pede confirmação com o aviso “Esta ação é irreversível.”. Clique em Excluir. Aparece “Chave excluída”.
Crie uma chave para cada assistente ou pessoa. Assim você desliga um acesso sem derrubar os outros, e a coluna Último uso mostra qual deles está em uso.
# Regras e limites
- O assistente age com a chave, não com o seu usuário. Quem tem a chave alcança os dados da conta sem precisar de login, inclusive para excluir listas, segmentos e negócios.
- A chave fica escrita no arquivo de configuração do assistente. Trate esse arquivo como uma senha e não o compartilhe.
- A chave do MCP só serve para o MCP. Uma chave criada em Integrações (API / Webhooks) não é aceita pelo assistente.
- As chaves do MCP também aparecem na lista Chaves de API da seção Integrações (API / Webhooks). Removê-las por lá tem o mesmo efeito de excluir aqui.
- A chave completa aparece uma única vez. Perdeu, crie outra e exclua a antiga.
# Problemas comuns
| O que acontece | O que fazer |
|---|---|
| A seção MCP não aparece | Confira se o módulo aberto é o CRM e se o seu perfil é Admin. |
| O assistente recebe erro de autenticação | A chave está Inativa, foi excluída, foi colada com erro ou é uma chave de Integrações. Crie uma chave nova na seção MCP. |
| “Erro ao criar chave” | Tente de novo. Se continuar, fale com o suporte. |
| “Nenhuma chave MCP criada” | Ainda não há chave. Clique em Nova Chave. |