Cómo conectar Fine Structure a cualquier herramienta de IA compatible con MCP

Si tu herramienta no aparece en la lista, usa esta plantilla: endpoint, Authorization header y token MCP de Fine Structure.

La mayoría de las herramientas de IA modernas se conectan a MCP siguiendo la misma idea básica: se añade un servidor llamado fine-structure, se le da una dirección y se añade un token de Authorization. La única diferencia es el nombre del campo en el archivo de configuración: algunas herramientas usan url, otras usan serverUrl y otras usan una estructura especial como context_servers.

Dirección MCP: https://finestructure.ai/api/mcp es la dirección fija del servidor de Fine Structure.

Token: El header debe ser Authorization con el valor Bearer fse2_mcp_<token>.

Permisos: Los permisos se eligen en Fine Structure: solo lectura, construcción, publicación, secretos, seguridad o Agency Mode.

Verificación: Tras la conexión, pídele al agente que lea get_platform_guide. Si funciona, la conexión es correcta.

La forma universal

Crea un token, copia la dirección y el header, y pégalos en la pantalla de MCP de tu herramienta.

Qué buscar en cada herramienta de IA

• MCP settings
• Model Context Protocol
• Add custom server
• Remote MCP server
• View raw config
• mcp.json o mcp_config.json

Herramienta | Qué suele haber que configurar

Claude Code | Remote HTTP server con url y Authorization header.

Codex | config.toml con mcp_servers y un campo url.

Google Antigravity | mcp_config.json con serverUrl.

Cursor | .cursor/mcp.json o ~/.cursor/mcp.json.

Windsurf / Cascade | mcp_config.json con serverUrl o url.

VS Code / GitHub Copilot | servers dentro de mcp.json, preferiblemente con un input secreto para el token.

Zed | context_servers dentro de settings con url y headers.

Cline / Roo Code / Continue / OpenCode / Claude Desktop | Normalmente la misma idea: mcpServers, dirección del servidor y Authorization header. Si no hay compatibilidad con servidor remoto, usa el puente MCP que recomiende la herramienta.

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

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

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

Qué decirle al agente después de la conexión

• Pídele al agente: "Use the Fine Structure MCP and call get_platform_guide first."
• Si trabajas sobre una aplicación existente, indícale también el nombre de la aplicación o el app_id.
• Antes de publicar o de hacer un cambio importante, pídele al agente que ejecute validate_app e inspect_preview.
• Si la conexión falla, crea un token nuevo en /mcp y revoca el anterior para no dejar accesos abiertos.

Una regla de seguridad sencilla: No pegues un MCP token en una captura de pantalla, un issue público, un GitHub commit ni un documento de cliente. Si un token queda expuesto, revócalo en la página /mcp y crea uno nuevo.