Comment connecter Fine Structure à Codex avec MCP

Voici comment connecter Codex à Fine Structure afin que Codex puisse lire, modifier et valider des applications via un token MCP limité.

Codex convient particulièrement lorsque vous voulez un agent qui comprend le code, sait travailler à l'intérieur d'un projet et est capable d'utiliser des outils externes de manière contrôlée. Une fois la connexion MCP établie, Codex peut utiliser les outils de Fine Structure au lieu de deviner comment l'application est construite.

Une connexion partagée: Dans Codex, le CLI et l'extension IDE utilisent la même configuration MCP via config.toml.

Une seule configuration: On ajoute un serveur nommé fine_structure, on le pointe vers l'adresse https://finestructure.ai/api/mcp et on ajoute Authorization.

Contrôle des autorisations: Les autorisations sont toujours définies dans Fine Structure, sur la page /mcp, et non dans Codex.

Créez un token avant de modifier Codex

Ouvrez la page MCP dans Fine Structure, choisissez les autorisations, puis copiez le token dans config.toml ou dans une variable d'environnement.

La méthode la plus simple

• Connectez-vous à votre compte Fine Structure.
• Ouvrez la page MCP via le bouton Create MCP token dans la documentation, ou directement via /mcp.
• Choisissez si l'agent aura accès à toutes les applications que vous possédez ou à une seule application.
• Choisissez les autorisations : Read only pour les tests, Build pour l'édition, Full access uniquement pour un agent en qui vous avez confiance.
• Cliquez sur Create MCP setup et copiez le token ou le bloc de configuration. Le token n'est affiché qu'une seule fois.
• Ouvrez le fichier de configuration de Codex : généralement ~/.codex/config.toml.
• Dans l'extension IDE de Codex, vous pouvez ouvrir MCP settings puis Open config.toml.
• Collez le bloc ci-dessous et remplacez le token.
• Rouvrez Codex ou démarrez une nouvelle session, puis vérifiez /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"

Une fois le serveur connecté

• Demandez à l'agent : "Use the Fine Structure MCP and call get_platform_guide first."
• Si vous travaillez sur une application existante, indiquez aussi le nom de l'application ou app_id.
• Avant une publication ou une modification importante, demandez à l'agent d'exécuter validate_app et inspect_preview.
• Si la connexion échoue, créez un nouveau token dans /mcp et révoquez l'ancien afin de ne pas laisser d'accès ouvert.

Important: Si vous utilisez une variable d'environnement, la valeur doit être uniquement le token lui-même, sans le mot Bearer. Codex ajoute Authorization selon la configuration bearer_token_env_var.