Cómo conectar Fine Structure a Codex con MCP

Así se conecta Codex a Fine Structure para que Codex pueda leer, editar y validar aplicaciones mediante un token MCP limitado.

Codex es especialmente útil cuando quieres un agente que entienda código, sepa trabajar dentro de un proyecto y pueda usar herramientas externas de forma controlada. Tras conectar MCP, Codex puede usar las herramientas de Fine Structure en lugar de adivinar cómo está construida la aplicación.

Conexión compartida: En Codex, el CLI y la extensión para el IDE usan la misma configuración de MCP a través de config.toml.

Una sola configuración: Se añade un servidor llamado fine_structure, se le apunta a la dirección https://finestructure.ai/api/mcp y se añade el Authorization.

Control de permisos: Los permisos se siguen definiendo dentro de Fine Structure, en la página /mcp, no dentro de Codex.

Crea el token antes de editar Codex

Abre la página de MCP en Fine Structure, elige los permisos y luego copia el token a config.toml o a una variable de entorno.

La forma más sencilla

• 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.
• Abre el archivo de configuración de Codex: normalmente ~/.codex/config.toml.
• En la extensión de Codex para el IDE puedes abrir MCP settings y luego Open config.toml.
• Pega el bloque de abajo y sustituye el token.
• Vuelve a abrir Codex o inicia una sesión nueva y comprueba /mcp.

[mcp_servers.fine_structure]
url = "https://finestructure.ai/api/mcp"
http_headers = { "Authorization" = "Bearer fse2_mcp_<token>" }

[mcp_servers.fine_structure]
url = "https://finestructure.ai/api/mcp"
bearer_token_env_var = "FINE_STRUCTURE_MCP_TOKEN"

Una vez conectado el servidor

• 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.

Importante: Si usas una variable de entorno, el valor debe ser únicamente el token, sin la palabra Bearer. Codex añade el Authorization según la configuración de bearer_token_env_var.