Conectar VS Code con Bitácora

En VS Code, Bitácora se usa desde el chat de GitHub Copilot en modo agente: lee tus proyectos y aplica tus bitácoras sobre las pantallas.

Con un clic, desde la web

1. Abre la página del conector de Bitácora y elige la pestaña VS Code.
2. Pulsa Añadir a VS Code (o VS Code Insiders, si usas esa versión) y confirma la instalación.
3. La primera vez, VS Code te lleva a Bitácora para dar permiso. Sigue en Dar permiso.

Desde la paleta de comandos

1. Copia la dirección del conector:

   https://app.bitacora.live/mcp

   Copiar

1. En VS Code, abre la paleta de comandos con Ctrl+Mayús+P (en Mac, Cmd+Mayús+P).
2. Elige MCP: Add Server, luego HTTP, pega la dirección y llámalo bitacora.
3. Cuando se abra el navegador, da permiso.

Estos pasos también están en Bitácora, en el recuadro Conecta tu IA, pestaña VS Code, con tu dirección ya puesta.

A mano, en el proyecto

Si prefieres dejarlo escrito en la carpeta de tu proyecto, crea .vscode/mcp.json con esto:

{
  "servers": {
    "bitacora": { "type": "http", "url": "https://app.bitacora.live/mcp" }
  }
}

Ojo: en VS Code la clave es servers, no mcpServers como en Cursor.

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.
3. Pulsa Dar permiso.

Comprobar que funciona

Abre el chat de Copilot, cambia al modo agente y 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

• Copilot no usa Bitácora: comprueba que el chat está en modo agente y que bitacora está activado entre sus herramientas.
• «Esa petición caducó»: la ventana de permiso dura 15 minutos. Vuelve a iniciar el servidor desde VS Code.
• «Tu rol en este espacio no permite ejecutar bitácoras»: conectar pide el rol Puede ejecutar con IA.
• El agente de Copilot en github.com: ahí no hay navegador para dar permiso. Usa una clave de acceso; la página del conector trae el ejemplo.