Edit an Existing Workflow with Builder MCP v2

Edit an existing Workflow from its current source, preserve its identity, Debug the focused change, and save with optimistic concurrency protection.

Configure MCP Server

Check that the MCP server is registered and authenticated. Copy the instructions in the MCP option from the main navigation in the Console to configure it for the first time. If you are working across multiple tenants, ensure that each MCP server you are registering has a unique name and ensure that your agent knows which one to use for your current workspace. This is most easily done by specifying the name of the MCP Server that should be used in your AGENT.md file in your project folder.

Once connected, the agent should be directed to obtain the builder resource via the instructions sent to it. If you need to troubleshoot, ask the agent to complete these checks at the start of the session:

  1. Load the flowgear://builder/guidance Resource once. If the client cannot read MCP Resources and the guidance is not already present, call GetBuilderGuidance once instead.
  2. Call GetBuilderContext and show you the connected Tenant, Site, and Environment.
  3. Stop if the target is not the Test Environment you intend to change.
  4. State whether the agent may modify that Workflow. Do not infer reuse merely from a similar name.

Making changes to Workflows

Prompt the agent to make the desired change to a Workflow or set of Workflows.

It will typically begin by querying the design of the relevant Workflows, then enumerate available Nodes and their uses.

It may use the DebugWorkflow tool to run fragments of a Workflow to validate design or obtain required supporting data.

Finally, the agent will use DebugWorkflow to confirm finalized design for each Workflow being created or edited. Once these runs complete successfully, it will use SaveWorkflow to persist those designs.

Use an agent to migrate

Builder MCP includes tools that allow v1 Runtime Workflow designs to be read. Consider using an agent to help migrate existing v1 Workflows to v2.

See also

See Build a Workflow with Builder MCP, and Revision Management Pane.