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.

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@hiveflow

La 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.

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é 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.

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.