Cómo conectar Fine Structure a Windsurf con MCP

Windsurf Cascade se conecta a servidores MCP mediante mcp_config.json. Fine Structure funciona como un servidor remoto HTTP con token.

Windsurf es ideal para un flujo de trabajo en el que Cascade ayuda a construir y editar código. Conectar Fine Structure mediante MCP le da a Cascade una forma controlada de entender tus aplicaciones y actuar sobre ellas a través de las herramientas de la plataforma.

El archivo de configuración: Windsurf usa normalmente ~/.codeium/windsurf/mcp_config.json.

El campo URL: Para un servidor MCP remoto usa serverUrl o url según la versión de la configuración; serverUrl es la opción segura en la documentación actual.

Secretos: Puedes usar variables de entorno si el equipo prefiere no guardar el token directamente en el archivo.

Crea una conexión controlada

Empieza con un token app-scoped si Cascade trabaja solo en una aplicación. Así reduces el riesgo y facilitas la gestión de clientes.

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 Windsurf abre Cascade y luego MCP settings o View raw config.
• Pega la configuración de abajo dentro de mcpServers.
• Guarda y actualiza los servidores MCP.
• Pídele a Cascade que ejecute una comprobación de conexión sencilla con get_platform_guide.

{
  "mcpServers": {
    "fine-structure": {
      "serverUrl": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

Verificación: Si Windsurf no muestra el servidor, comprueba que el JSON es válido, que el token incluye Bearer antes del valor y que no falta una coma después de un servidor anterior.