Como deixar o Claude ou o ChatGPT consultar seu CRM (plano Business)
Para que serve: perguntar ao Claude, ao ChatGPT ou ao Cursor sobre os seus contatos ("o que temos da empresa X?", "quem é o responsável pelo João?") e receber a resposta com os dados do CRM.
O que você precisa
- Plano: Business. Nos outros planos, a tela mostra "Operar o CRM por IA está disponível no plano Business."
- Permissão: gerente e vendedor. A IA enxerga só o que o seu usuário já enxerga no CRM. O gerente também vê e revoga os tokens de toda a equipe.
- Antes: gerente precisa estar com a verificação em duas etapas ligada para criar token (Como proteger sua conta com 2FA).
O que a IA consegue fazer hoje
O CRM oferece duas ferramentas para a IA, as duas só de leitura:
- Buscar contatos: procura contatos por nome, telefone, e-mail ou empresa (até 20 por busca).
- Ver contato: mostra o cadastro do contato, o responsável, as etiquetas, os negócios e a lista de conversas (status, data da última mensagem e quantas estão sem ler).
A IA não cria nem edita nada, não lê o texto das conversas e não envia mensagens. A tela de token mostra as opções CRM: escrever, Inbox: ler e Inbox: enviar, mas hoje nenhuma ferramenta usa essas permissões.
Passo a passo
Claude ou ChatGPT (conector com login)
- No Claude ou no ChatGPT, adicione um conector personalizado (MCP) com o endereço
https://rumocrm.com/api/mcp. - Na hora de conectar, abre uma página do Rumo CRM. Se pedir, entre com o seu usuário. A página "Conectar ... ao Rumo CRM" lista as permissões pedidas. Clique em Permitir acesso.
- Pergunte algo como "busque no meu CRM o contato da empresa Exemplo". A IA usa Buscar contatos e depois Ver contato.
Cursor e outras ferramentas que pedem token
- Vá em Configurações → Operação → Conectar minha IA.
Atalho Conectar minha IA - No card Criar token, dê um Nome (ex.: "Claude no meu notebook"). Em O que essa IA pode fazer, deixe marcado CRM: ler. Em Validade, escolha 30 dias, 90 dias ou 1 ano. Clique em Criar token.
Criar token para a IA - Aparece Copie o token agora. Clique em Copiar e guarde: ele só aparece essa vez. Clique em Já copiei, fechar.
- Na ferramenta, configure o servidor MCP com o endereço
https://rumocrm.com/api/mcpe o cabeçalhoAuthorization: Bearer <seu token>. - Para cortar o acesso, encontre o token em Meus tokens e clique em Revogar. A IA perde o acesso na hora. O gerente pode clicar em Ver da organização para ver e revogar os tokens de todos.
Lista de tokens e Revogar
Se algo der errado
| O que aparece | Por que acontece | O que fazer |
|---|---|---|
| "2FA obrigatório para esta ação" | Você é gerente e não ligou a verificação em duas etapas | Ative o 2FA em Segurança e 2FA e tente de novo |
| "O MCP exige o plano Business" | A conta não está no plano Business | Mude de plano (Como mudar de plano) |
| "Selecione uma organizacao no Rumo CRM antes de conectar" | Você participa de mais de uma conta e nenhuma está escolhida | Entre no CRM, escolha a conta e conecte de novo |
| A IA diz que não tem ferramentas | O token ou a permissão não incluem CRM: ler | Crie outro token com CRM: ler |
| A IA parou de responder com dados do CRM | O token venceu ou foi revogado | Crie um token novo ou conecte de novo |
| A IA diz que criou um negócio ou mandou mensagem | Ela não tem essas ferramentas. A frase é invenção da IA | Confira no CRM. Hoje a IA só consulta contatos |
O que este recurso não faz
- Não cria, edita nem apaga contatos, negócios ou tarefas.
- Não lê o conteúdo das conversas nem envia mensagens.
- Não consulta funil, atividades ou relatórios. Só contatos.
- O token não pode ser visto de novo depois de fechado. Se perder, revogue e crie outro.