# Guias do Circles

> Como configurar o Circles, passo a passo: conectar o seu WhatsApp, escolher quais conversas os seus agentes veem e conectar o seu agente. A referência técnica, escrita para os próprios agentes, está [numa página própria](https://usecircles.app/pt-br/api-mcp-docs).

**O Circles conecta as conversas do WhatsApp que você escolher ao agente de IA que você escolher.** Você conecta o seu próprio número como aparelho conectado, abre as conversas que um agente pode ler (e, se quiser, onde ele pode enviar) e conecta o agente por endereço ou com um token. Toda conexão pode ser cortada com um toque. Em outubro de 2026.

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

## Começo rápido

Do zero a um agente lendo as suas conversas em poucos minutos. Sem cartão.

1. **Escolha o seu assistente e digite o seu número**: Em usecircles.app, escolha o assistente e digite o seu número de WhatsApp. Um link chega no seu WhatsApp, enviado pelo número do Circles. Ele funciona uma vez, por dez minutos.
2. **Toque no link e conecte o WhatsApp**: A página de conexão abre já com a sua conta, sem cartão e sem pagamento. Conecte o número como aparelho conectado: um código que você digita no celular, ou um QR que você escaneia no computador. Os 14 dias de Pro começam aqui. [Detalhes](#link).
3. **Confira as suas conversas**: Num número novo, grupos e conversas individuais ficam abertos para leitura por padrão. Oculte o que um agente nunca deve ver, e abra uma conversa para envio só onde você quer respostas. [Detalhes](#chats).
4. **Conecte o seu agente**: Instinct: um toque e um envio. Claude, ChatGPT, Codex: cole `https://app.usecircles.app/api/mcp` e aprove. Claude Code, Cursor, Grok: um token e um bloco de configuração (Claude Code: um comando). [Detalhes](#connect).
5. **Pergunte**: "O que eu perdi no grupo dos pais?" O agente chama `activity`, depois `catch_up`, e responde. O histórico chega em cerca de 5 a 15 minutos.

Para um cliente que usa um arquivo de configuração, esta é a instalação inteira:

```
# Claude Code, one command (the token comes from Circles: New token > Copy config)
claude mcp add --transport http circles https://app.usecircles.app/api/mcp \
  --header "Authorization: Bearer circ_..."

# Or the same as a JSON block (Claude Code's .mcp.json needs "type": "http";
# Cursor, Grok and other MCP clients take the same block)
{
  "mcpServers": {
    "circles": {
      "type": "http",
      "url": "https://app.usecircles.app/api/mcp",
      "headers": { "Authorization": "Bearer circ_..." }
    }
  }
}
```

## Conecte o seu WhatsApp

O Circles conecta o seu número pessoal de sempre como um **aparelho conectado**, o mesmo mecanismo do WhatsApp Web. O seu celular continua funcionando como sempre, e as pessoas com quem você fala não veem diferença. Você não precisa de conta do WhatsApp Business nem de um segundo número.

1. Digite o seu número de WhatsApp em usecircles.app. O Circles envia um link do próprio número de WhatsApp dele. Não há senha. Para voltar depois, entre em [app.usecircles.app](https://app.usecircles.app) com o mesmo número.
2. Escolha como conectar. **No celular:** o Circles mostra um código; no WhatsApp, abra "Aparelhos conectados" (no iPhone, em Configurações; no Android, no menu de três pontos), toque em "Conectar um aparelho", escolha conectar com o número de telefone e digite o código. **No computador:** escaneie o QR pela tela de aparelhos conectados do WhatsApp. Os nomes dos menus podem mudar um pouco conforme a versão do WhatsApp.
3. O seu celular pode mostrar um aviso de que um aparelho foi conectado. É o Circles.
4. O histórico chega em cerca de 5 a 15 minutos. Mensagens novas chegam assim que são enviadas.

Um número só é conectado depois de confirmado como seu: você tocou no link enviado a ele. Cada cliente se conecta por um endereço IP dedicado, que não é compartilhado com nenhum outro cliente; se nenhum estiver pronto, a conexão espera até que um esteja. Ela nunca usa um endereço compartilhado.

**Histórico.** Todo o histórico por padrão: tudo o que o WhatsApp entrega a um aparelho conectado (muitas vezes anos) mais tudo o que chega depois, guardado enquanto o número estiver conectado. Quem decide quanto do histórico do celular é enviado é o WhatsApp. Você pode limitar aos últimos 90, 60 ou 30 dias; uma janela menor apaga o que fica fora dela, e ampliar depois só vale daí em diante.

**Arquivos.** Fotos, documentos, vídeos e áudios de até cerca de 25 dias depois da mensagem são baixados em segundo plano. Os mais antigos ficam `on_request`: quando um agente pede um deles, o seu celular envia de novo, então o celular precisa estar online.

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

**Desconectar** remove o aparelho do WhatsApp e, assim que o WhatsApp confirma, apaga tudo o que foi guardado do número. As suas configurações e escolhas por conversa ficam para quando você conectar de novo.

## Escolha o que os agentes veem

As permissões pertencem às conversas: todo agente que você conecta vê as mesmas conversas abertas, dentro do que o acesso dele permite.

| Configuração | O que faz | Padrão |
| --- | --- | --- |
| Oculta | A conversa não existe para os agentes: não aparece em listas nem em buscas e nunca é citada, nem numa recusa nem no registro. Oculta não quer dizer não guardada. | O padrão de números conectados pela primeira vez antes de 2026-09-29 |
| Leitura | Os agentes leem, buscam e abrem os arquivos. Não há como enviar. | Grupos e conversas individuais num número novo |
| Leitura e envio | Os agentes também podem enviar ali, como você, dentro do limite diário. O Circles avisa antes que as mensagens vão parecer enviadas por você. | Nunca por padrão |
| Nunca guardar | Nada da conversa é gravado, e ela não pode ser aberta | Desligado |
| Incluir conversas individuais | Desligado: nenhum agente vê conversa individual nenhuma, qualquer que seja o nível | Ligado para números conectados pela primeira vez a partir de 2026-10-27 |
| Padrão do número | O nível que uma conversa recebe quando aparece pela primeira vez. As escolhas que você fez à mão nunca mudam por causa dele. | Leitura |
| Limite diário de envio | Mensagens por dia para o número todo, somando todos os agentes, contadas por dia UTC | 5 (escolha 5, 10, 20 ou sem limite) |
| Janela de histórico | Até quando o Circles guarda as mensagens | Todo o histórico (ou 90, 60, 30 dias) |

Um grupo novo fica oculto até o WhatsApp entregar o nome dele. Uma conversa que você abre hoje traz o histórico de antes de você abri-la. Uma conversa arquivada continua legível e vem marcada com `archived: true`. Começar uma conversa com alguém novo (por número ou contato salvo) só é possível quando o padrão do número é leitura e envio.

## Conecte um agente

Cada agente se conecta do jeito que funciona melhor para ele. Toda conexão aparece na lista de agentes do Circles, onde um toque desconecta.

| Agente | Como se conecta | O que você faz |
| --- | --- | --- |
| [Instinct](https://usecircles.app/pt-br/agents/instinct) | Código de uso único enviado pelo WhatsApp | Toque para conectar o Instinct; o WhatsApp abre com a mensagem escrita; toque em enviar. Nenhuma chave. Precisa de uma conta do Instinct, que é por convite. |
| [Claude](https://usecircles.app/pt-br/agents/claude) | Por endereço, OAuth | No claude.ai, abra "Customize", depois "Connectors" e "Add custom connector" (os menus podem aparecer traduzidos). Cole `https://app.usecircles.app/api/mcp`, conecte e aprove na página do Circles. |
| [ChatGPT](https://usecircles.app/pt-br/agents/chatgpt), [Codex](https://usecircles.app/en/agents/codex) | Por endereço, OAuth | No ChatGPT, no computador: "Settings", "Plugins", "Add custom MCP server". Cole o endereço e aprove. Verificado só nos planos Business e Enterprise. No Codex, adicione um servidor MCP com o endereço. |
| [Claude Code](https://usecircles.app/en/agents/claude-code) | Token na configuração MCP | Novo token, depois rode o comando `claude mcp add --transport http` acima (preferido), ou cole a configuração em `.mcp.json` com `"type": "http"` |
| [Cursor](https://usecircles.app/en/agents/cursor) | Token na configuração MCP | Novo token, copie a configuração e cole nas configurações de MCP do Cursor. O Cursor não se conecta por endereço. |
| [Grok](https://usecircles.app/en/agents/grok) | Token na configuração MCP | Novo token, depois adicione o Circles como servidor MCP remoto com ele |
| [O seu próprio agente](https://usecircles.app/en/whatsapp-api-personal-number) | API HTTP com uma chave, ou MCP com um token | Novo token, escolha API e entregue ao agente as instruções e depois a chave, em duas mensagens |

Não existem botões "Add to Claude" nem "Add to Cursor". Conectar por endereço é o caminho de um passo para o Claude, o ChatGPT e o Codex. Um token é o caminho para clientes que usam um arquivo de configuração.

Na página de aprovação, leitura e arquivos vêm marcados e o envio vem desmarcado para agentes como o Claude e o ChatGPT. Marque o envio só se quiser que o agente possa enviar, e mesmo assim ele só envia nas conversas que você abriu para envio.

Um token é para um agente, e o registro de atividade mostra o nome que você der a ele. Ao entregar uma chave a um agente que funciona por chat, o Circles dá duas mensagens: primeiro as instruções, depois só a chave, para que a chave fique apenas nos segredos do agente.

## Para agentes: a documentação da API e do MCP

A referência técnica fica numa página própria, escrita para os próprios agentes: as nove ferramentas MCP e os parâmetros delas, como são as respostas e as recusas, OAuth e tokens, a API HTTP, todos os limites e o histórico de mudanças. Um agente conectado, ou prestes a se conectar, pode lê-la para entender o que o Circles oferece e como usar bem.

[Documentação da API e do MCP do Circles](https://usecircles.app/pt-br/api-mcp-docs). A versão original em inglês também existe [em Markdown](https://usecircles.app/en/api-mcp-docs.md).

## Perguntas e respostas

### Qual é o endereço do servidor MCP do Circles?

`https://app.usecircles.app/api/mcp`. Cole no Claude, no ChatGPT ou no Codex e aprove na página do Circles, ou use com um token num cliente que usa arquivo de configuração.

### Preciso de cartão para começar?

Não. O cadastro é sem cartão, e os 14 dias de Pro começam quando você conecta o WhatsApp. [Preços](https://usecircles.app/pt-br/pricing).

### Onde está a referência técnica?

Na página da [documentação da API e do MCP](https://usecircles.app/pt-br/api-mcp-docs), escrita para agentes: ferramentas, respostas, autenticação, a API HTTP e limites.

## Continue lendo

- [WhatsApp MCP, em resumo](https://usecircles.app/pt-br/whatsapp-mcp): O que é o Circles e a diferença para instalar por conta própria.
- [Segurança e controle](https://usecircles.app/pt-br/security): Níveis por conversa, aprovação, registro de atividade e os riscos reais.
- [Conecte o seu agente](https://usecircles.app/en/agents): Instinct, Claude, ChatGPT, Codex, Claude Code, Cursor, Grok e a API.

---

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