# 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](https://usecircles.app/es/api-mcp-docs).

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

Fuente: https://usecircles.app/es/docs · Actualizado el 2026-10-31

## Inicio rápido

De cero a un agente leyendo tus chats en pocos minutos.

1. **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.
2. **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](#link).
3. **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](#chats).
4. **Conecta tu agente**: Instinct: un toque y enviar. Claude, ChatGPT, Codex: pega `https://app.usecircles.app/api/mcp` y aprueba. Claude Code, Cursor, Grok: un token y un bloque de configuración (Claude Code: un comando). [Detalles](#connect).
5. **Pregunta**: “¿Qué me perdí en el grupo de padres?” El agente llama a `activity`, después a `catch_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.

1. 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](https://app.usecircles.app) con tu número.
2. 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.
3. Tu celular puede mostrar un aviso de que se vinculó un dispositivo. Es Circles.
4. 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](https://usecircles.app/es/agents/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](https://usecircles.app/es/agents/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](https://usecircles.app/es/agents/chatgpt), [Codex](https://usecircles.app/en/agents/codex) | 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](https://usecircles.app/en/agents/claude-code) | 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](https://usecircles.app/en/agents/cursor) | 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](https://usecircles.app/en/agents/grok) | Token en la configuración MCP | Nuevo token, y agrega Circles como servidor MCP remoto con él |
| [Tu propio agente](https://usecircles.app/en/whatsapp-api-personal-number) | 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.

[Documentación de la API y MCP de Circles](https://usecircles.app/es/api-mcp-docs).

## 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](https://usecircles.app/es/pricing#trial).

### ¿Dónde está la referencia técnica?

En la página de [documentación de la API y MCP](https://usecircles.app/es/api-mcp-docs), escrita para agentes: herramientas, respuestas, autenticación, la API HTTP y los límites.

## Sigue leyendo

- [WhatsApp MCP, de un vistazo](https://usecircles.app/es/whatsapp-mcp): Qué es Circles y en qué se diferencia de tener tu propio servidor.
- [Seguridad y control](https://usecircles.app/es/security): Niveles por chat, aprobación, registro de actividad y los riesgos.
- [Precios](https://usecircles.app/es/pricing): Free, Starter y Pro, con precio según tu país.

---

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. Empieza aquí: https://usecircles.app/start?lang=es