Conectar con Cursor y Codex
Añade Hilbana como servidor MCP en Cursor y en Codex con una API key, y opera tus issues desde el editor o la terminal.
Cursor y Codex hablan con Hilbana por su servidor MCP (https://app.hilbana.com/mcp).
Se conectan con una API key: la creas una vez y la pegas en el cliente. Después, el
agente lista, crea y cierra issues, lee los documentos y guarda memoria de proyecto, igual
que desde Claude.
Antes de empezar: crea una API key
- En Hilbana, abre Ajustes → Agentes → API keys (solo administradores).
- Crea una key. Puedes hacerla solo lectura o limitarla a un proyecto.
- Cópiala: empieza por
hil_y se muestra una sola vez.
En Ajustes → Agentes tienes estos mismos comandos con la URL de tu instancia ya puesta; solo tienes que cambiar la key de ejemplo por la tuya.
Cursor
-
Abre
~/.cursor/mcp.json(para todos tus proyectos) o.cursor/mcp.jsonen la raíz de un proyecto (solo para ese). Si no existe, créalo. -
Añade Hilbana dentro de
mcpServers:{ "mcpServers": { "hilbana": { "url": "https://app.hilbana.com/mcp", "headers": { "Authorization": "Bearer hil_tu_key" } } } } -
Abre los ajustes de MCP de Cursor: Settings → Tools & MCP, o Customize en la barra lateral en las versiones nuevas. Hilbana debe aparecer activo con sus herramientas. Si no, reinicia Cursor.
Para no dejar la key escrita en el fichero, pon "Bearer ${env:HILBANA_API_KEY}" y define
esa variable de entorno antes de abrir Cursor.
Codex
-
En tu terminal, guarda la key en una variable de entorno y registra el servidor:
export HILBANA_API_KEY=hil_tu_key codex mcp add hilbana --url https://app.hilbana.com/mcp \ --bearer-token-env-var HILBANA_API_KEY -
Comprueba que está dado de alta:
codex mcp listDebe salir
hilbanacomoenabledcon autenticaciónBearer token.
Codex guarda el servidor en ~/.codex/config.toml y lee la key de la variable, así que
la key no se escribe en el fichero. Abre Codex desde la misma terminal, o deja la
variable en el perfil de tu shell, para que la vea.
Probarlo
Pídele al agente, en lenguaje natural:
- «Lista los proyectos de Hilbana.»
- «Dame la siguiente issue lista para agente y empieza con ella.»
Si responde con tus proyectos, está conectado.
Revocar el acceso
Revoca la key en Ajustes → Agentes → API keys: el cliente deja de poder entrar al momento. Para volver a conectar, crea otra y cámbiala en el cliente.
Si prefieres no manejar claves, Claude se conecta con tu cuenta por el navegador.