Conectar Hiveflow a Claude para tu organización (managed auth)
Guía para administradores que despliegan el conector de Hiveflow en una organización Claude Team o Enterprise — endpoints OAuth, credenciales, pasos en la consola, inicio de sesión, revocación y seguridad.
Esta guía es para el Owner o Primary Owner de una organización Claude Team o Enterprise que quiere poner Hiveflow a disposición de todos los miembros desde la consola de administración, en vez de que cada persona agregue el conector por su cuenta. Para la configuración personal (claude.ai, Claude Desktop, Claude Code y el plugin) ve a Hiveflow en Claude y Claude Code.
Todo lo que sigue describe lo que el servidor MCP de Hiveflow soporta hoy. La última sección lista lo que todavía no está disponible y qué pedirle a Hiveflow.
A qué accede el conector
El conector es el servidor MCP alojado en https://mcp.hiveflow.ai. Cuando un miembro se conecta, Claude puede actuar sobre su cuenta de Hiveflow a través de estos grupos de herramientas:
| Área | Qué puede hacer Claude |
|---|---|
| Flujos | Listar flujos con su estado de ejecución, inspeccionar nodos y aristas, crear flujos, ejecutar uno, y activarlo, pausarlo o detenerlo. |
| Agentes | Listar agentes y qué hace cada uno, leer el objetivo, la conversación y la auditoría de un agente, hablar con él, y pausar o reanudar agentes. |
| Aprobaciones | Listar las acciones que flujos y agentes esperan que alguien apruebe (human in the loop) y aprobarlas o rechazarlas. |
| Tableros kanban y workers | Listar tableros, leer columnas y tarjetas, crear, mover y comentar tarjetas, y ver qué workers están conectados. |
| Apps | Leer y escribir en las apps integradas: contactos y tareas del CRM, conversaciones, dashboards e inventario. |
| Tablas de datos | Listar tablas, consultar filas, crear tablas, y escribir, actualizar o borrar filas. |
| Organizaciones y workspaces | Listar a cuáles pertenece el miembro y acotar cualquier operación a uno de ellos. |
| Docs | Leer la referencia viva de la API, para que Claude responda preguntas sobre Hiveflow. |
Cada herramienta viene anotada: las de solo lectura están marcadas así, y las que cambian datos (ejecutar un flujo, mover una tarjeta, escribir filas) están marcadas como mutantes, de modo que Claude pregunta antes de actuar. Nada en el conector corre como cuenta de servicio: cada llamada se ejecuta como el miembro que se conectó, con sus roles y permisos de organización.
Endpoints OAuth
Hiveflow opera su propio servidor de autorización OAuth 2.1 en el mismo host que el endpoint MCP. Claude descubre todo esto solo; la tabla está aquí para tu registro, reglas de firewall y revisión de seguridad.
| Propósito | URL |
|---|---|
| Endpoint MCP (la URL que ingresas en Claude) | https://mcp.hiveflow.ai |
| Metadatos del recurso protegido (RFC 9728) | https://mcp.hiveflow.ai/.well-known/oauth-protected-resource |
| Metadatos del servidor de autorización (RFC 8414) | https://mcp.hiveflow.ai/.well-known/oauth-authorization-server |
| Descubrimiento OpenID (mismo documento) | https://mcp.hiveflow.ai/.well-known/openid-configuration |
| Endpoint de autorización | https://mcp.hiveflow.ai/oauth/authorize |
| Endpoint de token | https://mcp.hiveflow.ai/oauth/token |
| Registro dinámico de clientes (RFC 7591) | https://mcp.hiveflow.ai/oauth/register |
| UserInfo | https://mcp.hiveflow.ai/oauth/userinfo |
Detalles de protocolo que el servidor publica en sus metadatos:
- Grant types:
authorization_codeyrefresh_token. - PKCE: obligatorio, solo
S256. - Autenticación del cliente:
none— todos los clientes son públicos, así que nunca hay client secret. - Scopes:
mcp,openid,email,profile. Los scopesopenid/email/profilesolo exponen el correo verificado y el nombre del miembro en el endpoint UserInfo; no amplían lo que el token puede hacer. Eso lo deciden los roles del miembro en Hiveflow. - Redirect URIs aceptadas para Claude:
https://claude.ai/api/mcp/auth_callback(claude.ai, Desktop, móvil, Cowork) y loopbackhttp://localhost/http://127.0.0.1en cualquier puerto (Claude Code). - Vida de los tokens: los access tokens duran 7 días; los refresh tokens duran 30 días y se rotan en cada uso. Claude renueva en silencio, así que los miembros no ven una pantalla de inicio de sesión mientras el refresh token sea válido.
Si tu red restringe el tráfico saliente de Anthropic, tanto el endpoint MCP como los endpoints OAuth están en mcp.hiveflow.ai; el rango de salida de Anthropic está publicado en la referencia de direcciones IP de Anthropic.
Cómo se identifica Claude (credenciales)
Al agregar el conector, el diálogo de Claude pregunta cómo debe identificarse ante el servidor de autorización de Hiveflow. Dos de las tres opciones funcionan con Hiveflow hoy:
Register automatically (recomendada). Claude se registra a sí mismo mediante Dynamic Client Registration la primera vez que se conecta, y Hiveflow emite un client_id público en el momento. No hay nada que crear ni copiar. Hiveflow omite la pantalla de consentimiento para la URL de callback conocida de Claude, así que los miembros solo ven la pantalla de inicio de sesión de Hiveflow.
Use your own OAuth client (opcional). Hiveflow no tiene una pantalla de administración de clientes OAuth, pero el endpoint de registro es público y devuelve un client_id estable que puedes fijar en la consola de Claude. Regístralo desde cualquier terminal:
curl -s -X POST https://mcp.hiveflow.ai/oauth/register \
-H "Content-Type: application/json" \
-d '{
"client_name": "Claude — Acme Corp",
"redirect_uris": ["https://claude.ai/api/mcp/auth_callback"]
}'La respuesta contiene "client_id": "mcp_…". Ingresa ese valor como OAuth client ID y deja el client secret vacío — Hiveflow solo soporta clientes públicos, y un secret sería rechazado. El nombre de cliente que elijas es el que verán los miembros si alguna vez aparece una pantalla de consentimiento.
Use Claude's published identity (Client ID Metadata Document) no está soportada por Hiveflow todavía; elegirla hará fallar la conexión. Ver Qué no está disponible todavía.
Agregar el conector en la consola de administración de Claude
La disposición exacta del diálogo varía según la organización; Anthropic la documenta en Add a connector that isn't in the directory. Los pasos para Hiveflow:
- Entra a Organization settings → Connectors (claude.ai/admin-settings/connectors). Necesitas ser Owner o Primary Owner, o en Enterprise, tener un rol personalizado que pueda administrar las bibliotecas de la organización.
- Si Hiveflow aparece en el directorio de conectores, agrégalo desde ahí. Si no, selecciona Add → Custom (elige Web si pide un tipo) e ingresa el nombre
Hiveflowy la URL:https://mcp.hiveflow.ai - En Authentication, elige Sign in now (cada miembro autoriza antes del primer uso) o Sign in when needed (Claude se conecta sin credenciales y pide iniciar sesión la primera vez que una herramienta necesita la cuenta). Ambas funcionan con Hiveflow; el servidor responde a las llamadas sin autenticar con
401y el puntero de metadatos que Claude espera. - En OAuth client, elige Register automatically, o Use your own OAuth client con el
client_idde la sección anterior y el secret vacío. No agregues nada en Request headers: el conector usa tokens OAuth por miembro, no una API key compartida. - Pulsa Add. El conector aparece ahora para los miembros en Customize → Connectors con la etiqueta Custom (o como el listado de Hiveflow si lo agregaste desde el directorio).
La configuración de autenticación no se puede editar después de agregar el conector. Para cambiarla, elimina el conector y agrégalo de nuevo; los miembros tendrán que reconectarse.
Cómo inician sesión los miembros
Cada miembro se conecta con su propia cuenta de Hiveflow — el conector nunca comparte una identidad entre toda la organización.
- El miembro abre Customize → Connectors, busca Hiveflow y pulsa Connect (o, con Sign in when needed, Claude se lo pide la primera vez que llega a una herramienta de Hiveflow).
- Se abre la pantalla de inicio de sesión de Hiveflow. Puede usar Google, GitHub, correo y contraseña (seguido del código de un solo uso que llega por correo, el mismo segundo factor de la app) o una API key personal de Profile → API Keys.
- Vuelve a Claude. Las herramientas de Hiveflow aparecen en el menú de herramientas del chat, acotadas a las organizaciones y workspaces a los que pertenece su cuenta de Hiveflow.
Si un miembro inicia sesión con una API key que tiene scopes (read, write, execute), el conector hereda esos límites: una key con solo read le da a Claude una vista de solo lectura de Hiveflow, una forma sencilla de pilotear el conector con un equipo antes de permitir acciones.
Los miembros necesitan una cuenta de Hiveflow que pertenezca a tu organización de Hiveflow. Invítalos primero desde la configuración de la organización en Hiveflow (Organizaciones y workspaces); el conector no crea cuentas.
Revocar el acceso
Una conexión tiene dos lados, y cualquiera de los dos la corta:
Desde Claude
- Un miembro desconecta su propia cuenta en Customize → Connectors → Hiveflow → Disconnect.
- Un Owner elimina el conector para toda la organización en Organization settings → Connectors → Remove. Claude descarta los tokens de todos los miembros.
- Quitar a un miembro de la organización de Claude le quita el acceso al conector junto con el resto de Claude.
Desde Hiveflow
- Quita al miembro de tu organización de Hiveflow. Su token sigue funcionando para su cuenta personal, pero deja de ver de inmediato los flujos, tableros, agentes y datos de la organización, porque cada llamada se autoriza contra la membresía y los roles vigentes.
- Cambia o restablece la contraseña del miembro. Hiveflow revoca todas las sesiones de conector de esa cuenta (access y refresh tokens) cuando cambia la contraseña; el miembro tiene que conectarse de nuevo.
- Elimina la API key si el miembro inició sesión con una. La sesión de conector ligada a esa key deja de poder renovarse al instante.
- Suspende la cuenta. Una cuenta de Hiveflow suspendida o desactivada no puede obtener ni renovar tokens de conector.
Cerrar sesión en la app web de Hiveflow no desconecta a Claude; es a propósito, para que los asistentes que un miembro conectó intencionalmente sobrevivan a un logout normal.
Qué no está disponible todavía
El Enterprise Managed Auth ("auto-connect") de Claude permite que una organización conecte a sus miembros sin pantalla de inicio de sesión: Claude envía al servidor de autorización de Hiveflow una aserción de identidad firmada (por tu proveedor de identidad, como Okta, o emitida por Claude) en lugar de correr el flujo OAuth interactivo. Anthropic describe los requisitos en Enterprise Managed Auth for connectors y el lado del administrador en Auto-connect your organization's apps to Claude.
Hiveflow todavía no soporta auto-connect. En concreto, el servidor de autorización de Hiveflow no acepta el grant urn:ietf:params:oauth:grant-type:jwt-bearer, no tiene un ajuste para registrar una URL de emisor de confianza por organización, y no anuncia soporte para el Client ID Metadata Document de Claude, que Enterprise Managed Auth exige en lugar del registro dinámico. Si abres Managed authorization → Set up en el conector de Hiveflow dentro de la consola de Claude, la prueba de conexión fallará.
Lo que sí puedes hacer hoy es el despliegue estándar descrito arriba: el Owner agrega el conector una vez y cada miembro inicia sesión con su propia cuenta de Hiveflow.
Si tu organización necesita auto-connect, escribe al soporte de Hiveflow y pide:
- soporte de Enterprise Managed Auth en
mcp.hiveflow.ai(grant JWT bearer y emisor de confianza por organización), indicando si necesitas aserciones IdP-managed (Okta) o Claude-issued; - un ajuste de organización en Hiveflow donde un administrador ingrese la URL de emisor que Claude muestra durante la configuración;
- que el listado de Hiveflow en el directorio quede marcado como compatible con auto-connect.
Esta página se actualizará cuando eso esté disponible.
Seguridad
- OAuth 2.1 con PKCE. Cada autorización usa PKCE
S256, códigos de autorización de un solo uso (10 minutos), refresh tokens de un solo uso rotados en cada uso, y coincidencia exacta de la redirect URI; se rechazan las redirecciones sin HTTPS salvo loopback para Claude Code. - Tokens por miembro. Un token pertenece a un único usuario de Hiveflow y lleva una marca que lo restringe al endpoint MCP y a UserInfo; no puede reutilizarse contra la API REST de Hiveflow ni contra la app web. Nada de lo que haga un conector cuenta como sesión humana en la app.
- Roles de organización respetados. Cada llamada se autoriza contra las organizaciones, workspaces y permisos de rol vigentes del miembro (
view_resources,execute_flows,edit_resources, …). Un miembro que no puede ejecutar flujos en la app tampoco puede hacerlo desde Claude. - Consentimiento y protección contra phishing. Hiveflow muestra una pantalla de consentimiento con el nombre del cliente y el host al que se envía el código, y solo la omite para las URLs de callback conocidas de Claude y ChatGPT. Los intentos de inicio de sesión tienen límite por IP y por cuenta; el inicio con contraseña exige el código de un solo uso enviado por correo.
- Auditoría. Los registros de clientes, autorizaciones, emisiones y renovaciones de tokens se escriben en la auditoría de Hiveflow.
- Sin secretos compartidos. No hay client secret, API key ni cuenta de servicio que guardar del lado de Claude. No se usan credenciales en request headers.
- Efectos reales. Un flujo ejecutado desde un chat envía los correos o mensajes que contiene y consume créditos de ejecución como cualquier otra ejecución. Pide a los miembros que mantengan activas las aprobaciones de herramientas para las herramientas mutantes.
Solución de problemas
"Authorization with the MCP server failed" justo después de agregar el conector. Revisa que la opción de cliente OAuth sea Register automatically o un client_id de /oauth/register con el secret vacío. Use Claude's published identity no está soportada.
A un miembro le falta una organización de Hiveflow. Su cuenta de Hiveflow no es miembro de ella, o no es la organización activa. Pídele a Claude que liste las organizaciones y acote la petición, o invita al miembro en Hiveflow.
"Account mismatch" en Claude Desktop. El navegador tiene una sesión con una cuenta de Claude distinta a la de la app. Cierra sesión en el navegador, entra con la misma cuenta y reconecta.
El conector aparece desconectado tras un mes sin uso. El refresh token expiró (30 días). El miembro pulsa Connect de nuevo.
Hiveflow en Claude y Claude Code
Conecta Hiveflow a Claude con el conector MCP, o instala el plugin de Claude Code para ejecutar flujos, trabajar tableros kanban y supervisar workers desde tu terminal.
Conecta un número de WhatsApp a HiveFlow y convierte cualquier flow en un bot: sesión por QR, opción de API oficial, herramientas, contexto por número y human takeover.