V2

Builder MCP Server

The Builder MCP server exposes the same workflow-building tool surface used by Flowgear's built-in tooling so that workflows can be created and tested from outside the Console.

Register the Builder MCP server at https://your-environment-hostname.flowgear.net/mcp/builder where your-environment-hostname is the subdomain of the Environment you want to target. Note this is a different URL to the Workflow MCP Server.

The best way to get started is to use the Builder MCP Server to use it to create a Flowgear app.

Register Builder MCP Server

The URL for the Builder MCP is https://your-environment-hostname.flowgear.net/mcp/builder where your-environment-hostname is the subdomain of the Environment you want to target.

The process for registering an MCP server depends on the AI Agent.

Open a terminal window in your IDE. For example, Terminal, then New Terminal in Visual Studio Code.

OpenAI Codex

  1. Install Codex. If you're using Visual Studio Code, open Extensions and search for codex then click Install.

  2. Open a Codex chat. If you're using Visual Studio Code, do this using CMD+T (Mac) or CTRL+T (Windows) then type >Codex: Open Codex Sidebar

  3. Sign in to Codex

  4. Add the MCP server by running this from a Terminal window:

codex mcp add flowgear --url https://your-environment-hostname.flowgear.net/mcp/builder

flowgear is the name of the server, you must use this name because it's indicated in the agents.md file in the sample app repo.

your-environment-hostanme is the subdomain of the Environment you want to target.

  1. Authenticate by running this from a Terminal window:
codex mcp login flowgear

You will be redirected to the Flowgear Console to sign in and then authorize access to the MCP Server.

  1. Check that Codex is able to connect by sending a message like list tools available in flowgear mcp server - you should see a list of tools like ListWorkflows and ListNodes shown.

Anthropic Claude Code

  1. Install Claude Code for VS Code. If you're using Visual Studio Code, open Extensions and search for claude code then click Install.

  2. Open a Claude chat. If you're using Visual Studio Code, do this using CMD+T (Mac) or CTRL+T (Windows) then type >Claude Code: Open in Side Bar

  3. Sign in to Claude Code

  4. Add the MCP server by running this from a Terminal window.

claude mcp add --transport http flowgear https://your-environment-hostname.flowgear.net/mcp/builder 

flowgear is the name of the server, you must use this name because it's indicated in the agents.md file in the sample app repo.

your-environment-hostanme is the subdomain of the Environment you want to target.

  1. Go to the Claude Code chat and type /mcp. You'll see the new MCP server there. Click Needs Auth and follow the instructions to authenticate

  2. Check that Claude Code is able to connect by sending a message like list tools available in flowgear mcp server - you should see a list of tools like ListWorkflows and ListNodes shown.