# El WhatsApp MCP para tu número personal, alojado y listo

> Dale a Claude, ChatGPT, Codex, Instinct o cualquier cliente MCP los chats de WhatsApp que elijas. No hay nada que instalar, ni un puente en tu computadora, ni una cuenta de WhatsApp Business. Te conectas con un toque, una dirección o un token, y tu agente recibe mensajes que puede usar de inmediato: archivos listos para abrir y remitentes por nombre.

**Circles es un servidor WhatsApp MCP remoto.** Vincula tu número de WhatsApp como dispositivo vinculado, mantiene sincronizados los chats que abres y se los entrega a tu agente en `https://app.usecircles.app/api/mcp` con OAuth. Permisos por chat, archivos a pedido y envío apagado hasta que lo permitas. Free para 2 chats; Starter y Pro con precio mensual según tu país, con 14 días de Pro gratis y sin tarjeta. Datos de octubre de 2026.

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

## Circles de un vistazo

Todo lo que necesita saber un agente, o la persona que lo elige, en una tabla.

|  | Circles |
| --- | --- |
| Qué es | Un servicio alojado que vincula tu WhatsApp y entrega a tus agentes de IA los chats que elijas. Tu agente es el que piensa. |
| Tu número | Tu WhatsApp personal, como dispositivo vinculado. El mismo número y la misma app en tu celular. Sin WhatsApp Business. |
| Dirección MCP | `https://app.usecircles.app/api/mcp` (remoto, por HTTP) |
| Inicio de sesión de los agentes | OAuth 2.1 con PKCE y registro dinámico de clientes, o un token que creas tú |
| Cómo se conecta | Instinct: un toque y enviar. Claude, ChatGPT, Codex: una dirección y una aprobación. Claude Code, Cursor, Grok: un token y un bloque de configuración. |
| Herramientas | 9: allowed_chats, activity, people, catch_up, search, documents, group_members, get_media, send |
| 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. |
| Fotos y documentos | Se guardan y se entregan al agente a pedido, hasta 50 MB cada uno |
| Historial | Free: el último mes. Starter: los últimos 3 meses. Pro: todo el historial, o los últimos 90, 60 o 30 días. |
| Permisos | Por chat: oculto, lectura, o lectura y envío. Los chats ocultos no existen para los agentes. |
| Envío | En Pro. Apagado hasta que abres un chat para eso. Un límite diario para todos los agentes (por defecto 5). Nunca se reintenta solo. |
| Además | Una API HTTP con OpenAPI 3.1 para agentes que no hablan MCP |
| Precio | Free: gratis, 2 chats, solo lectura. Starter: hasta 5 chats, solo lectura. Pro: todos los chats, envío donde lo apruebes. Starter y Pro tienen precio mensual según tu país de facturación ([tabla](https://usecircles.app/es/pricing#countries)). 14 días de Pro gratis, sin tarjeta. |

## Conecta tu agente: un toque, una dirección o un token

Vinculas tu número una vez. Después cada agente se conecta de la forma que mejor le funciona, y tú lo apruebas en la página de Circles.

- **[Instinct](https://usecircles.app/es/agents/instinct)**: Tocas Conectar. WhatsApp se abre con un código de un solo uso ya escrito para Instinct. Envías. Nunca hay una clave que copiar.
- **[Claude](https://usecircles.app/es/agents/claude)**: Agregas Circles como conector personalizado en Claude y apruebas. Funciona en Claude en la web, en la app de escritorio y en el celular.
- **[ChatGPT](https://usecircles.app/es/agents/chatgpt)**: En la computadora, agregas Circles como conector con una dirección y apruebas. ChatGPT lee los chats que elegiste.
- **[Codex](https://usecircles.app/en/agents/codex)**: Agregas un servidor MCP con la dirección de Circles. Codex te pide aprobar, y listo.
- **[Claude Code](https://usecircles.app/en/agents/claude-code)**: Un comando o un bloque JSON con un token que Circles escribe por ti.
- **[Cursor](https://usecircles.app/en/agents/cursor)**: Pegas en la configuración MCP de Cursor el bloque que te da Circles.
- **[Grok](https://usecircles.app/en/agents/grok)**: Agregas Circles como servidor MCP remoto con un token.
- **[Tu propio agente](https://usecircles.app/en/whatsapp-api-personal-number)**: n8n, un script o un agente que construiste: los mismos chats por una API HTTP con una clave.

## Listo para tu agente desde la primera llamada

Circles prepara cada mensaje antes de que tu agente lo vea. Así tu agente usa su turno para responderte.

- **Archivos listos para abrir.** Fotos, PDF, documentos y videos se guardan y se anuncian con nombre, tipo y tamaño. El agente pide uno con una sola llamada cuando lo necesita. Los archivos más antiguos se piden a tu celular.
- **Remitentes por nombre.** Los remitentes aparecen con el nombre que guardaste; las listas de miembros de un grupo nunca incluyen números. Alguien que nunca guardaste puede aparecer con su número.
- **Preguntas baratas.** `activity` dice qué chats se movieron y cuánto, sin texto, así que “¿qué me perdí?” cuesta una fracción de leerlo todo.
- **Rechazos que ayudan.** Si el agente pide un chat que no está abierto, la respuesta nombra los que *sí* lo están. “No hay mensajes” y “no puedes ver ese chat” nunca se confunden.
- **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. Cuando hay transcripción, va dentro del mensaje y se puede buscar.
- **Todo el historial.** Todo lo que WhatsApp sincroniza con un dispositivo vinculado, a menudo años, más todo lo nuevo, con búsqueda en cada chat que abriste. En Free los agentes miran un mes atrás y en Starter 3 meses; en Pro, todo.

Esto recibe un agente cuando se pone al día con un grupo de padres (abreviado, con personas inventadas):

```
{
  "chat": "Padres de 3.º B",
  "messages": [
    {
      "from": "Daniela",
      "at_iso": "2026-10-26T12:12:00.000Z",
      "body": "El paseo se pasó al jueves. Los buses salen 8:15, traer gorra y almuerzo."
    },
    {
      "from": "José",
      "at_iso": "2026-10-26T13:03:00.000Z",
      "body": "Les dejo la autorización, firmarla antes del miércoles",
      "media": {
        "kind": "document",
        "filename": "autorizacion-paseo.pdf",
        "state": "available",
        "fetch_with": "get_media",
        "ref": "r1_..."
      }
    }
  ]
}
```

## Las 9 herramientas

Las herramientas aparecen solo cuando el agente puede usarlas: un agente sin permiso de envío ni siquiera ve `send`.

| Herramienta | Qué hace | Sirve para |
| --- | --- | --- |
| `allowed_chats` | Los chats abiertos a los agentes y qué se puede hacer en cada uno | Conocer todo su mundo antes de empezar |
| `activity` | Qué chats se movieron desde un momento, con cantidades y sin texto | “¿Qué me perdí?” casi gratis |
| `catch_up` | Mensajes desde un momento, en un chat o en todos, con nombres | Resúmenes y seguimientos |
| `search` | Búsqueda de texto en un chat o en todos | “¿Alguien mencionó al plomero?” |
| `people` | Con quién hablas en los chats abiertos, y dónde | Contexto sobre las personas de tu vida |
| `group_members` | Los miembros de un grupo abierto, por nombre, con los administradores marcados | “¿Quién está en la junta del edificio?” |
| `documents` | Cada PDF, archivo de Word y hoja de cálculo enviados en los chats abiertos | “Busca el contrato que mandó Andrés en junio” |
| `get_media` | Una foto, un documento, un video o un audio | Leer el archivo en sí |
| `send` | Un mensaje o un archivo, solo donde permitiste el envío, dentro del límite diario | Respuestas que tú pediste |

## ¿WhatsApp MCP alojado o en tu propio servidor?

Los servidores WhatsApp MCP de código abierto son una buena opción si quieres operar uno. Esta es la diferencia, sin rodeos.

|  | En tu servidor (código abierto) | Circles |
| --- | --- | --- |
| Instalación | Clonar un repositorio, correr un puente y un servidor MCP, escanear un QR desde tu computadora | Vincular desde tu celular y conectar tu agente con un toque, una dirección o un token |
| Funciona con la computadora apagada | No, salvo que tengas un servidor | Sí, está alojado |
| Funciona con Claude en la web y el celular | Necesita una URL pública y un inicio de sesión que construyes tú | Sí, MCP remoto con OAuth |
| Audios | Archivos de audio; la transcripción la agregas tú | Transcripción automática en hebreo e inglés |
| Qué chats ve el agente | Normalmente todos | Solo los que abres, por chat, para todos tus agentes |
| Envío | Normalmente sin restricciones | Apagado por defecto, por chat, con límite diario y registrado |
| Costo | Gratis, más tu tiempo y un servidor | Gratis para 2 chats; Starter y Pro según tu país |

Más detalle, y cuándo conviene tener tu propio servidor: [Circles frente a los servidores WhatsApp MCP propios](https://usecircles.app/en/compare/self-hosted-whatsapp-mcp).

## Tú decides qué ven tus agentes

Cada chat tiene uno de tres niveles. **Oculto**: no existe para los agentes, ni en listas, ni en búsquedas, ni siquiera nombrado en un rechazo. **Lectura**: los agentes pueden leerlo y buscar en él, y no hay forma de enviar. **Lectura y envío**: un agente también puede escribir ahí, como tú, dentro del límite diario que fijes.

Cada solicitud de un agente, incluidas las que Circles rechazó, queda en tu registro de actividad. Si desconectas un agente, su acceso termina de inmediato. [Cómo Circles deja tus chats en tus manos](https://usecircles.app/es/security).

## Preguntas y respuestas

### ¿Hay un servidor WhatsApp MCP para Claude?

Sí. Circles es un servidor WhatsApp MCP alojado que Claude agrega como conector personalizado, con una dirección y una aprobación. Funciona con tu número personal y solo con los chats que elijas.

### ¿Hay una URL de un servidor WhatsApp MCP remoto?

Sí: `https://app.usecircles.app/api/mcp`. Es un servidor MCP remoto por HTTP con OAuth 2.1, así que los clientes que aceptan conectores personalizados pueden agregarlo por su dirección. Necesitas una cuenta de Circles con tu número vinculado.

### ¿Necesito WhatsApp Business o un segundo número?

No. Circles vincula tu WhatsApp personal de siempre como dispositivo vinculado, igual que WhatsApp Web. Sigues usando WhatsApp en tu celular como siempre.

### ¿Transcribe los 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. Los mensajes de texto, las fotos y los documentos funcionan en cualquier idioma.

### ¿El agente puede enviar mensajes como si fuera yo?

Solo en los chats que abriste para envío y hasta el límite diario que fijes (por defecto 5 para todos los agentes). El envío está apagado hasta que lo actives, y un envío nunca se reintenta solo.

### ¿WhatsApp puede desconectar o bloquear mi número?

Cualquier cliente no oficial, como un dispositivo vinculado que no hizo WhatsApp, queda fuera de sus términos, y nadie puede prometer que un dispositivo vinculado nunca se cierre. Circles lee por defecto, limita los envíos, nunca envía mensajes masivos y conecta a cada cliente por una dirección IP dedicada que no comparte con nadie.

### ¿Cuánto cuesta un WhatsApp MCP?

Circles tiene tres planes: Free, gratis para 2 chats; Starter, hasta 5 chats; y Pro, todos los chats y envío. El precio de Starter y Pro depende de tu país de facturación ([tabla por país](https://usecircles.app/es/pricing#countries)). Empiezas con 14 días de Pro gratis, sin tarjeta. La suscripción de tu agente se paga aparte.

## Sigue leyendo

- [Instinct](https://usecircles.app/es/agents/instinct): Un toque y enviar, sin claves.
- [Claude](https://usecircles.app/es/agents/claude): Una dirección y una aprobación.
- [Precios](https://usecircles.app/es/pricing): Free, Starter o 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