Guías
Guías de Circles
Cómo configurar Circles, paso a paso: vincula tu WhatsApp, elige qué chats ven tus agentes y conecta tu agente. La referencia técnica, escrita para los propios agentes, está en su propia página.
Circles conecta los chats de WhatsApp que elijas con el agente de IA que elijas. Vinculas tu propio número como dispositivo vinculado, abres los chats que un agente puede leer (y, si quieres, donde puede enviar) y conectas el agente por dirección o con un token. Cada conexión se corta con un toque. A octubre de 2026.
Actualizado el
Inicio rápido
De cero a un agente leyendo tus chats en pocos minutos.
Elige tu asistente y escribe tu número
En usecircles.app, elige tu asistente y escribe tu número de WhatsApp. Te llega un enlace por WhatsApp desde el número de Circles; funciona una vez, durante diez minutos. Al tocarlo se abre la página para vincular, con la sesión ya iniciada. No hay tarjeta ni paso de pago.
Vincula tu WhatsApp
Vincula tu número como dispositivo vinculado: un código que escribes en el celular o un QR que escaneas desde una computadora. Desde ese momento corren tus 14 días de Pro gratis. Detalles.
Revisa tus chats
En un número nuevo, los grupos y los chats individuales se abren para lectura por defecto. Oculta lo que un agente nunca debe ver, y abre un chat para envío solo donde quieras respuestas. Detalles.
Conecta tu agente
Instinct: un toque y enviar. Claude, ChatGPT, Codex: pega
https://app.usecircles.app/api/mcpy aprueba. Claude Code, Cursor, Grok: un token y un bloque de configuración (Claude Code: un comando). Detalles.Pregunta
“¿Qué me perdí en el grupo de padres?” El agente llama a
activity, después acatch_up, y responde.
Para un cliente que usa un archivo de configuración, esta es toda la instalación:
# 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_..." }
}
}
}Vincula tu WhatsApp
Circles vincula tu número personal de siempre como dispositivo vinculado, el mismo mecanismo que WhatsApp Web. Tu celular sigue funcionando como siempre, y las personas con las que hablas no notan ningún cambio. No necesitas WhatsApp Business ni un segundo número.
- Elige tu asistente y escribe tu número de WhatsApp. Circles te manda un enlace desde su propio número de WhatsApp. No hay contraseña. Para volver más adelante, inicia sesión en app.usecircles.app con tu número.
- Elige cómo vincular. En el celular: Circles te muestra un código; en WhatsApp ve a Ajustes, Dispositivos vinculados, Vincular un dispositivo, elige vincular con el número de teléfono y escribe el código. En una computadora: escanea el QR desde la pantalla de Dispositivos vinculados de WhatsApp. Los nombres exactos de los menús pueden variar según tu teléfono.
- Tu celular puede mostrar un aviso de que se vinculó un dispositivo. Es Circles.
- El historial llega en unos 5 a 15 minutos. Los mensajes nuevos llegan a medida que se envían.
Un número se vincula solo cuando está verificado como tuyo: tocaste un enlace que se le envió. Cada cliente se conecta por una dirección IP dedicada que no comparte ningún otro cliente; si no hay una lista, la vinculación espera hasta que la haya. Nunca usa una dirección compartida.
Historial. Todo el historial por defecto: todo lo que WhatsApp entrega a un dispositivo vinculado (a menudo años) más todo lo nuevo, guardado mientras el número esté vinculado. WhatsApp decide cuánto del historial de tu celular envía. Puedes limitarlo a los últimos 90, 60 o 30 días; una ventana más corta borra lo que queda fuera, y ampliarla después solo aplica hacia adelante.
Archivos. Fotos, documentos, videos y audios de unos 25 días desde el mensaje se descargan en segundo plano. Los más antiguos quedan como on_request: cuando un agente pide uno, tu celular lo vuelve a subir, así que tiene que estar en línea.
Audios. La transcripción automática de audios está disponible en hebreo e inglés. La de audios en español todavía no está verificada.
Desvincular quita el dispositivo de WhatsApp y, cuando WhatsApp lo confirma, borra todo lo guardado de ese número. Tu configuración y tus elecciones por chat quedan para cuando vuelvas a vincular.
Elige qué ven los agentes
Los permisos son de los chats: todos los agentes que conectas ven los mismos chats abiertos, dentro de lo que permite el inicio de sesión de cada uno.
| Opción | Qué hace | Por defecto |
|---|---|---|
| Oculto | El chat no existe para los agentes: no aparece, no se puede buscar, nunca se nombra, ni en un rechazo ni en el registro. Circles puede seguir guardándolo. | El valor del número para números vinculados por primera vez antes del 2026-09-29 |
| Lectura | Los agentes lo leen, buscan en él y abren sus archivos. No hay forma de enviar. | Grupos y chats individuales en un número nuevo |
| Lectura y envío | Los agentes también pueden enviar ahí, como tú, dentro del límite diario. Circles te avisa antes que los mensajes se verán como si los hubieras enviado tú. | Nunca por defecto |
| Nunca guardar | No se escribe nada del chat, y no se puede abrir | Apagado |
| Incluir chats individuales | Apagado: ningún agente ve ningún chat uno a uno, sea cual sea su nivel | Encendido para números vinculados por primera vez desde el 2026-10-27 |
| Valor por defecto del número | El nivel que recibe un chat cuando aparece por primera vez. Nunca cambia lo que elegiste a mano. | Lectura |
| Límite diario de envíos | Mensajes por día para todo el número, sumando todos los agentes, contados por día UTC | 5 (elige 5, 10, 20 o sin límite) |
| Ventana de historial | Hasta dónde guarda mensajes Circles | Todo el historial (o 90, 60, 30 días) |
Un grupo nuevo queda oculto hasta que WhatsApp entrega su nombre. Un chat que abres hoy devuelve también su historial anterior. Un chat archivado sigue siendo legible y se marca con archived: true. Empezar un chat con alguien nuevo (por número o por contacto guardado) solo es posible cuando el valor por defecto del número es lectura y envío.
En Free, tus agentes ven 2 chats, y en Starter hasta 5. Si al terminar la prueba quedas en Free, eliges esos chats tú; si no, quedan los que más usaste. No se borra nada.
Conecta un agente
Cada agente se conecta de la forma que mejor le funciona. Todas las conexiones aparecen en la página de agentes de Circles, donde un toque las desconecta.
| Agente | Cómo se conecta | Qué haces |
|---|---|---|
 Instinct | Un código de un solo uso enviado desde WhatsApp | Toca Conectar Instinct; WhatsApp se abre con el mensaje escrito; envíalo. Nunca hay una clave. |
 Claude | Por dirección, OAuth | Agrega un conector personalizado con https://app.usecircles.app/api/mcp, conecta y aprueba en la página de Circles |
 ChatGPT, Codex (en inglés) | Por dirección, OAuth | Agrega un servidor MCP o un conector personalizado con la dirección y aprueba. ChatGPT se configura en la computadora. |
 Claude Code (en inglés) | Token en la configuración MCP | Nuevo token, y luego el comando claude mcp add --transport http de arriba (recomendado), o pega Copiar configuración en .mcp.json con "type": "http" |
 Cursor (en inglés) | Token en la configuración MCP | Nuevo token, Copiar configuración, y pégala en la configuración MCP de Cursor. Cursor no puede conectarse por dirección. |
 Grok (en inglés) | Token en la configuración MCP | Nuevo token, y agrega Circles como servidor MCP remoto con él |
| Tu propio agente (en inglés) | API HTTP con una clave, o MCP con un token | Nuevo token, elige API, y dale al agente las instrucciones y luego la clave, en dos mensajes |
No existen botones de “Agregar a Claude” ni “Agregar a Cursor”. Conectar por dirección es el camino de un paso para Claude, ChatGPT y Codex. Un token es el camino para los clientes que usan un archivo de configuración.
Un token es para un agente, y el registro de actividad muestra el nombre que le das. Cuando le das una clave a un agente de chat, Circles te da dos mensajes: primero las instrucciones, después la clave sola, para que la clave termine solo en los secretos del agente.
Para agentes: la documentación de la API y MCP
La referencia técnica tiene su propia página, escrita para los propios agentes: las 9 herramientas MCP y sus parámetros, cómo se ven las respuestas y los rechazos, OAuth y tokens, la API HTTP, cada límite y el registro de cambios. Un agente que está conectado, o a punto de estarlo, puede leerla para saber qué ofrece Circles y cómo usarlo bien.
Preguntas y respuestas
¿Cuál es la URL del servidor MCP de Circles?
https://app.usecircles.app/api/mcp. Pégala en Claude, ChatGPT o Codex y aprueba en la página de Circles, o úsala con un token en un cliente que use un archivo de configuración.
¿Necesito tarjeta para empezar?
No. Tienes 14 días de Pro gratis, sin tarjeta, desde que vinculas WhatsApp. Cómo funciona la prueba.
¿Dónde está la referencia técnica?
En la página de documentación de la API y MCP, escrita para agentes: herramientas, respuestas, autenticación, la API HTTP y los límites.
Tu WhatsApp. Tu IA. Tus reglas.
14 días de Pro gratis, sin tarjeta. Vincula tu número, elige los chats y conecta la IA que ya usas: Instinct con un toque, Claude, ChatGPT y Codex con una dirección.