Conectar Cursor con Bitácora

Con el conector, Cursor lee tus proyectos de Bitácora y aplica tus bitácoras sobre las pantallas. Los cambios llegan al lienzo mientras trabaja.

Con un clic, desde la web

1. Abre la página del conector de Bitácora y elige la pestaña Cursor.
2. Pulsa Añadir a Cursor y confirma en Cursor.
3. La primera vez que Cursor use Bitácora, te lleva al navegador para dar permiso. Sigue en Dar permiso.

A mano, con mcp.json

1. Abre el archivo ~/.cursor/mcp.json (créalo si no existe) y pega esto:

   {
     "mcpServers": {
       "bitacora": { "url": "https://app.bitacora.live/mcp" }
     }
   }

   Copiar

   Si el archivo ya tiene otros servidores, añade solo la línea de bitacora dentro de mcpServers.

2. Guarda el archivo.
3. En Cursor, activa bitacora en la lista de servidores MCP. Se abre el navegador para dar permiso.

Lo mismo está en Bitácora: al crear tu primera bitácora sin la IA conectada sale el recuadro Conecta tu IA. En Con tu herramienta de IA (MCP), la pestaña Cursor trae el texto para copiar con tu dirección ya puesta.

Dar permiso

En la ventana de Bitácora:

1. En Hasta dónde llega, elige Todo el espacio (todos los proyectos) o un solo proyecto.
2. En Qué puede hacer, deja Leer y editar para que aplique tus bitácoras, o elige Solo leer para que solo mire.
3. Pulsa Dar permiso.

Si conectaste desde el recuadro Conecta tu IA, se pone en verde solo: Tu IA ya está conectada.

Comprobar que funciona

En el chat de Cursor, en modo agente, pide: Dime qué proyectos tengo en Bitácora. Si responde con tu lista, ya puedes pedirle que ejecute tus bitácoras.

Si algo no sale

• Cursor no abre el navegador: revisa que bitacora esté activado en la lista de servidores MCP. Si lo estaba, apágalo y vuelve a encenderlo.
• «Esa petición caducó»: la ventana de permiso dura 15 minutos. Vuelve a activar el servidor y da permiso sin esperar.
• «Tu rol en este espacio no permite ejecutar bitácoras»: conectar pide el rol Puede ejecutar con IA. Pídeselo a quien lleva el proyecto.
• Dejó de funcionar de un día para otro: si alguien revocó el permiso en Ajustes › Conector, vuelve a conectar desde Cursor.