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
Install Codex. If you're using Visual Studio Code, open
Extensionsand search forcodexthen clickInstall.Open a Codex chat. If you're using Visual Studio Code, do this using
CMD+T(Mac) orCTRL+T(Windows) then type>Codex: Open Codex SidebarSign in to Codex
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.
- 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.
- 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 likeListWorkflowsandListNodesshown.
Anthropic Claude Code
Install Claude Code for VS Code. If you're using Visual Studio Code, open
Extensionsand search forclaude codethen clickInstall.Open a Claude chat. If you're using Visual Studio Code, do this using
CMD+T(Mac) orCTRL+T(Windows) then type>Claude Code: Open in Side BarSign in to Claude Code
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.
Go to the Claude Code chat and type
/mcp. You'll see the new MCP server there. ClickNeeds Authand follow the instructions to authenticateCheck 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 likeListWorkflowsandListNodesshown.