Empezar con Hilbana

Este es el camino corto de «acabo de registrarme» a «tengo un agente de IA trabajando en mis issues». Son cinco pasos y se hace en unos diez minutos, con el plan Free, sin tarjeta.

Cada paso resume lo justo para llegar al final. Cuando algo tenga más detalle del que cabe aquí, hay un enlace a la página que lo cuenta entero.

1. Crea tu espacio

Regístrate en app.hilbana.com/signup. Al crear la cuenta se genera tu workspace con un proyecto General y los seis estados de partida (Backlog, Todo, In Progress, In Review, Done, Canceled).

Los estados salen con su nombre en inglés porque así los pinta la app; puedes renombrarlos después, ver Estados de flujo.

2. Escribe tu primera issue

Puedes trabajar en el proyecto General o crear uno propio desde el botón «+» de la barra lateral, junto a «Proyectos». Dentro, pestaña Issues → nueva issue.

Rellena, además del título y la descripción, los dos campos que convierten una issue en algo que un agente puede ejecutar:

• Definición de hecho: qué tiene que ser cierto para dar el trabajo por terminado.
• Comando de verificación: lo que hay que ejecutar para comprobarlo, por ejemplo pnpm build o los tests.

Esos dos campos son la Definición de Ready. Sin ellos un agente puede tocar la issue, pero no sabe cuándo ha acabado. Marca también «lista para agente» si quieres que entre en la cola. Detalle en Issues.

Para el tutorial vale una issue pequeña y real de tu trabajo. Anota su identificador (DRAPPS-1, con el prefijo de tu equipo): lo vas a usar en el paso 4.

3. Conecta tu agente

Hilbana habla MCP (Model Context Protocol), así que cualquier cliente que hable MCP puede operar tu tablero. Abajo están las tres vías más habituales. Elige una, no hacen falta las tres.

Claude en la web (claude.ai)

Es la conexión más rápida y la que sirve de ejemplo para el resto: entras con tu cuenta por el navegador (OAuth) y no gestionas ninguna clave.

1. En claude.ai, abre Personalizar → Conectores.
2. Pulsa + → Añadir conector personalizado.
3. Nombre Hilbana, URL del servidor MCP https://app.hilbana.com/mcp. Si tienes una instalación propia, https://<tu-host>/mcp.
4. Pulsa Añadir y luego Conectar. Se abre la pantalla de Hilbana: inicia sesión si hace falta, elige workspace y permisos, y pulsa Autorizar.

Concede el permiso de escritura si quieres que el agente mueva estados y comente, no solo que lea.

Los pasos completos, los permisos y cómo revocar el acceso están en Conectar con Claude. Esa página es la referencia; esto de aquí es el resumen.

Claude Code

En tu terminal, dentro del repositorio en el que trabajas. Lo suyo aquí es el plugin, que además del MCP trae la memoria por proyecto, la contabilidad de tokens y los comandos del ciclo:

/plugin marketplace add hilbana/claude-plugin
/plugin install hilbana@hilbana

Reinicia Claude Code. Te pedirá una clave de API (hil_…), que se crea en Ajustes → Claves de API del workspace en el que quieras trabajar. Instalación, configuración y problemas comunes, en Plugin para Claude Code.

ChatGPT

ChatGPT admite servidores MCP remotos de terceros, pero solo a través del modo desarrollador: en la web (no en las apps móviles), en los planes Plus, Pro, Business, Enterprise y Education, y todavía como función en beta.

1. En ChatGPT, activa el modo desarrollador desde los ajustes. OpenAI ha movido esa opción varias veces: búscala en Ajustes → Aplicaciones y conectores → Avanzado o en Ajustes → Seguridad. En cuentas Business o Enterprise el administrador tiene que habilitarla antes para el workspace.
2. En el panel de aplicaciones y conectores, pulsa + y crea una app en modo desarrollador apuntando a https://app.hilbana.com/mcp.
3. Elige autenticación OAuth. Se abre la pantalla de Hilbana: inicia sesión, elige workspace y permisos y autoriza.
4. En la conversación, activa la app desde el menú + antes de pedirle nada.

Dos avisos, para que no te pille:

• La clave de API hil_… no sirve aquí. ChatGPT no deja poner cabeceras propias en un conector personalizado: admite OAuth o servidores sin autenticación. Para Hilbana, OAuth.
• Las apps personalizadas no las verifica OpenAI y el propio producto lo avisa. Es lo esperable en tu propio servidor MCP, pero conviene saberlo.

Comprobado el 5 de agosto de 2026 contra la documentación de OpenAI. Es una función en beta y los menús cambian de nombre a menudo; si algo no encaja, manda lo que veas en tu pantalla.

Otros agentes

Cualquier otro cliente MCP (tu propio agente, un servicio, CI) se conecta con una clave de API y una entrada de configuración. Está en API y MCP.

4. Tu primer prompt

Ya conectado, pídeselo en lenguaje natural. Para empezar, algo que se pueda comprobar de un vistazo en el tablero:

Estás conectado a mi Hilbana por MCP. Trabaja la issue [DRAPPS-N]:

1. Léela con get_issue, incluidos el contexto del agente y la definición de hecho.
2. Muévela a In Progress con change_issue_state.
3. Escribe un comentario con add_comment con tu plan en tres o cuatro puntos, sin
   empezar a ejecutarlo todavía.
4. Dime qué te falta de la issue para poder terminarla sin preguntarme nada más.

Sustituye [DRAPPS-N] por el identificador del paso 2. Por defecto el cliente te pedirá aprobación antes de usar cada herramienta.

En el tablero deberías ver la issue en In Progress y el comentario firmado por tu usuario. Ese último punto del prompt es el que más rinde al principio: te dice qué le falta a tu issue para ser ejecutable.

Cuando esto funcione, el catálogo de Prompts trae los flujos completos: arrancar un proyecto, convertir una idea en épica, tirar de la cola o revisar lo que está en In Review.

5. Y ahora qué

• Conectar con Claude: el conector de claude.ai al detalle, permisos y revocación.
• Plugin para Claude Code: memoria, comandos del ciclo y contabilidad de tokens.
• API y MCP: claves, endpoint y todas las herramientas MCP.
• Prompts: el catálogo de flujos listos para copiar.
• Agentes: la cola, el claim/release y el panel en vivo.
• Issues: cómo escribir issues que un agente pueda ejecutar.