Integraciones · Model Context Protocol

Servidor MCP de HellouOne: conecta Claude, ChatGPT y Cursor a tu bandeja de WhatsApp

Sí, HellouOne tiene servidor MCP. Corre en mcp.hellou.ai, cualquier cliente MCP se conecta iniciando sesión o con un token personal, y el asistente trabaja con tus conversaciones, contactos, bandejas, agentes IA, informes y ajustes con exactamente tus permisos.

Leer la documentación MCP →Crear cuenta

Qué es

¿Qué es el servidor MCP de HellouOne?

El Model Context Protocol (MCP) es el estándar abierto con el que los asistentes de IA usan herramientas de otros productos. HellouOne corre un servidor MCP remoto: en vez de copiar chats en un asistente, el asistente se conecta a tu cuenta y actúa ahí, como el administrador que lo conectó.

Una sola URL para todas las cuentas: https://mcp.hellou.ai/mcp (Streamable HTTP). La credencial decide qué cuenta ve.
Funciona con Claude (claude.ai, Claude Code, Claude Desktop), ChatGPT, Cursor y cualquier otro cliente MCP.
Inicio de sesión con OAuth 2.1 desde asistentes alojados, o token personal hcm_ desde la CLI y clientes de escritorio.
Leer es el comportamiento por defecto. Los cambios se activan por cuenta y por token, y cada cambio queda en el registro de auditoría.

Herramientas

¿Qué puede hacer un asistente en tu cuenta?

El servidor lista todas las herramientas que la conexión puede usar, marca cuáles solo leen y cuáles cambian datos, y devuelve el texto de los clientes como datos que el asistente nunca debe seguir como instrucciones.

Conversaciones

Lectura + cambios

Leer conversaciones de WhatsApp, chat web y otros canales, filtrarlas, responder, asignar, etiquetar, cerrar y reabrir.

Contactos

Lectura + cambios

Buscar y leer contactos y sus atributos; crearlos, actualizarlos y etiquetarlos.

Bandejas y equipos

Lectura + cambios

Ver bandejas, agentes y equipos, miembros y reglas de asignación; añadir o quitar miembros.

Agentes IA y conocimiento

Lectura + cambios

Listar los agentes IA, sus documentos de conocimiento y guías; añadir documentos y reprocesarlos.

Campañas, plantillas y Flows

Lectura + cambios

Listar plantillas y Flows de WhatsApp, previsualizar una audiencia y su costo, crear, pausar o cancelar campañas.

Informes

Lectura

Informes de agentes, equipos, conversaciones, sentimiento y llamadas, métricas en vivo y resumen de la cuenta.

Automatización

Lectura + cambios

Respuestas predefinidas, macros, etiquetas, atributos personalizados y reglas de automatización.

Marketing de Facebook

Lectura + cambios

Cuentas publicitarias, formularios y leads de Facebook con los resultados de sus campañas.

Ajustes

Lectura + cambios

Perfil del negocio, horario de atención, apariencia del widget y los ajustes de cada bandeja.

Configuración

¿Cómo se conecta un asistente?

Tres formas, según el cliente. La referencia completa, incluido el prompt con el que el asistente se configura solo, está en la documentación.

1Sesión

claude.ai, ChatGPT o Cursor: añade la URL e inicia sesión

Añade https://mcp.hellou.ai/mcp como conector personalizado con el nombre HellouOne. El asistente descubre el inicio de sesión por sí mismo, abre la página de consentimiento de HellouOne y un administrador elige la cuenta y decide si el asistente puede hacer cambios. No se pega ningún token.

{
  "mcpServers": {
    "hellouone": { "url": "https://mcp.hellou.ai/mcp" }
  }
}

2Token

Claude Code y otras CLI: un comando con un token personal

Un administrador crea el token en Ajustes → Integraciones → Clientes IA (MCP), le pone el nombre del cliente, elige la caducidad y, si quiere, permite cambios. El token empieza por hcm_ y se muestra una sola vez.

claude mcp add --transport http hellouone https://mcp.hellou.ai/mcp \
  --header "Authorization: Bearer hcm_..."

3Pide

O pega el prompt de configuración y deja que el agente lo haga

La página de documentación y la pantalla de Clientes IA traen un prompt listo. Pégalo en Claude Code, Cursor, claude.ai o ChatGPT: el agente se conecta solo, lista sus herramientas por área y dice cuáles cambian datos.

Mantén los tokens fuera del chat, de los logs y de cualquier archivo que no sea tu configuración MCP. Las apps conectadas se ven, y se desconectan, en Ajustes → Integraciones → Clientes IA (MCP).

Leer la documentación MCP →

Control

¿Quién controla lo que puede hacer el asistente?

El servidor está hecho para que conectar un asistente nunca amplíe el acceso de nadie.

El asistente actúa como el administrador que lo conectó, con los permisos de esa persona y nada más.
Las herramientas que cambian datos solo se ofrecen si la cuenta tiene activado Permitir cambios y el token o el inicio de sesión recibió ese permiso.
Cada herramienta que cambia datos viene marcada como tal, así que un asistente bien hecho pregunta antes de ejecutarla. Cada cambio queda en el registro de auditoría de la cuenta.
OAuth 2.1 con PKCE, registro dinámico de clientes y tokens de acceso de una hora que se renuevan con rotación. Los tokens se emiten solo para el endpoint MCP.
El texto de los clientes llega dentro de etiquetas <account_data>: son datos escritos por clientes y agentes, nunca instrucciones para el asistente.
Límite de 120 solicitudes por minuto por token; el token de alguien que deja de ser administrador deja de funcionar.

FAQ

Preguntas sobre el servidor MCP

¿HellouOne tiene servidor MCP?

Sí. HellouOne corre un servidor MCP público y remoto en https://mcp.hellou.ai/mcp. Claude, ChatGPT, Cursor y cualquier otro cliente MCP pueden conectarse y trabajar con las conversaciones, contactos, bandejas, agentes IA, campañas, informes y ajustes de una cuenta de HellouOne.

¿Qué asistentes de IA se pueden conectar?

Cualquier cliente que hable MCP sobre Streamable HTTP: claude.ai y ChatGPT (como conector personalizado con inicio de sesión), Cursor, Claude Code, Claude Desktop a través de un puente de servidor remoto, y tus propios agentes hechos con los SDK de MCP.

¿Un asistente puede enviar mensajes de WhatsApp por MCP?

Sí, cuando la cuenta permite cambios y el token o el inicio de sesión recibió ese permiso. Responder dentro de una conversación abierta, asignarla o etiquetarla son herramientas de cambio; el asistente las ve marcadas así y debe confirmar contigo antes de ejecutarlas. Fuera de la ventana de 24 horas WhatsApp solo permite plantillas aprobadas, que son las que usan las herramientas de campañas.

¿Qué plan incluye el servidor MCP?

La API pública, el SDK y los webhooks están disponibles desde el plan Starter. Un administrador activa los clientes IA en Ajustes → Integraciones; si tu cuenta no muestra la opción, escríbenos desde la app.

¿Es lo mismo que el servidor MCP de WhatsApp de Meta?

No. El servidor de Meta ayuda a un agente de programación a crear una cuenta de WhatsApp Business y registrar un número en la Cloud API. El de HellouOne le da al asistente acceso al trabajo diario de una cuenta que ya funciona en HellouOne: las conversaciones, los contactos, el equipo y los informes.

¿Cuál es la diferencia entre MCP y la API REST?

La API REST y los webhooks son para software que escribes y operas tú. MCP es para asistentes con los que una persona conversa: el asistente descubre las herramientas, decide cuál usar y pregunta antes de cambiar algo. Ambos están documentados en one.hellou.ai/docs.