# Como conectar o Claude à WavUps CRM (conector MCP)

> Para conectar o Claude à WavUps CRM, abra **Personalizar** > **Conectores** no Claude, clique em **+ Adicionar** > **Adicionar conector personalizado**, dê o nome **WavUps CRM**, cole a URL `https://crm.wavups.com/api/mcp` e conclua a autorização na tela da WavUps CRM. Depois, ative o conector na conversa pelo botão **+**. No Claude Code, use o comando `claude mcp add` com uma chave MCP.

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

## Antes de começar

- A sua conta da WavUps CRM precisa estar no plano **Equipe**, **Pro** ou **Escala**, e o MCP precisa estar liberado para você em **Quem pode usar o MCP**.
- Conectores personalizados funcionam nos planos Free (um conector), Pro, Max, Team e Enterprise do Claude.
- No Claude **Team** e **Enterprise**, só os proprietários da organização adicionam conectores personalizados (em **Configurações da organização** > **Conectores**). Depois, cada pessoa clica em **Conectar** e autoriza com o próprio login da WavUps CRM.

## Passo a passo: Claude no site, no computador e no celular

### Passo 1: Copie a URL do servidor

Na WavUps CRM, em **Configurações** > **MCP**, clique em **Copiar** ao lado da **URL do servidor MCP**. A aba **Claude** **(1)** mostra estes mesmos passos.

![Seção Conectar sua IA da WavUps CRM com a URL do servidor MCP e a aba Claude aberta com os passos.](https://crm.wavups.com/images/docs/integracoes-mcp-conectar.png)

### Passo 2: Adicione o conector personalizado

No Claude (claude.ai ou app do computador), abra **Personalizar** (Customize) > **Conectores** (Connectors), clique em **+ Adicionar** e em **Adicionar conector personalizado** (Add custom connector). Em versões anteriores do Claude, o caminho é **Configurações** > **Conectores**.

### Passo 3: Preencha o nome e a URL

Em nome, escreva **WavUps CRM**. Em URL, cole `https://crm.wavups.com/api/mcp` e continue. A autenticação é **OAuth**: não informe cabeçalhos nem chaves. Se o Claude perguntar como registrar o cliente OAuth, escolha **Registrar automaticamente** (Register automatically). Clique em **Adicionar**.

### Passo 4: Autorize na WavUps CRM

Clique em **Conectar**. Abre a tela **Conectar Claude à WavUps CRM**, com o selo **Aplicativo verificado**. Entre com o seu login, escolha a conta, decida se o Claude pode **Permitir criar e alterar dados** e clique em **Autorizar acesso**.

![Tela Conectar Claude à WavUps CRM com o selo Aplicativo verificado e o botão Autorizar acesso.](https://crm.wavups.com/images/docs/integracoes-mcp-autorizar.png)

### Passo 5: Ative o conector na conversa

Numa conversa nova, clique no **+** no canto inferior do campo de mensagem, abra **Conectores** e ligue **WavUps CRM**. Faça o pedido, por exemplo: "Na WavUps CRM, o que eu preciso fazer hoje?". O conector adicionado no site também aparece no app do celular.

> **Atalhos prontos**
> A WavUps CRM oferece três atalhos (prompts) para o Claude: **Revisar meu funil**, **Preparar reunião com um lead** e **Planejar minha semana**. Eles aparecem entre as opções do conector no menu **+** da conversa.

## Passo a passo: Claude Code

### Passo 1: Gere uma chave MCP

Na WavUps CRM, em **MCP** > **Chaves MCP**, clique em **Nova chave**, dê o nome "Claude Code" e copie a chave. Veja [Como criar uma chave MCP](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude-chatgpt-gemini#chave-mcp).

### Passo 2: Adicione o servidor no terminal

Rode `claude mcp add --transport http wavups-crm https://crm.wavups.com/api/mcp --header "Authorization: Bearer SUA_CHAVE_MCP"`, trocando `SUA_CHAVE_MCP` pela chave.

### Passo 3: Confira a conexão

Dentro do Claude Code, digite `/mcp`: o servidor **wavups-crm** aparece como conectado. Sem chave, rode o comando sem o `--header` e autorize pelo `/mcp`, com o seu login.

## O que pedir ao Claude

- "Me dá o resumo do meu dia na WavUps CRM: tarefas, compromissos e conversas esperando resposta."
- "Quais negócios do funil Vendas estão parados há mais de 7 dias? Sugira a próxima ação de cada um."
- "Crie um projeto Implantação Cliente X com as tarefas desta ata de reunião."
- "Quanto tenho a receber este mês e quem está com fatura vencida?"

Veja exemplos completos em [Casos de uso](https://crm.wavups.com/docs/casos-de-uso), como o [briefing da manhã](https://crm.wavups.com/docs/casos-de-uso/ia-briefing-da-manha).

## Se algo der errado

| Situação | O que fazer |
| --- | --- |
| Não aparece a opção de adicionar conector personalizado | No Claude Team ou Enterprise, peça a um proprietário da organização para adicionar o conector. |
| **Este aplicativo não está registrado na WavUps CRM.** | Remova o conector e adicione de novo, escolhendo **Registrar automaticamente** no cliente OAuth. |
| O Claude responde sem consultar o CRM | Confira se o conector **WavUps CRM** está ligado na conversa e cite a WavUps CRM no pedido. |
| A ferramenta pede confirmação a cada chamada | É o Claude pedindo permissão. Você pode permitir sempre para as ferramentas de consulta. |
| O Claude parou de acessar depois de meses | A conexão dura até 180 dias. Clique em **Conectar** de novo no conector. |

## Perguntas frequentes

### Funciona no Claude grátis?

Sim. O plano Free do Claude permite um conector personalizado. A conta da WavUps CRM é que precisa estar no plano Equipe ou superior.

### Funciona no app do Claude no celular?

Sim. Adicione o conector pelo site ou pelo app do computador; depois ele aparece também no celular.

### Posso usar o Claude Desktop com arquivo de configuração?

Não é preciso: o Claude Desktop usa os mesmos **Conectores** do site. O arquivo de configuração serve para servidores locais, e a WavUps CRM é um servidor remoto.

### Como desconecto o Claude?

Na WavUps CRM, em **MCP** > **Aplicativos conectados**, clique na lixeira e em **Desconectar**. Também dá para remover o conector no Claude.

## Veja também

- [Como usar a WavUps CRM pelo Claude, ChatGPT e Gemini (MCP)](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude-chatgpt-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 montar o briefing da manhã do funil e da agenda com IA (Claude, ChatGPT ou Gemini) e a WavUps CRM](https://crm.wavups.com/docs/casos-de-uso/ia-briefing-da-manha)
- [Como conectar o ChatGPT à WavUps CRM (servidor MCP personalizado)](https://crm.wavups.com/docs/integracoes/mcp-conectar-chatgpt)