Connect Claude Code to Builder MCP v2

Register the Flowgear Builder MCP endpoint in Claude Code, authenticate, and verify the Builder context before making Workflow changes.

Register and authenticate

The quickest path is to copy the Setup with your Coding Agent prompt from the Builder MCP section of the Console's MCP page and paste it into Claude Code. The prompt already contains the Server URL and the recommended server name. To register the server manually instead:

  1. Open MCP from the Console's main navigation. In the Builder MCP section, copy the Server URL and Recommended name.

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

  3. Run the following, replacing <recommended-name> with the recommended name you copied:

    claude mcp add --transport http <recommended-name> https://<environment-hostname>/mcp/builder

  4. Run /mcp in Claude Code.

  5. Select Authenticate for <recommended-name> and complete Flowgear sign-in.

The recommended name keeps this server distinguishable from other Flowgear MCP servers you have configured. You can choose a different name, but use the same name when you add and authenticate the server. Claude Code can keep several Flowgear MCP servers configured at once, such as one for each Tenant and Site you work with.

Verify Builder context

Ask Claude Code to use that server to:

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

If the Resource was loaded, do not call GetBuilderGuidance as well. Stop if the returned Environment is not the intended Test target.

Review the client's Tool approval settings before starting. Builder discovery is read-only, but save, Debug, and folder Tools can create records or invoke connected systems.

Continue with Build a Workflow with Builder MCP. See Connect Claude Code to tools via MCP for current Claude Code client setup.