> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.thewhiterabbit.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# MCP do The White Rabbit: gerencie suas campanhas conversando com uma IA

# MCP do The White Rabbit: gerencie suas campanhas conversando com uma IA

O The White Rabbit (TWR) tem um servidor MCP que conecta a sua conta a assistentes de IA como o Claude. Depois de conectado, você cria e gerencia campanhas, domínios e testes A/B conversando em linguagem natural, e ainda consulta como o filtro de tráfego está se comportando, sem abrir o painel.

## Antes de começar

* Funciona em qualquer assistente de IA compatível com servidores MCP remotos. Neste artigo usamos o Claude como exemplo, mas o processo é o mesmo em outros.
* O MCP está disponível em **todos os planos**, com até **5 chaves ativas** por conta. O que muda é o número de chamadas por janela de 5 horas:

| Plano | Chamadas por janela de 5 horas |
| ---- |
| Basic e PRO | 50 |
| Freedom | 100 |
| Enterprise | 150 |

## O que o MCP consegue fazer

O MCP dá ao seu assistente acesso às mesmas operações que você faz no painel, mais consultas sobre os acessos que passaram pelo filtro.

| Área | O que o assistente consegue fazer |
| ---- |
| **Campanhas** | Buscar e detalhar, criar, editar, pausar, reativar, excluir, baixar o script de integração e montar a URL final já com os parâmetros |
| **Domínios** | Listar, adicionar, validar e excluir (com a opção de migrar as campanhas para outro domínio antes) |
| **A/B Storm** | Listar, detalhar, criar, editar, pausar, reativar e excluir testes |
| **Fontes de tráfego** | Consultar as fontes disponíveis no seu plano |
| **Métricas** | Analisar os acessos por país, região, cidade, dispositivo, dia, hora, campanha, fonte de tráfego e parâmetros da URL, separando Offer Page, Safe Page e bots |

Como a conversa é livre, você não precisa decorar comandos. Basta pedir o que quer, do jeito que falaria com uma pessoa. Alguns exemplos para você ter uma ideia do alcance:

* "Quantos bots eu filtrei nos últimos 7 dias? Separa por país."
* "Qual das minhas campanhas recebeu mais acessos essa semana?"
* "Cadastra o domínio `home.meudominio.com` e valida."
* "Me dá a URL completa, com os parâmetros, da campanha do lançamento."
* "Pausa todas as campanhas que estão apontando para a oferta antiga."
* "Cria um A/B Storm com três Offer Pages dividindo 40, 30 e 30."

## Passo a passo

### 1. Abra as Integrações do seu perfil

No menu do workspace, clique no seu perfil e abra a aba **Integrações**.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/01-abrir-integracoes_13c69q0.gif)

### 2. Crie a sua chave MCP

Na aba **MCP**, clique em **Nova chave**, dê um nome que identifique onde ela vai ser usada e confirme em **Criar**.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/02-criar-chave-mcp_1ck0xdf.gif)

| A chave de API e a chave MCP são diferentes e não se substituem. Para conectar um assistente de IA, use sempre a chave da aba **MCP**.

### 3. Copie a URL do servidor MCP

O TWR mostra dois campos: a **Chave** e a **URL do servidor MCP**. Copie a **URL**, porque ela já vem com a sua chave embutida e é o único dado que o assistente precisa. Depois clique em **Concluído**.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/03-copiar-url_1oagsks.gif)

||| Esta é a única vez em que a chave completa aparece. Copie e guarde em local seguro antes de fechar o aviso. Se perder, gere outra e revogue a anterior.

### 4. Adicione o servidor no seu assistente de IA

No Claude, abra **Settings**, vá em **Connectors**, clique em **Add** e escolha **Add custom connector**. Dê um nome ao conector, cole a URL que você copiou no campo **Remote MCP server URL** e confirme em **Add**. Os campos de OAuth em **Advanced settings** ficam em branco.

Na tela do conector, clique em **Connect** para ativar a conexão.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/04-adicionar-conector_1r147wi.gif)

Em assistentes que usam arquivo de configuração, cadastre como servidor MCP remoto por HTTP:

```json
{
  "mcpServers": {
    "the-white-rabbit": {
      "url": "https://mcp-server.thewhiterabbit.app/mcp?token=SUA_CHAVE"
    }
  }
}
```

| Não é preciso configurar cabeçalhos, tokens ou autenticação à parte. A URL já carrega a sua chave.

### 5. Confirme que as ferramentas do TWR apareceram

Com a conexão ativa, o assistente lista as ferramentas disponíveis, separadas entre as de leitura (buscar campanhas, listar domínios, consultar métricas) e as de escrita e exclusão (criar, editar, pausar, excluir). Se a lista aparecer, está funcionando.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/05-confirmar-ferramentas_oyoind.gif)

| No Claude, essas ferramentas vêm marcadas como **Needs approval**, ou seja, ele pede a sua autorização antes de executar cada uma. Você pode ajustar isso por ferramenta na própria tela do conector.

### 6. Faça o primeiro pedido

Comece por algo simples, como pedir a lista das suas campanhas ou dos seus domínios. O assistente consulta a sua conta e responde com os dados reais.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/06-primeiro-pedido_15g7vs0.gif)

|| Para criar uma campanha, o assistente pergunta o domínio, a fonte de tráfego e as páginas antes de gravar qualquer coisa. Já as exclusões pedem uma confirmação explícita sua, porque não têm como ser desfeitas.

### 7. Acompanhe o consumo e revogue quando precisar

Na mesma tela de **Integrações**, a barra **Uso do MCP (janela de 5h)** mostra quantas chamadas você já usou e em quanto tempo o limite renova. A lista acima dela traz cada chave com a data de criação e o último uso.

Para desconectar um assistente, clique no ícone de excluir na coluna **Ações** e confirme a revogação. A partir daí, qualquer conexão feita com aquela chave é rejeitada.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/07-uso-e-revogar_7mms0t.gif)

## Cuidados com a sua chave

* A URL do servidor contém a sua chave. Trate como senha: não poste em grupos, prints ou repositórios.
* Use uma chave por lugar. Assim, se precisar cortar o acesso de um, os outros continuam funcionando.
* Campanhas excluídas param de receber tráfego na hora e não podem ser recuperadas. Confirme com atenção antes de aprovar uma exclusão. Se a ideia é só interromper o tráfego por um tempo, peça para **pausar** a campanha, que é reversível.
* As consultas de métricas nunca expõem IP, navegador ou cabeçalhos dos acessos, e só enxergam campanhas da sua própria conta.

Se você prefere integrar seus próprios sistemas em vez de usar um assistente de IA, o TWR também tem uma API REST, disponível a partir do plano **Freedom**. A documentação completa está em [api.thewhiterabbit.app/openapi](https://api.thewhiterabbit.app/openapi), e a chave fica na aba **Chave de API**, ao lado da aba MCP.

---