Como conectar o Fine Structure ao Codex com MCP

Veja como conectar o Codex ao Fine Structure para que o Codex possa ler, editar e validar aplicativos por meio de um token MCP limitado.

O Codex é especialmente adequado quando você quer um agente que entende código, sabe trabalhar dentro de um projeto e consegue usar ferramentas externas de forma controlada. Após a conexão MCP, o Codex pode usar as ferramentas do Fine Structure em vez de adivinhar como o aplicativo é construído.

A conexão é compartilhada: No Codex, o CLI e a extensão para IDE usam a mesma configuração de MCP por meio do config.toml.

Uma única configuração: Você adiciona um servidor chamado fine_structure, aponta-o para o endereço https://finestructure.ai/api/mcp e adiciona o Authorization.

Controle de permissões: As permissões continuam sendo definidas dentro do Fine Structure, na página /mcp, e não dentro do Codex.

Crie o token antes de editar o Codex

Abra a página MCP no Fine Structure, escolha as permissões e então copie o token para dentro do config.toml ou para uma variável de ambiente.

A forma mais simples

• Entre na sua conta do Fine Structure.
• Abra a página MCP pelo botão Create MCP token na documentação, ou diretamente por /mcp.
• Escolha se o agente terá acesso a todos os aplicativos de sua propriedade ou apenas a um aplicativo.
• Escolha as permissões: Read only para testes, Build para edição, Full access apenas para um agente em que você confia.
• Clique em Create MCP setup e copie o token ou o bloco de configuração. O token é exibido apenas uma vez.
• Abra o arquivo de configuração do Codex: normalmente ~/.codex/config.toml.
• Na extensão do Codex para IDE, você pode abrir MCP settings e então Open config.toml.
• Cole o bloco abaixo e substitua o token.
• Reabra o Codex ou inicie uma nova session e verifique /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"

Depois que o servidor estiver conectado

• Peça ao agente: "Use the Fine Structure MCP and call get_platform_guide first."
• Se estiver trabalhando em um aplicativo existente, informe também o nome do aplicativo ou o app_id.
• Antes de uma publicação ou de uma mudança grande, peça ao agente para executar validate_app e inspect_preview.
• Se a conexão falhar, crie um novo token em /mcp e revogue o antigo para não deixar acesso aberto.

Importante: Se você usar uma variável de ambiente, o valor deve ser apenas o token em si, sem a palavra Bearer. O Codex adiciona o Authorization de acordo com a configuração bearer_token_env_var.