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

  1. En Hilbana, abre Ajustes → Agentes → API keys (solo administradores).
  2. Crea una key. Puedes hacerla solo lectura o limitarla a un proyecto.
  3. 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

  1. Abre ~/.cursor/mcp.json (para todos tus proyectos) o .cursor/mcp.json en la raíz de un proyecto (solo para ese). Si no existe, créalo.

  2. Añade Hilbana dentro de mcpServers:

    {
      "mcpServers": {
        "hilbana": {
          "url": "https://app.hilbana.com/mcp",
          "headers": { "Authorization": "Bearer hil_tu_key" }
        }
      }
    }
  3. 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

  1. 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
  2. Comprueba que está dado de alta:

    codex mcp list

    Debe salir hilbana como enabled con autenticación Bearer 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.