Pular para o conteúdo
Nesta página
Integrações

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

  1. No seletor de módulo, no topo, escolha CRM.
  2. No rodapé do menu, clique em Configurações.
  3. 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

  1. No bloco API Keys MCP, clique em Nova Chave.
  2. Em Nome da chave, identifique o uso (por exemplo Claude Desktop) e clique em Criar chave.
  3. 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.
  4. No bloco Configuração (mcp.json), clique no botão de copiar. Aparece “Configuração copiada!”.
  5. Cole o texto no arquivo mcp.json do seu assistente.
  6. No texto colado, troque <SUA_API_KEY_AQUI> pela chave que você copiou no passo 3.
  7. 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
WhatsApp 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.

# Veja também