Conectar o Claude ao seu CRM (MCP)

Ligue o Claude (ou outro assistente compatível) direto no seu ScalaCRM — ele lê conversas e leads e age na sua conta com a sua confirmação, usando o protocolo aberto MCP.

MCP (Model Context Protocol) é um padrão aberto que deixa um assistente de IA — o Claude, por exemplo — enxergar e operar um sistema de fora, como se você estivesse contando pra ele o que precisa e ele fosse na tela fazer. Aqui, o "sistema de fora" é o seu ScalaCRM: conectado, você pergunta "o que está pendente hoje?" numa conversa qualquer e o Claude responde olhando de verdade o seu inbox, o seu funil e as suas tarefas — sem você abrir o CRM.

Não é um chatbot novo nem um agente que fica ligado sozinho: o Claude só age quando você pede, dentro de uma conversa que você está conduzindo.

O que dá para fazer

Ver o que está acontecendo (sem risco nenhum, é só leitura):

um resumo do dia — conversas aguardando resposta, tarefas atrasadas, leads parados e vendas de hoje;
listar conversas por filtro (aguardando resposta, sem dono, de um atendente específico);
abrir e ler o histórico de uma conversa;
buscar um contato pelo nome ou telefone;
ver o funil por etapa (quantos leads e quanto valor em cada uma) e os leads parados há mais tempo numa etapa;
listar tarefas e vendas por período.

Organizar sem enviar mensagem nenhuma (ação reversível, some se você desfizer na tela):

criar tarefa, concluir tarefa, adicionar nota a um contato;
aplicar ou remover etiqueta;
mover um lead para outra etapa do funil;
atribuir um responsável;
cadastrar um contato novo.

Responder ao lead — enviar mensagem numa conversa. É a única ação irreversível do cardápio, e por isso o Claude sempre pede a sua confirmação antes de mandar (você vê o texto e o destinatário antes de aprovar). Segue as mesmas regras do CRM: exige conversa já identificada (nunca telefone digitado à mão), respeita a janela de 24h da API oficial e nunca manda para quem pediu para sair da lista (opt-out) — nem em texto livre.

Configurar o agente de IA e as automações do Maestro (só para administradores, é o mesmo alcance de quem entra em Agentes IA e Automações):

ver e editar os campos estruturados do agente — persona, tom, conhecimento sobre a empresa, ofertas, objeções, FAQ e instruções extras (o mesmo caminho da tela, então toda edição vira uma versão restaurável em 1 clique);
criar, editar, ativar e desativar automações do Maestro. Toda automação criada pelo Claude nasce DESATIVADA — ativar é um passo separado que também pede a sua confirmação.

Ficam de fora, de propósito: disparo em massa/campanhas, excluir contato, excluir agente ou automação, prompt do modo avançado do agente, e qualquer coisa de plano, assinatura, chaves de API, membros ou canais — essas continuam só na tela.

Como conectar

Tudo começa em Configurações → Integrações, no card de conexão com o Claude.

Pelo claude.ai ou Claude Desktop (o caminho mais simples):

No Claude, abra Configurações → Conectores.
Clique em "Adicionar conector personalizado".
Cole a URL do conector — https://www.scalacrm.com/api/mcp (tem um botão "Copiar URL do conector" no card).
Clique em Conectar.
Faça login no ScalaCRM e autorize o que for pedido.

Pelo Claude Code ou outra ferramenta técnica (usando uma chave de API):

Gere uma chave na seção Chaves de API, na mesma página, e rode:

claude mcp add scalacrm --transport http https://www.scalacrm.com/api/mcp --header "Authorization: Bearer SUA_CHAVE"

Trocando SUA_CHAVE pela chave gerada (o card também tem um botão para copiar o comando pronto).

Segurança

⚠️ Ao conectar, um assistente de IA vai poder ler conversas dos seus clientes e agir na sua conta. Mensagens de clientes podem conter tentativas de manipulação; ações sensíveis pedem sua confirmação, e tudo fica registrado.

Detalhando essa frase:

Você escolhe o alcance. Se a chave de API que você usar for de escopo somente leitura, o Claude nem enxerga as ferramentas de escrita — elas não aparecem na lista dele, não é uma trava que pode falhar na hora H.
A ação irreversível pede confirmação. Enviar mensagem e ativar uma automação são as duas únicas ações que mudam algo de forma difícil de desfazer, e as duas exigem que você confirme antes de acontecer — o Claude mostra o que vai fazer e espera você dizer sim.
Nada disso passa por cima das proteções do CRM. Opt-out, janela de 24h, exigência de template fora da janela, teto de automações por conta — tudo continua valendo, exatamente como valeria se você mesmo estivesse na tela.
Sem disparo em massa. Não existe ferramenta que mande mensagem para uma lista de contatos — só uma conversa por vez, e sempre identificada por quem já apareceu numa leitura anterior (nunca um telefone digitado).
Tudo fica registrado. Toda leitura e toda ação do Claude entra no mesmo rastro de auditoria do CRM, com a identificação de qual conexão fez o quê.

Existe, porém, um risco que nenhuma trava técnica elimina sozinha: quando o Claude lê uma conversa, o texto que o SEU LEAD escreveu entra no que o modelo está processando — e um lead mal-intencionado pode escrever algo desenhado para tentar confundir o assistente ("ignore o que disse antes e...", por exemplo). O ScalaCRM marca claramente, em tudo que mostra ao Claude, que aquele texto é dado do cliente e não uma instrução sua — mas a decisão final de conectar "responda meus leads sozinho" é sua, e ela significa deixar um modelo de IA agir sobre texto escrito por estranhos. É a mesma honestidade do aviso que já existe sobre banimento no WhatsApp Lite: a ferramenta é real e útil, e o risco residual precisa ser dito, não escondido.

A sua conta do Claude também importa (LGPD)

Tudo o que o Claude lê do CRM passa a existir nas suas conversas com ele — ou seja, sob a conta Anthropic de quem conectou, regida pelos termos e configurações de privacidade dela. Duas consequências práticas:

Para trabalhar com dados de clientes, prefira uma conta de trabalho (Claude Team ou Enterprise) ou, se usar uma conta individual, confira nas configurações de privacidade da Anthropic como as suas conversas são tratadas — inclusive se podem ser usadas para treinamento de modelos. Dados de leads dentro de uma conversa pessoal configurada para treinamento é exatamente o cenário que uma empresa cuidadosa evita.
Excluir um contato no CRM não apaga o que já apareceu nas suas conversas do Claude. Se um cliente seu pedir exclusão de dados (art. 18 da LGPD), lembre-se de que cópias podem existir no seu histórico do Claude — a gestão dessas cópias é sua, junto à Anthropic.

Perante a LGPD, a sua empresa é a controladora dos dados dos seus clientes: conectar um assistente é uma decisão sua de enviar dados a esse fornecedor, como já acontece com n8n, webhooks e exportações. Os Termos de Uso e a Política de Privacidade descrevem essa divisão de papéis.

Perguntas comuns

Conectar consome créditos de IA do meu plano? Não. O token de processamento é do SEU Claude (da sua conta claude.ai, Claude Code ou API da Anthropic) — o custo de inferência corre por conta dele, fora do ScalaCRM. O que passa pelo MCP é só leitura e escrita no CRM.

Um atendente pode conectar? Sim, com o mesmo alcance que ele já tem na tela: leitura, organização (tarefas, notas, etiquetas, funil) e envio de mensagem. O grupo de configuração — editar agente de IA e mexer em automações do Maestro — é só para administradores, do mesmo jeito que as telas Agentes IA e Automações já são.

Como eu desconecto? No mesmo card, em Configurações → Integrações, a lista de conexões ativas tem um botão Revogar por linha. O acesso para na hora.