Wie Sie Fine Structure mit MCP an Codex anbinden

So binden Sie Codex an Fine Structure an, damit Codex Anwendungen über ein begrenztes MCP-Token lesen, bearbeiten und validieren kann.

Codex eignet sich besonders, wenn Sie einen Agenten möchten, der Code versteht, innerhalb eines Projekts arbeiten kann und externe Werkzeuge kontrolliert einsetzen kann. Nach der MCP-Verbindung kann Codex die Werkzeuge von Fine Structure nutzen, statt zu raten, wie die Anwendung aufgebaut ist.

Gemeinsame Verbindung: Bei Codex nutzen die CLI und die IDE-Erweiterung dieselbe MCP-Konfiguration über config.toml.

Eine Konfiguration: Sie fügen einen Server namens fine_structure hinzu, richten ihn auf die Adresse https://finestructure.ai/api/mcp und ergänzen Authorization.

Kontrolle über Berechtigungen: Die Berechtigungen werden weiterhin innerhalb von Fine Structure auf der Seite /mcp festgelegt, nicht innerhalb von Codex.

Erstellen Sie ein Token, bevor Sie Codex bearbeiten

Öffnen Sie die MCP-Seite in Fine Structure, wählen Sie die Berechtigungen und kopieren Sie dann das Token in config.toml oder in eine Umgebungsvariable.

Der einfachste Weg

• Melden Sie sich in Ihrem Fine-Structure-Konto an.
• Öffnen Sie die MCP-Seite über die Schaltfläche Create MCP token in den Docs oder direkt über /mcp.
• Wählen Sie aus, ob der Agent Zugriff auf alle Anwendungen in Ihrem Besitz oder nur auf eine einzige Anwendung erhält.
• Wählen Sie die Berechtigungen: Read only zum Prüfen, Build zum Bearbeiten, Full access nur für einen Agenten, dem Sie vertrauen.
• Klicken Sie auf Create MCP setup und kopieren Sie das Token oder den Konfigurationsblock. Das Token wird nur ein einziges Mal angezeigt.
• Öffnen Sie die Konfigurationsdatei von Codex: in der Regel ~/.codex/config.toml.
• In der Codex IDE-Erweiterung können Sie MCP settings öffnen und dann Open config.toml wählen.
• Fügen Sie den Block unten ein und ersetzen Sie das Token.
• Öffnen Sie Codex neu oder starten Sie eine neue Session und prüfen Sie /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"

Nachdem der Server verbunden ist

• Bitten Sie den Agenten: "Use the Fine Structure MCP and call get_platform_guide first."
• Wenn Sie an einer bestehenden Anwendung arbeiten, geben Sie auch den Namen der Anwendung oder die app_id an.
• Bitten Sie den Agenten vor einer Veröffentlichung oder einer größeren Änderung, validate_app und inspect_preview auszuführen.
• Wenn die Verbindung fehlschlägt, erstellen Sie ein neues Token unter /mcp und widerrufen Sie das alte, um keinen offenen Zugriff zurückzulassen.

Wichtig: Wenn Sie eine Umgebungsvariable verwenden, muss der Wert ausschließlich das Token selbst sein, ohne das Wort Bearer. Codex ergänzt Authorization gemäß der Konfiguration bearer_token_env_var.