Connect Codex to Builder MCP v2

Register the Flowgear Builder MCP endpoint in Codex, complete OAuth, verify the target context, and load Builder Guidance before allowing Workflow changes.

Register the server

  1. Copy the complete hostname of the Test Environment from Flowgear Console.

  2. Verify https://<environment-hostname>/mcp/builder in a browser.

  3. Run:

    codex mcp add flowgear --url https://<environment-hostname>/mcp/builder

  4. If OAuth does not start automatically, run:

    codex mcp login flowgear

  5. Complete Flowgear sign-in in the browser.

Use the server name flowgear. The sample App repository guidance expects that name.

Verify the connection

Run codex mcp list to check the configured server, or open /mcp in the Codex terminal UI. Then ask Codex to:

  1. Read flowgear://builder/guidance once.
  2. Call GetBuilderContext.
  3. Show the connected Tenant, Site, and Environment without making changes.

Stop if the returned context is not the intended Test Environment. Do not also call GetBuilderGuidance when the Resource was loaded successfully.

Set approval expectations

Builder MCP includes read and write Tools. Keep approval prompts appropriate to the risk, especially for SaveWorkflow, DebugWorkflow, folder creation, or a test that can mutate an external system. Review Codex MCP approval settings before a long build session.

Start with Build a Workflow with Builder MCP. Current Codex MCP registration and OAuth commands are documented in the official OpenAI MCP documentation.