# O WhatsApp MCP para o seu número pessoal, hospedado e pronto

> Dê ao Claude, ao ChatGPT, ao Codex, ao Instinct ou a qualquer cliente MCP as conversas do WhatsApp que você escolher. Não há nada para instalar, nenhuma ponte rodando no seu notebook e nenhuma conta do WhatsApp Business. Conecte com um toque, um endereço ou um token, e o seu agente recebe mensagens prontas para usar: arquivos prontos para abrir e remetentes pelo nome.

**O Circles é um servidor WhatsApp MCP remoto.** Ele conecta o seu número de WhatsApp como aparelho conectado, mantém sincronizadas as conversas que você abrir e as entrega ao seu agente em `https://app.usecircles.app/api/mcp`, com OAuth. Permissões por conversa, arquivos sob pedido e envio desligado até você permitir. Free para 2 conversas, Pro por R$ 99,90 por mês no Brasil, com 14 dias de Pro grátis e sem cartão, em outubro de 2026.

Fonte: https://usecircles.app/pt-br/whatsapp-mcp · Atualizado em 2026-10-31

## O Circles em resumo

Tudo o que um agente, ou quem está escolhendo um, precisa saber, numa tabela só.

|  | Circles |
| --- | --- |
| O que é | Um serviço hospedado que conecta o seu WhatsApp e entrega as conversas que você escolher a agentes de IA. Quem pensa é o seu agente. |
| O seu número | O seu WhatsApp pessoal, como aparelho conectado. Mesmo número, mesmo app no celular. Sem WhatsApp Business. |
| Endpoint MCP | `https://app.usecircles.app/api/mcp` (remoto, por HTTP) |
| Acesso dos agentes | OAuth 2.1 com PKCE e registro dinâmico de clientes, ou um token bearer que você cria |
| Como conectar | Instinct: um toque e um envio. Claude, ChatGPT, Codex: um endereço e uma aprovação. Claude Code, Cursor, Grok: um token e um bloco de configuração. |
| Ferramentas | 9: allowed_chats, activity, people, catch_up, search, documents, group_members, get_media, send |
| Áudios | A transcrição automática de áudios está disponível em hebraico e inglês. A de áudios em português ainda não foi verificada. |
| Fotos e documentos | Guardados e entregues ao agente sob pedido, até 50 MB cada |
| Histórico | Free: o último mês. Starter: os últimos 3 meses. Pro: todo o histórico, ou os últimos 90, 60 ou 30 dias. |
| Permissões | Por conversa: oculta, leitura, ou leitura e envio. Conversas ocultas não existem para os agentes. |
| Envio | No Pro. Desligado até você abrir uma conversa para isso. Um limite diário para todos os agentes juntos (padrão 5). Nunca repetido automaticamente. |
| Também | Uma API HTTP com OpenAPI 3.1 para agentes que não falam MCP |
| Preço no Brasil | Free: sem custo, 2 conversas, só leitura. Starter: R$ 49,90 por mês, até 5 conversas, só leitura. Pro: R$ 99,90 por mês, todas as conversas, envio onde você aprovar. 14 dias de Pro grátis, sem cartão. [Outros países](https://usecircles.app/pt-br/pricing#countries). |

## Conecte o seu agente: um toque, um endereço ou um token

Você conecta o seu número uma vez. Depois, cada agente se conecta do jeito que funciona melhor para ele, e você aprova na própria página do Circles.

- **[Instinct](https://usecircles.app/pt-br/agents/instinct)**: Toque em conectar. O WhatsApp abre com um código de uso único já escrito para o Instinct. Toque em enviar. Nenhuma chave para copiar.
- **[Claude](https://usecircles.app/pt-br/agents/claude)**: Adicione o Circles como conector personalizado no Claude e aprove. Funciona no Claude no navegador, no computador e no celular.
- **[ChatGPT](https://usecircles.app/pt-br/agents/chatgpt)**: No computador, adicione o Circles com um endereço e aprove. O ChatGPT lê as conversas que você escolheu.
- **[Codex](https://usecircles.app/en/agents/codex)**: Adicione um servidor MCP com o endereço do Circles. O Codex pede a sua aprovação, e pronto.
- **[Claude Code](https://usecircles.app/en/agents/claude-code)**: Um comando ou um bloco JSON com um token que o Circles escreve para você.
- **[Cursor](https://usecircles.app/en/agents/cursor)**: Cole nas configurações de MCP do Cursor a configuração que o Circles entrega.
- **[Grok](https://usecircles.app/en/agents/grok)**: Adicione o Circles como servidor MCP remoto, com um token.
- **[O seu próprio agente](https://usecircles.app/en/whatsapp-api-personal-number)**: n8n, um script ou um agente que você criou: as mesmas conversas por uma API HTTP simples, com uma chave.

## Pronto para agentes desde a primeira chamada

O Circles prepara cada mensagem antes que o seu agente a veja. Assim o agente gasta a vez dele respondendo você.

- **Arquivos prontos para abrir.** Fotos, PDFs, documentos e vídeos são guardados e anunciados com nome, tipo e tamanho. O agente busca um deles com uma única chamada quando precisa. Arquivos mais antigos vêm do seu celular sob pedido.
- **Remetentes pelo nome.** Os remetentes aparecem com o nome que você salvou; listas de participantes de grupos nunca trazem números. Alguém que você nunca salvou pode aparecer pelo número.
- **Perguntas baratas continuam baratas.** `activity` diz quais conversas tiveram movimento e quanto, sem texto, então "o que eu perdi?" custa uma fração de ler tudo.
- **Recusas que ajudam.** Peça uma conversa que não está aberta, e a resposta diz quais *estão* abertas. "Nenhuma mensagem" e "você não pode ver essa conversa" nunca se confundem.
- **Histórico completo.** Tudo o que o WhatsApp sincroniza com um aparelho conectado, muitas vezes anos, e tudo o que chega depois, com busca em todas as conversas que você abriu. No Free os agentes veem o último mês e no Starter, 3 meses; no Pro, tudo.
- **Áudios.** A transcrição automática de áudios está disponível em hebraico e inglês. A de áudios em português ainda não foi verificada. A transcrição fica dentro da mensagem, e a busca encontra o que foi dito.

É isto que um agente recebe quando lê as novidades de um grupo de pais (resumido, em inglês):

```
{
  "chat": "Oak Street parents",
  "messages": [
    {
      "from": "Dana",
      "at_iso": "2026-10-26T06:12:00.000Z",
      "body": "Quick update: the trip moved to Thursday, buses leave at 8:15, bring a hat and a packed lunch."
    },
    {
      "from": "Yossi",
      "at_iso": "2026-10-26T07:03:00.000Z",
      "body": "Permission slip attached, please sign by Wednesday",
      "media": {
        "kind": "document",
        "filename": "trip-permission.pdf",
        "state": "available",
        "fetch_with": "get_media",
        "ref": "r1_..."
      }
    }
  ]
}
```

## As nove ferramentas

As ferramentas só aparecem quando o agente pode usá-las: um agente sem permissão de envio nem vê `send`.

| Ferramenta | O que faz | Bom para |
| --- | --- | --- |
| `allowed_chats` | As conversas abertas aos agentes e o que pode ser feito em cada uma | Conhecer o mundo inteiro antes de começar |
| `activity` | Quais conversas tiveram movimento desde um horário, com contagens e sem texto | "O que eu perdi?" quase sem custo |
| `catch_up` | Mensagens desde um horário, numa conversa ou em todas, com nomes resolvidos e transcrições de áudio | Resumos, compilados, acompanhamentos |
| `search` | Busca de texto numa conversa ou em todas, incluindo o que foi dito em áudios transcritos | "Alguém falou do encanador?" |
| `people` | Com quem você conversa nas conversas abertas, e onde | Contexto sobre as pessoas da sua vida |
| `group_members` | Participantes de um grupo aberto, pelo nome, com administradores marcados | "Quem está no grupo do condomínio?" |
| `documents` | Todo PDF, arquivo do Word e planilha enviado nas conversas abertas | "Ache o contrato que o Paulo mandou em junho" |
| `get_media` | Uma foto, documento, vídeo ou arquivo de áudio | Ler o próprio arquivo |
| `send` | Uma mensagem ou arquivo, só onde você permitiu envio, dentro do limite diário | Respostas que você pediu |

## WhatsApp MCP hospedado ou instalado por você?

Servidores WhatsApp MCP de código aberto são uma boa escolha para quem quer rodar o próprio. Esta é a diferença, sem exagero.

|  | Instalado por você (código aberto) | Circles |
| --- | --- | --- |
| Instalação | Clonar um repositório, rodar uma ponte e um servidor MCP, escanear um QR no computador | Conectar pelo celular e ligar o agente com um toque, um endereço ou um token |
| Funciona com o notebook dormindo | Não, a menos que você mantenha um servidor | Sim, hospedado |
| Funciona com o Claude no navegador e no celular | Precisa de um endereço público e de autenticação feitos por você | Sim, MCP remoto com OAuth |
| Áudios | Arquivos de áudio; a transcrição fica por sua conta | Transcritos automaticamente em hebraico e inglês |
| Quais conversas o agente vê | Geralmente todas | Só as que você abrir, definidas por conversa para todos os seus agentes |
| Envio | Geralmente sem restrição | Desligado por padrão, por conversa, com limite diário e registrado |
| Custo | Grátis, mais o seu tempo e um servidor | Free para 2 conversas; Pro por R$ 99,90 por mês no Brasil |

Mais detalhes, e quando instalar por conta própria é a melhor escolha: [Circles e servidores WhatsApp MCP instalados por você](https://usecircles.app/en/compare/self-hosted-whatsapp-mcp).

## Você decide o que os seus agentes veem

Cada conversa tem um de três níveis. **Oculta**: ela não existe para os agentes, nem em listas, nem em buscas, nem citada numa recusa. **Leitura**: os agentes podem ler e buscar, e não há como enviar. **Leitura e envio**: um agente também pode escrever ali, como você, dentro de um limite diário que você define.

Oculta não quer dizer que o Circles não guarda: uma conversa oculta ainda pode ficar guardada no Circles, a menos que você ligue "nunca guardar" para ela. Todo pedido de um agente, incluindo os que o Circles recusou, fica no seu registro de atividade. Desconecte um agente e o acesso dele termina na hora. [Como o Circles deixa as suas conversas nas suas mãos](https://usecircles.app/pt-br/security).

## Perguntas e respostas

### Existe um servidor WhatsApp MCP para o Claude?

Sim. O Circles é um servidor WhatsApp MCP hospedado que o Claude conecta como conector personalizado, com um endereço e uma aprovação. Funciona com o seu número pessoal e só com as conversas que você escolher.

### Existe um endereço de servidor WhatsApp MCP remoto?

Sim: `https://app.usecircles.app/api/mcp`. É um servidor MCP remoto por HTTP com OAuth 2.1, então clientes que aceitam conectores personalizados podem adicioná-lo pelo endereço. Você precisa de uma conta do Circles com o seu número conectado.

### Preciso do WhatsApp Business ou de um segundo número?

Não. O Circles conecta o seu WhatsApp pessoal de sempre como aparelho conectado, do mesmo jeito que o WhatsApp Web. Você continua usando o WhatsApp no celular normalmente.

### Ele transcreve áudios?

A transcrição automática de áudios está disponível em hebraico e inglês. A de áudios em português ainda não foi verificada. Quando há transcrição, o texto chega dentro da mensagem para o agente ler e buscar.

### O agente pode enviar mensagens como se fosse eu?

Só nas conversas que você abriu para envio, e só até o limite diário que você definir (padrão 5 para todos os agentes juntos). O envio fica desligado até você ligar, e um envio nunca é repetido automaticamente.

### O WhatsApp pode desconectar ou banir o meu número?

Qualquer cliente não oficial, como um aparelho conectado que não foi feito pelo WhatsApp, fica fora dos termos dele, e ninguém pode prometer que um aparelho conectado nunca vai ser desconectado. O Circles lê por padrão, limita os envios, nunca faz envio em massa e conecta cada cliente por um endereço IP dedicado, que não é compartilhado com ninguém.

### Quanto custa um WhatsApp MCP?

O Circles tem um plano Free, sem custo, para 2 conversas. No Brasil, o Starter custa R$ 49,90 por mês para até 5 conversas, e o Pro custa R$ 99,90 por mês para todas as conversas e envio, com 14 dias de Pro grátis e sem cartão. A assinatura do seu agente é separada. [Preços](https://usecircles.app/pt-br/pricing).

## Continue lendo

- [Todos os agentes, passo a passo](https://usecircles.app/en/agents): Instinct, Claude, ChatGPT, Codex, Claude Code, Cursor, Grok e a API.
- [Resumir grupos do WhatsApp](https://usecircles.app/pt-br/use-cases/summarize-whatsapp-groups): O que perguntar, e como é um bom resumo.
- [Segurança](https://usecircles.app/pt-br/security): Níveis por conversa, envio limitado, registro de atividade e os riscos reais.

---

14 dias de Pro grátis, sem cartão. Vincule seu número, escolha as conversas e conecte a IA que você já usa: Instinct com um toque, Claude, ChatGPT e Codex com um endereço. Comece aqui: https://usecircles.app/start?lang=pt-BR