Cómo conectar Fine Structure a VS Code y GitHub Copilot con MCP

VS Code guarda la configuración de MCP en el archivo mcp.json, y puedes definir el token como un input secreto en lugar de escribirlo de forma visible.

Si trabajas con VS Code y GitHub Copilot Agent Mode, puedes conectar Fine Structure como un servidor MCP remoto. Así Copilot accede a las herramientas de Fine Structure sin que tengas que copiar archivos, esquemas o historial de errores manualmente.

Dónde colocar el archivo: Puedes usar .vscode/mcp.json para un workspace concreto o la configuración User MCP para todo el equipo.

Guardar el token: VS Code admite input variables, de modo que el token puede guardarse como secreto y no aparecer en el archivo.

Verificar la conexión: Desde la Command Palette puedes ejecutar MCP: List Servers o abrir la configuración de MCP.

Empieza en Fine Structure

Crea un token MCP y luego vuelve a VS Code. Si tienes dudas, elige Read only para comprobar la conexión antes de editar.

Pasos

• Inicia sesión en tu cuenta de Fine Structure.
• Abre la página de MCP con el botón Create MCP token de la documentación, o directamente desde /mcp.
• Elige si el agente tendrá acceso a todas las aplicaciones de tu propiedad o solo a una.
• Elige los permisos: Read only para revisar, Build para editar, Full access solo para un agente en el que confías.
• Pulsa Create MCP setup y copia el token o el bloque de configuración. El token se muestra una sola vez.
• En VS Code abre la Command Palette y busca MCP: Open Workspace Folder MCP Configuration o MCP: Open User Configuration.
• Pega la configuración de abajo.
• Cuando VS Code te pida el Fine Structure MCP token, pega el token sin compartirlo con nadie.
• Ejecuta MCP: List Servers y comprueba que el servidor fineStructure está activo.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fineStructureToken",
      "description": "Fine Structure MCP token",
      "password": true
    }
  ],
  "servers": {
    "fineStructure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:fineStructureToken}"
      }
    }
  }
}

Por qué es buena opción: El input secreto te ayuda a no guardar tokens dentro de Git. Esto es especialmente importante en equipos o en proyectos de clientes.