WavUps CRM
Entrar

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.

Atualizado em 10 min de leitura
Resposta rápida

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.

O que é o MCP da WavUps CRM

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.

Quais planos têm o MCP e quem pode usar

  • 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.
Sem o plano, o menu MCP 1 mostra o aviso e o botão Ver planos 2.

Onde fica o MCP na WavUps CRM

  1. 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 telaPara que serve
Conectar sua IAA URL do servidor e o passo a passo de Claude, ChatGPT, Claude Code, Gemini CLI, Cursor e VS Code.
Quem pode usar o MCPSó administradores veem: Todos os membros, Só administradores ou Ninguém.
Aplicativos conectadosAs IAs autorizadas pelo login (Claude, ChatGPT, Gemini). Desconectar corta o acesso na hora.
Chaves MCPAs chaves das ferramentas que usam cabeçalho (Claude Code, Cursor, VS Code, Gemini CLI).
UsoQuantas ferramentas as IAs chamaram hoje, nos últimos 7 e nos últimos 30 dias.
O que a IA pode fazerAs ferramentas que a sua IA recebe, de acordo com o seu papel.

Como conectar pelo login (Claude, ChatGPT e Gemini)

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.

  1. 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.

  2. 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.

  3. 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.

Como criar uma chave MCP (Claude Code, Cursor, VS Code e Gemini CLI)

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.

  1. 5

    Passo 5: Clique em Nova chave

    No menu MCP, na seção Chaves MCP, clique em Nova chave.

  2. 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.

  3. 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.

  4. 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_MCP pela 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ê

Quem tiver a chave consegue usar a WavUps CRM com as suas permissões. Nunca cole a chave em chats, e-mails ou repositórios de código, e revogue a chave se ela puder ter vazado.

Ações que pedem a sua aprovação na plataforma

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

A IA lê mensagens de clientes, notas e arquivos. Se um desses textos tentar dar ordens à IA, ela ainda assim não consegue enviar, cobrar ou criar uma automação sem o seu clique. Pelo mesmo motivo, automações com webhook (envio de dados a um endereço externo) só são criadas ou alteradas na tela de Automações.

Algumas alterações podem ser desfeitas em até 24 horas: peça para a IA "desfazer a última alteração".

Como ver e cortar os acessos das IAs

Em Aplicativos conectados, a lixeira 1 desconecta a IA na hora.
Em Chaves MCP, cada linha mostra o acesso 1 e a validade 2; a lixeira 3 revoga a chave.
  • 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.
Quem pode usar o MCP vale na hora também para as chaves e conexões que já existem. Nada é revogado: liberando de novo, elas voltam a funcionar.
Uso mostra quantas ferramentas as IAs chamaram: as de toda a conta para administradores, as suas para os demais membros.

Boas práticas de segurança

  • 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.

Se algo der errado

Mensagem ou situaçãoO que fazer
O MCP está disponível a partir do plano EquipeMude de plano em Meu plano para liberar o MCP.
A IA diz que a credencial é inválida ou expirouA 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 tempoO 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 MCPA conta limitou quem usa o MCP. Fale com um administrador.
A IA não encontra um lead ou uma conversa que existeEla 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 verificadoO 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 CRMResumos, 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 CRMAtive o conector na conversa e cite a WavUps CRM no pedido ("na WavUps CRM, liste...").

Perguntas frequentes

Veja também

Ainda com dúvida?

Fale com a nossa equipe pelo WhatsApp.

Falar com o suporte