# Como usar a WavUps CRM pelo Claude, ChatGPT e Gemini (MCP)

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

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/integracoes/mcp-conectar-claude-chatgpt-gemini (atualizado em 18 de outubro de 2026)

## 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](https://crm.wavups.com/docs/usando-a-plataforma/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](https://crm.wavups.com/docs/integracoes/mcp-ferramentas-e-permissoes).
- 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](https://crm.wavups.com/docs/conta-e-equipe/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.

![Tela MCP numa conta sem o recurso, com o aviso O MCP está disponível a partir do plano Equipe e o botão Ver planos.](https://crm.wavups.com/images/docs/integracoes-mcp-bloqueado.png)

*Sem o plano, o menu **MCP** **(1)** mostra o aviso e o botão **Ver planos** **(2)**.*

## Onde fica o MCP na WavUps CRM

### 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)**.

![Tela MCP da WavUps CRM com a URL do servidor MCP, o botão Copiar e as abas Claude, ChatGPT, Claude Code, Gemini CLI, Cursor e VS Code.](https://crm.wavups.com/images/docs/integracoes-mcp-visao-geral.png)

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

## 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](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude), [ChatGPT](https://crm.wavups.com/docs/integracoes/mcp-conectar-chatgpt) e [Gemini](https://crm.wavups.com/docs/integracoes/mcp-conectar-gemini).

### Passo 1: 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.

### Passo 2: 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)**.

![Tela Conectar Claude à WavUps CRM com o selo Aplicativo verificado, a conta escolhida, o interruptor Permitir criar e alterar dados e o botão Autorizar acesso.](https://crm.wavups.com/images/docs/integracoes-mcp-autorizar.png)

### Passo 3: 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.

### Passo 1: Clique em Nova chave

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

### Passo 2: 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)**.

![Painel Nova chave MCP com o nome da chave, a validade, o interruptor Somente leitura e o botão Gerar chave.](https://crm.wavups.com/images/docs/integracoes-mcp-nova-chave.png)

### Passo 3: 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.

### Passo 4: 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"`.

![Aba Gemini CLI da seção Conectar sua IA, com os passos e a configuração do arquivo settings.json pronta para copiar.](https://crm.wavups.com/images/docs/integracoes-mcp-guia-gemini-cli.png)

> **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

![Seção Aplicativos conectados com o Claude conectado, o acesso, o último uso e o botão de desconectar.](https://crm.wavups.com/images/docs/integracoes-mcp-aplicativos.png)

*Em **Aplicativos conectados**, a lixeira **(1)** desconecta a IA na hora.*

![Seção Chaves MCP com duas chaves, o tipo de acesso, a validade e o botão de revogar.](https://crm.wavups.com/images/docs/integracoes-mcp-chaves.png)

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

![Seção Quem pode usar o MCP com as opções Todos os membros, Só administradores e Ninguém.](https://crm.wavups.com/images/docs/integracoes-mcp-quem-pode-usar.png)

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

![Seção Uso com as chamadas de ferramentas de hoje, dos últimos 7 dias e dos últimos 30 dias.](https://crm.wavups.com/images/docs/integracoes-mcp-uso.png)

***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çã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..."). |

## Perguntas frequentes

### Quais IAs funcionam com o MCP da WavUps CRM?

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.

### Qual é a URL do servidor MCP da WavUps CRM?

`https://crm.wavups.com/api/mcp`. Ela também aparece no menu **MCP**, com o botão **Copiar**.

### Preciso de chave para conectar o Claude ou o ChatGPT?

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.

### O MCP usa o limite de IA da plataforma?

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.

### A IA consegue ver dados de outros membros?

Só o que você também vê na plataforma. Ela usa exatamente as suas permissões.

### Posso deixar a IA só consultando?

Sim. Desligue **Permitir criar e alterar dados** ao autorizar, ou crie uma chave **Somente leitura**.

### A WavUps CRM guarda as conversas que eu tenho com a IA?

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

- [Como conectar o Claude à WavUps CRM (conector MCP)](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude)
- [Como conectar o ChatGPT à WavUps CRM (servidor MCP personalizado)](https://crm.wavups.com/docs/integracoes/mcp-conectar-chatgpt)
- [Como conectar o Gemini à WavUps CRM (app do Gemini e Gemini CLI)](https://crm.wavups.com/docs/integracoes/mcp-conectar-gemini)
- [O que a IA pode fazer na WavUps CRM pelo MCP: recursos e permissões](https://crm.wavups.com/docs/integracoes/mcp-ferramentas-e-permissoes)
- [Como criar e usar a chave de API da WavUps CRM](https://crm.wavups.com/docs/integracoes/chave-de-api)
- [Como ver o uso do plano, trocar de plano e baixar cobranças na WavUps CRM](https://crm.wavups.com/docs/conta-e-equipe/meu-plano)