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.
Hiveflow habla MCP, así que Claude puede operar tu workspace conversando: listar y ejecutar flujos, leer y editar tableros kanban, y revisar los workers locales que convierten tarjetas en pull requests. Hay dos caminos, y ambos se autorizan con tu propia cuenta de Hiveflow.
Opción 1 — Agregar el conector (claude.ai, Desktop, móvil)
- Entra a Settings → Connectors → Add custom connector.
- Pega la URL:
https://mcp.hiveflow.ai - Presiona Connect. Se abre la pantalla de inicio de sesión de Hiveflow — entra con correo y contraseña, Google, GitHub, o una API key de tu perfil.
- Autoriza. Las herramientas aparecen en el menú de herramientas del chat, bajo Hiveflow.
No hay nada más que configurar: la autorización es OAuth 2.1, así que ninguna clave queda en un archivo de configuración, y puedes revocarla cuando quieras desde tu cuenta de Hiveflow.
En un plan Claude Team o Enterprise, un Owner puede agregar el conector una sola vez para toda la organización — ver Conectar Hiveflow a Claude para tu organización.
Opción 2 — Instalar el plugin de Claude Code (terminal)
El plugin trae la misma conexión, más comandos y conocimiento sobre cómo funciona Hiveflow:
/plugin marketplace add hiveflowai/hiveflow-claude-plugin
/plugin install hiveflow@hiveflowLa primera vez se abre el navegador para autorizar, igual que arriba.
/hiveflow:status | Resumen de flujos, tableros y workers, y qué requiere atención |
/hiveflow:new-flow <qué debe hacer> | Diseña un flujo siguiendo las convenciones de tu cuenta y lo crea |
También incluye skills que se cargan solas cuando hacen falta: tipos de nodo y puntos de entrada al construir flujos, cómo las columnas entregan trabajo a los workers, y cómo manejar el CLI de Hiveflow en tu máquina.
Qué puede hacer Claude una vez conectado
Flujos — listarlos con su estado de ejecución, inspeccionar nodos y aristas, crear nuevos, ejecutar uno cuando lo pidas, y activarlo, pausarlo o detenerlo.
Tableros kanban — listar tableros, leer columnas y tarjetas, crear tarjetas, moverlas entre columnas y agregar comentarios.
Workers — ver qué agentes están conectados a un tablero, si están pausados y cuándo reportaron por última vez.
Agentes — listar tus agentes de IA y qué está haciendo cada uno (trabajando, esperando tu aprobación, programado), leer el objetivo, los miembros del equipo y los pendientes de un agente, hablar con él en la misma conversación que ves en la app, leer su auditoría, y pausar o reanudar un agente — o todos a la vez.
Aprobaciones — listar las acciones que tus flujos y agentes esperan que apruebes, con qué quieren hacer y por qué, y aprobarlas o rechazarlas desde el chat.
Organizaciones y workspaces — listar a cuáles perteneces y acotar cualquier operación a uno de ellos.
Pruébalo con peticiones normales: "¿cuáles de mis flujos están activos?", "crea una tarjeta en Ventas para dar seguimiento a Acme, prioridad alta", "¿por qué no están tomando la tarjeta de onboarding?", "¿qué está esperando mi aprobación?", "pregúntale al agente de cobranza cuántas facturas están vencidas".
Qué puede tocar y qué no
La conexión actúa estrictamente como tú: solo ve las organizaciones y workspaces a los que pertenece tu cuenta, y cada acción respeta los permisos de tu rol. Las herramientas que solo leen están marcadas como de solo lectura; las que cambian tu cuenta — ejecutar un flujo, pausarlo, mover una tarjeta — están marcadas como tales, así que Claude pregunta antes de actuar.
Dos cosas que conviene saber antes de ejecutar un flujo desde el chat: sus efectos son reales (un flujo con nodos de correo o WhatsApp va a enviar), y consume créditos de ejecución igual que si lo corrieras desde la app. Lo mismo vale al hablar con un agente — puede usar sus herramientas — y al aprobar una solicitud: el flujo o agente pausado ejecuta la acción que pidió.
Otros clientes MCP
La misma URL funciona en cualquier cliente que soporte servidores MCP remotos:
| Cliente | Configuración |
|---|---|
| Claude Code (sin el plugin) | claude mcp add --transport http hiveflow https://mcp.hiveflow.ai |
| ChatGPT | Settings → Apps & Connectors → agrega un conector con https://mcp.hiveflow.ai |
| Cursor | ~/.cursor/mcp.json: { "mcpServers": { "hiveflow": { "url": "https://mcp.hiveflow.ai" } } } |
| VS Code | .vscode/mcp.json: { "servers": { "hiveflow": { "type": "http", "url": "https://mcp.hiveflow.ai" } } } |
| Clientes solo stdio | npx -y mcp-remote https://mcp.hiveflow.ai |
Para scripts o CI, sáltate OAuth y usa una API key: npx -y mcp-remote https://mcp.hiveflow.ai --header "Authorization: Bearer $HIVEFLOW_API_KEY".
La plataforma y tu máquina
El conector llega a la plataforma: flujos, tableros, workers. El CLI llega a tu máquina: repositorios, ramas, tests, pull requests. Un nodo CLI Agent dentro de un flujo es el puente — un flujo en la nube delegando un paso a la computadora donde vive tu código.
Problemas frecuentes
"Account mismatch" al conectar desde Claude Desktop. El navegador tiene la sesión de una cuenta de Claude distinta a la de la app. Cierra sesión en el navegador, entra con la misma cuenta y vuelve a conectar.
Los tableros salen vacíos. La consulta corrió contra tu organización activa. Pídele a Claude que liste tus organizaciones y reintenta apuntando a la correcta.
Una tarjeta no avanza después de moverla. El worker corre en tu propia máquina — revisa que el CLI de Hiveflow esté corriendo ahí, que el worker no esté pausado, y que la tarjeta esté en la columna que ese worker vigila.
Agregar herramientas a agentes (function calling)
Dale herramientas a cualquier LLM Agent — integraciones MCP y herramientas de Hive Apps — y deja que el modelo decida cuándo llamarlas, con ejecución multi-ronda.
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.