Como usar a WavUps CRM pelo Claude, ChatGPT e Gemini (MCP)
Conecte o Claude, o ChatGPT, o Gemini, o Claude Code ou o Cursor à WavUps CRM pelo MCP: planos, login ou chave MCP, permissões, aprovações, segurança e solução de problemas.
O MCP da WavUps CRM deixa a sua IA (Claude, ChatGPT, Gemini e outras) consultar e atualizar o CRM por você, direto do chat. No Claude, no ChatGPT e no Gemini, adicione um conector com a URL https://crm.wavups.com/api/mcp e autorize com o seu login. Em ferramentas como Claude Code, Cursor, VS Code e Gemini CLI, gere uma chave MCP no menu MCP. A IA age como você, com as suas permissões, e está disponível a partir do plano Equipe.
MCP (Model Context Protocol) é o padrão aberto que as IAs usam para conversar com outros sistemas. Com o MCP da WavUps CRM, você pede no chat da sua IA, por exemplo, "crie um lead para a Maria e marque uma reunião amanhã às 10h", e ela faz isso na sua conta, sem você abrir a plataforma.
- A IA age como você: vê e altera só o que você pode ver e alterar na plataforma (seu papel, os leads que você enxerga, os projetos de que participa, os números de WhatsApp a que tem acesso).
- Ela tem as mesmas ferramentas do Assistente de IA da plataforma: leads, conversas, funis e negócios, calendário, projetos e tarefas, produtos, faturas, campanhas, automações, relatórios e a Central de ajuda. Veja a lista em O que a IA pode fazer pelo MCP.
- Quem processa os pedidos é a IA que você já usa, por isso o MCP quase não consome o uso de IA da sua conta.
- O MCP faz parte dos planos Equipe, Pro e Escala. O plano Base não tem MCP, API nem webhook. Veja Meu plano.
- Cada membro conecta a IA dele, com as permissões que já tem na conta. Os administradores podem limitar o MCP a Só administradores ou desligar (Ninguém).
- Contas de demonstração não usam o MCP.
- 1
Passo 1: Abra o menu MCP
No menu lateral, em Configurações, clique em MCP 1. No topo fica a URL do servidor MCP 2, com o botão Copiar 3, e o passo a passo de cada IA 4.
| Seção da tela | Para que serve |
|---|---|
| Conectar sua IA | A URL do servidor e o passo a passo de Claude, ChatGPT, Claude Code, Gemini CLI, Cursor e VS Code. |
| Quem pode usar o MCP | Só administradores veem: Todos os membros, Só administradores ou Ninguém. |
| Aplicativos conectados | As IAs autorizadas pelo login (Claude, ChatGPT, Gemini). Desconectar corta o acesso na hora. |
| Chaves MCP | As chaves das ferramentas que usam cabeçalho (Claude Code, Cursor, VS Code, Gemini CLI). |
| Uso | Quantas ferramentas as IAs chamaram hoje, nos últimos 7 e nos últimos 30 dias. |
| O que a IA pode fazer | As ferramentas que a sua IA recebe, de acordo com o seu papel. |
Claude, ChatGPT e o app do Gemini conectam pelo login da WavUps CRM (OAuth), sem chave. O caminho muda um pouco em cada IA; os passos detalhados estão em Claude, ChatGPT e Gemini.
- 2
Passo 2: Adicione um conector com a URL
Na sua IA, crie um conector (ou app) personalizado com o nome WavUps CRM e a URL
https://crm.wavups.com/api/mcp. A autenticação é OAuth: não preencha Client ID nem segredo, a IA se registra sozinha. - 3
Passo 3: Autorize com o seu login
Abre a tela Conectar ... à WavUps CRM 1. Entre com o seu login, escolha a Conta 2 e decida se a IA pode Permitir criar e alterar dados 3 ou só consultar. Claude e ChatGPT aparecem com o selo Aplicativo verificado. Clique em Autorizar acesso 4.
- 4
Passo 4: Use no chat
Numa conversa, ative o conector WavUps CRM e faça o pedido, como "quais negócios estão parados há mais de 7 dias no funil Vendas?". A conexão aparece em Aplicativos conectados, no menu MCP.
Ferramentas de desenvolvimento e de terminal enviam uma chave MCP no cabeçalho Authorization. Cada chave é pessoal: ela age como o membro que a criou.
- 5
Passo 5: Clique em Nova chave
No menu MCP, na seção Chaves MCP, clique em Nova chave.
- 6
Passo 6: Preencha e gere a chave
Dê um Nome da chave 1 que lembre onde ela vai ser usada (por exemplo, "Gemini CLI do notebook"), escolha a Validade 2 (30 dias, 90 dias, 1 ano ou sem validade), ligue Somente leitura 3 se a IA só vai consultar e clique em Gerar chave 4.
- 7
Passo 7: Copie a chave
A chave aparece uma vez só, com a configuração pronta. Copie e guarde como uma senha. Depois da validade, a chave para de funcionar e aparece como Vencida; gere outra.
- 8
Passo 8: Cole a configuração na ferramenta
Em Conectar sua IA, escolha a ferramenta 1 e copie a configuração 2, trocando
SUA_CHAVE_MCPpela sua chave. No Claude Code, por exemplo:claude mcp add --transport http wavups-crm https://crm.wavups.com/api/mcp --header "Authorization: Bearer SUA_CHAVE_MCP".
A chave age como você
Consultas e alterações comuns (criar lead, mover negócio, criar tarefa) acontecem na hora, e a sua IA normalmente pede a sua permissão antes de chamar cada ferramenta.
Ações sensíveis, como enviar mensagens de WhatsApp, cobrar pelo gateway, dar baixa numa fatura, criar uma campanha, criar ou ativar uma automação, juntar leads duplicados ou excluir uma etapa, e as alterações em massa grandes (mais de 50 leads) só rodam depois que você aprovar na WavUps CRM. A IA mostra a prévia e um link; abra o link (o pedido também chega no sino de notificações), confira a tela Aprovar ação da IA e clique em Confirmar e executar ou Rejeitar. O pedido vale 30 minutos.
Por que a aprovação é na plataforma
Algumas alterações podem ser desfeitas em até 24 horas: peça para a IA "desfazer a última alteração".
- Aplicativos conectados: clique na lixeira e em Desconectar para cortar o acesso na hora. Para usar de novo, autorize outra vez.
- Chaves MCP: clique na lixeira e em Revogar chave. A IA que usa a chave perde o acesso na hora.
- Administradores veem e cortam as chaves e conexões de toda a conta; os demais membros, só as próprias.
- Quando um membro conecta uma IA ou cria uma chave, os administradores da conta recebem um aviso nas notificações.
- Cada conexão pelo login dura até 180 dias; depois, autorize de novo.
- Conecte só IAs que você usa e confia. Na tela de autorização, desconfie de Conectar um aplicativo não verificado se não foi você quem começou a conexão.
- Prefira Somente leitura (na chave ou desligando Permitir criar e alterar dados) quando a IA só precisa consultar, como em relatórios.
- Dê validade às chaves e revogue as que não usa mais. Uma chave por ferramenta facilita cortar só uma.
- Leia a prévia antes de aprovar envios, cobranças e alterações em massa.
- Administradores: acompanhe Aplicativos conectados, Chaves MCP e Uso de vez em quando, e use Quem pode usar o MCP para limitar o recurso.
| Mensagem ou situação | O que fazer |
|---|---|
| O MCP está disponível a partir do plano Equipe | Mude de plano em Meu plano para liberar o MCP. |
| A IA diz que a credencial é inválida ou expirou | A chave foi revogada, venceu ou a conexão foi desconectada. Gere outra chave ou conecte de novo. |
| Este aplicativo não está registrado na WavUps CRM. | A IA tentou entrar com um cadastro que a WavUps CRM não conhece. Remova o conector e adicione de novo; se a IA perguntar como registrar o cliente OAuth, escolha o registro automático (dinâmico). |
| Muitas chamadas em pouco tempo | O limite é de 120 chamadas por minuto por chave ou conexão (e um teto diário por conta). Espere um minuto. |
| Os administradores desligaram o MCP nesta conta ou só os administradores podem usar o MCP | A conta limitou quem usa o MCP. Fale com um administrador. |
| A IA não encontra um lead ou uma conversa que existe | Ela só vê o que você vê. Confira se o lead está visível para você e se você tem acesso ao número de WhatsApp da conversa. |
| A tela de autorização diz Conectar um aplicativo não verificado | O acesso iria para um endereço que a WavUps CRM não reconhece. Só autorize se foi você quem iniciou a conexão e se confia nesse endereço. |
| Esta conexão chegou ao limite de chamadas que usam a IA da WavUps CRM | Resumos, follow-ups e leitura de arquivos têm um limite próprio por conexão. Tente de novo mais tarde. |
| O conector conecta, mas a IA não usa a WavUps CRM | Ative o conector na conversa e cite a WavUps CRM no pedido ("na WavUps CRM, liste..."). |
Claude (site, computador e celular), ChatGPT, o app do Gemini (onde o Google libera apps personalizados), Claude Code, Cursor, VS Code, Gemini CLI e outras ferramentas compatíveis com MCP por HTTP.
https://crm.wavups.com/api/mcp. Ela também aparece no menu MCP, com o botão Copiar.
Não. Claude, ChatGPT e o app do Gemini conectam pelo login da WavUps CRM. A chave MCP é para ferramentas que enviam um cabeçalho, como Claude Code, Cursor, VS Code e Gemini CLI.
Quase nunca: quem processa os pedidos é a IA que você conectou. A exceção são as ferramentas que usam a IA da própria WavUps CRM (resumir conversas, resumo dos atendimentos, preparar follow-ups e ler arquivos de texto livre na importação): elas contam no uso mensal da conta e só aparecem quando o assistente de IA está liberado no plano.
Só o que você também vê na plataforma. Ela usa exatamente as suas permissões.
Sim. Desligue Permitir criar e alterar dados ao autorizar, ou crie uma chave Somente leitura.
Não. A WavUps CRM só recebe as chamadas de ferramentas (por exemplo, "buscar leads") e registra quantas foram feitas, para o Uso e a auditoria. A conversa fica na IA que você usa.
Veja também
Ainda com dúvida?
Fale com a nossa equipe pelo WhatsApp.