Conector MCP de Hapee

Usa Hapee desde tu asistente de IA. Inicias sesión con tu propio usuario y el asistente trabaja con exactamente tus permisos: ve lo que tú ves y cambia solo lo que tú puedes cambiar.

Qué es

El conector es un servidor MCP (Model Context Protocol, el estándar abierto con el que los asistentes de IA se conectan a herramientas externas). Al agregarlo a un asistente compatible —Claude, ChatGPT, Grok Bot u otro que acepte conectores MCP remotos— puedes pedirle en lenguaje natural cosas como «muéstrame los negocios abiertos de esta semana», «crea un contacto con estos datos» o «agenda una cita para mañana a las 10».

El conector no guarda tus datos de Hapee: cada herramienta es una llamada a la API v1 de Hapee hecha con tu propia sesión. No hay claves compartidas ni URL secretas: cada persona se conecta con su usuario de Hapee.

La URL del conector

https://mcp-oauth.hapee.ai/mcp

Es la única dirección que necesitas. No lleva ninguna credencial: el inicio de sesión ocurre después, en una pantalla de Hapee.

Conectarlo a tu asistente

Cada asistente ubica la opción en un lugar distinto de su configuración, y esos menús cambian seguido, así que aquí van los pasos genéricos. En todos el procedimiento es el mismo:

1. En la configuración de tu asistente, agrega un conector personalizado (o remoto) MCP con la URL de arriba. Si te pide un nombre, usa «Hapee».
2. Si te pregunta por el tipo de autenticación, elige OAuth. No hace falta escribir ningún client ID ni secreto: el asistente se registra solo.
3. El asistente abre una ventana de Hapee. Inicia sesión con tu usuario y aprueba la conexión (ver el punto siguiente).
4. Vuelves al asistente con el conector activo. Pídele, por ejemplo, «¿quién soy en Hapee?» para comprobar con qué usuario y subcuenta estás conectado.

• Claude: agrega un conector personalizado con la URL del conector.
• ChatGPT: agrega un conector MCP remoto con la URL del conector.
• Grok Bot: agrega un conector MCP remoto con la URL del conector.

Si tu organización administra los conectores de forma centralizada, puede que la persona administradora tenga que agregarlo primero.

Inicio de sesión y consentimiento

La ventana que abre el asistente es la de beta.hapee.ai, la misma en la que entras a Hapee todos los días. Ahí inicias sesión como siempre:

• con tu correo y contraseña, más tu verificación en dos pasos si la tienes activa, o
• con Google, si así entras normalmente.

El asistente nunca ve tu contraseña: solo recibe un permiso temporal que Hapee emite cuando tú lo apruebas. Después del inicio de sesión aparece la pantalla de consentimiento, que muestra qué aplicación pide acceso, a qué dirección te va a devolver, con qué cuenta y agencia te estás conectando y qué podrá hacer. Ahí puedes quitar el permiso de escritura si quieres que el asistente solo pueda consultar.

Qué puede hacer

La conexión pide estos permisos (scopes):

Los permisos solo restan, nunca suman. Por encima de los scopes manda tu usuario real de Hapee: tu rol, tu perfil de permisos, los módulos activos y, si tu perfil es «solo lo asignado», solo lo que tienes asignado. Si tu administrador cambia los permisos de tu perfil, rigen desde la llamada siguiente; si te asigna otro rol u otro perfil, la conexión se desconecta y tienes que volver a conectar. Ninguna conexión puede hacer algo que tú no puedas hacer desde la pantalla.

La lista de herramientas que ve el asistente también se arma para ti: solo aparecen las que tus permisos permiten usar, y las de escritura solo si aprobaste hapee:write.

Agencias y subcuentas

• Equipo de una agencia (dueño, administrador o miembro del equipo de la agencia): la conexión es de tu agencia y eliges la subcuenta en cada conversación con la herramienta elegir_subcuenta. Sin argumentos te lista las subcuentas que puedes ver; con un cliente_id fija esa subcuenta para el resto de la conversación. Solo acepta subcuentas que tu usuario ya puede ver en Hapee.
• Usuario de una subcuenta (cliente): la conexión queda atada a tu subcuenta. Si tienes acceso a más de una, eliges cuál en la pantalla de consentimiento; para cambiarla, vuelve a conectar.
• Los accesos de administración de plataforma no se extienden al conector: por MCP, una cuenta de plataforma opera solo como equipo de su propia agencia.

Herramientas

El conector ofrece 255 herramientas sobre la API de Hapee, más elegir_subcuenta: 102 de consulta y 153 que modifican datos. Cuántas ves tú depende de tus permisos.

Las herramientas de administración de la agencia (tareas internas, proyectos, subcuentas, snapshots) solo aparecen para el equipo de la agencia; un usuario de subcuenta no las ve.

Herramientas que modifican

Cada herramienta declara su naturaleza con las anotaciones estándar de MCP, para que tu asistente pueda pedirte confirmación antes de ejecutar algo:

• Consulta (readOnlyHint: true): las 102 de lectura, más elegir_subcuenta. No cambian nada.
• Crean o agregan (readOnlyHint: false, destructiveHint: false): 41 herramientas, como crear una nota, una tarea o un embudo.
• Editan o borran (readOnlyHint: false, destructiveHint: true): 112 herramientas que cambian o eliminan algo que ya existe, o que actúan hacia afuera, como enviar un mensaje.

Cuánto dura la conexión

• El permiso de acceso que usa el asistente dura 1 hora.
• El asistente lo renueva solo con un permiso de renovación que dura 30 días desde su último uso y que cambia en cada renovación (el anterior deja de servir). Si alguien intentara reutilizar uno ya usado, Hapee corta la conexión completa.
• Pase lo que pase, a los 90 días desde que la aprobaste la conexión vence y tienes que iniciar sesión otra vez.

Desconectarlo

Tienes varias formas de cortar el acceso:

• Desde tu asistente: quita o desconecta el conector en su configuración. Si el asistente avisa a Hapee al desconectar, la conexión se revoca en el momento; si no, deja de usarse y vence sola en los plazos de arriba.
• Cambiando tu contraseña o tu verificación en dos pasos: desconecta automáticamente todas tus conexiones de asistentes.
• Cambios en tu usuario: si tu administrador te cambia el rol, el perfil de permisos, la agencia o la subcuenta, o desactiva tu usuario, tus conexiones se desconectan solas.
• La persona dueña de la agencia puede revocar cualquier conexión de su agencia desde la pantalla de API keys de Hapee: aparecen como «OAuth: <nombre de la aplicación>».
• Si necesitas ayuda para cortar un acceso, escríbenos a info@hapee.ai.

Límites

• Cada conexión tiene el mismo límite que cualquier credencial de la API: 100 llamadas por minuto. Si tu asistente lo supera, recibe un error temporal y basta con esperar unos segundos.
• El registro automático de aplicaciones está limitado a 20 registros por hora desde una misma dirección IP.
• Las listas devuelven hasta 100 elementos por página, igual que la API.

Detalle técnico

Para quien integra un cliente MCP propio o revisa el conector:

• Transporte: MCP sobre Streamable HTTP en la URL del conector.
• Descubrimiento: un request sin token recibe 401 con WWW-Authenticate: Bearer resource_metadata=…, que apunta a /.well-known/oauth-protected-resource en el mismo host (RFC 9728).
• Servidor de autorización: https://beta.hapee.ai, con su metadata en /.well-known/oauth-authorization-server (RFC 8414).
• OAuth 2.1: registro dinámico de clientes públicos (RFC 7591), PKCE obligatorio solo con S256, rotación del permiso de renovación con detección de reutilización, revocación (RFC 7009) y audiencia ligada al recurso (RFC 8707). Las direcciones de retorno tienen que ser https, o http solo hacia la propia máquina.
• Sesiones: cada sesión MCP queda atada a la persona que la abrió; un token de otra persona en la misma sesión se rechaza.

Privacidad

El conector solo accede a lo que tus propios permisos te dejan ver, y el servidor MCP no guarda tus datos de Hapee: lo que consulta pasa hacia tu asistente y queda sujeto a la política de privacidad de ese asistente. El detalle de qué se guarda, dónde y por cuánto tiempo está en la sección «Conector MCP para asistentes de IA» de nuestra política de privacidad.