Guias
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.
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.
Atualizado em
Começo rápido
Do zero a um agente lendo as suas conversas em poucos minutos. Sem cartão.
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.
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.
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.
Conecte o seu agente
Instinct: um toque e um envio. Claude, ChatGPT, Codex: cole
https://app.usecircles.app/api/mcpe aprove. Claude Code, Cursor, Grok: um token e um bloco de configuração (Claude Code: um comando). Detalhes.Pergunte
"O que eu perdi no grupo dos pais?" O agente chama
activity, depoiscatch_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.
- 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 com o mesmo número.
- 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.
- O seu celular pode mostrar um aviso de que um aparelho foi conectado. É o Circles.
- 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 | 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 | 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, Codex (em inglês) | 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 (em inglês) | 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 (em inglês) | 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 (em inglês) | Token na configuração MCP | Novo token, depois adicione o Circles como servidor MCP remoto com ele |
| O seu próprio agente (em inglês) | 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. A versão original em inglês também existe em Markdown (em inglês).
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.
Onde está a referência técnica?
Na página da documentação da API e do MCP, escrita para agentes: ferramentas, respostas, autenticação, a API HTTP e limites.
Continue lendo
Seu WhatsApp. Sua IA. Suas regras.
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.