Getting Started
Install the WorkflowGen Process Design skill from the supplied plugin, then connect your client to your organization’s WorkflowGen server. Follow the section for your client: Claude Cowork, ChatGPT Work or Cursor.
WorkflowGen 10.6.0 Beta: See the release notes on the WorkflowGen forum for the feature scope, installation packs, plugin download, upgrade guide and documentation. All three clients use the same plugin archive: Claude Cowork and ChatGPT Work import the ZIP, while Cursor installs its included skill manually.
Scope: This guide covers macOS and Windows desktop setup. The package contains the skill and instructions; it does not install the WorkflowGen server. The MCP connection is configured separately. Menu labels can vary with your client version and organization’s settings.
Before use: Back up process definitions and verify planned changes on a development or test installation before applying them to operational processes.
Plugin 0.1.0 includes process-design skill 0.2.30. WorkflowGen 10.6.0 includes MCP Server 1.1.0. No separate skill download is required.
Requirements
OpenID Connect (OIDC) or SAML is required. The main WorkflowGen site must use one of these two authentication modes for browser sign-in. They are the only supported WorkflowGen authentication modes for the plugin’s MCP connection.
Your administrator must also enable OAuth access on the WorkflowGen MCP server. OAuth authorizes the assistant’s MCP access after you sign in to WorkflowGen through OIDC or SAML.
Other WorkflowGen authentication modes, including Windows, Basic, Applicative, Form and custom authentication modules, are not supported for this MCP connection. Being able to sign in to the WorkflowGen portal with one of these modes does not meet the MCP authentication requirement.
Before you begin
Have the supplied plugin ZIP, your WorkflowGen account and the full HTTPS MCP server address supplied by your administrator ready. Use an account and workspace that allow the required plugin or skill and remote MCP connection.
When authentication opens your browser, sign in, review the requested access and click Authorize yourself. Read access is sufficient for the connection check below; creation or editing requires the corresponding access. Do not send your password or access tokens to the assistant. This sign-in is separate from approving individual tool calls and from signing in to WorkflowGen for browser display.
| Client | Desktop application requirements on macOS and Windows |
|---|---|
| Claude Cowork | Install Claude Desktop, sign in and select Cowork when offered. In the unified Claude experience, start from a new conversation. Cowork requires an eligible paid plan and permission to use custom plugins and connectors. |
| ChatGPT Work | Install the ChatGPT desktop app for macOS or Windows, sign in and select Work. Your account and workspace must permit Work, custom plugins and MCP connections. Desktop-control features are not required for the remote WorkflowGen connection. |
| Cursor | Install Cursor for your operating system, sign in and open Agent on your local computer. Use a version and account that support Agent Skills and remote MCP connections. A local WorkflowGen source repository is not required. |
Claude Cowork
1 · Install the plugin
- Open Customize → Plugins. In versions that place Customize under Settings, open Settings first.
- Select Add → Upload plugin and choose the supplied WorkflowGen Process Design plugin ZIP. Keep the ZIP as it is; there is no need to extract it.
- Click Upload and check that WorkflowGen Process Design is enabled.
The plugin provides the process design skill. Add your WorkflowGen connection separately in the next step.
Ask your administrator to confirm that the supplied HTTPS MCP address is reachable by Claude’s remote connector service. An address reachable only from your computer or a private VPN is not sufficient for this connection. See Anthropic’s network requirements.
2 · Add your WorkflowGen connection
- Open Customize → Connectors, select Add, then Custom → Web (or Add custom connector in earlier versions).
- Enter the following details:
| Field | Value |
|---|---|
| Name | WorkflowGen |
| URL | The full HTTPS MCP server address supplied by your administrator |
Example address (replace the full URL with the one supplied by your administrator):
https://server.example.com/wfgen/mcp
- Click Continue, review the detected authentication settings and click Continue again if shown.
- Under Authentication, select Sign in now. Under OAuth client, select Register automatically.
- Leave Request headers empty and click Add.
- Complete the browser sign-in and Authorize step with your WorkflowGen account when prompted.
- Open the connector’s Tool permissions to configure the tool approvals described below.
After connecting, continue with Check your connection.
ChatGPT Work
1 · Install the plugin
- Open Customize → Plugins. In versions that place the directory under Settings, use Settings → Plugins → Browse directory.
- Select Add → Upload plugin archive.
- Choose the supplied WorkflowGen Process Design plugin ZIP and click Add plugin. Keep the ZIP as it is; there is no need to extract it.
- On the WorkflowGen Process Design page, click Install plugin.
The plugin provides the process design skill. Add your WorkflowGen connection separately in the next step.
2 · Add your WorkflowGen connection
- Open Settings → MCP servers. In versions that group connections under plugins, use Settings → Plugins → MCPs.
- Select Add server or Add → Add MCP server, depending on your version.
- Enter the following details:
| Field | Value |
|---|---|
| Name | WorkflowGen |
| Type | Streamable HTTP |
| URL | The full HTTPS MCP server address supplied by your administrator |
Example address (replace the full URL with the one supplied by your administrator):
https://server.example.com/wfgen/mcp
- Leave Bearer token env var, Headers and Headers from environment variables empty for this sign-in setup.
- Click Save, then Restart if offered to reload the connection.
- Click Authenticate when the server requires sign-in. If the button is missing, fully quit and reopen ChatGPT Work, then return to the WorkflowGen MCP connection and click Authenticate.
- Complete the browser sign-in and Authorize step with your WorkflowGen account when prompted.
See the ChatGPT desktop MCP setup documentation for the current connection controls.
After connecting, continue with Check your connection.
Cursor
1 · Install the skill
macOS
- In Finder, double-click the supplied WorkflowGen Process Design plugin ZIP to extract it.
- Open the extracted plugin folder, then skills → workflowgen-process-design. This is the skill inside the plugin: it contains SKILL.md and the references folder.
- Open another Finder window. Choose Go → Go to Folder… (Command + Shift + G), enter
~/.cursor/and press Return. The.cursorfolder is hidden; this shortcut opens it directly. If Finder cannot find it, open Terminal, runmkdir -p ~/.cursor/skills/workflowgen-process-design, then repeat the Finder shortcut. This creates the skill folders in your user account without replacing existing files. - Inside
.cursor, create a folder named exactly skills if it does not exist: choose File → New Folder (Command + Shift + N), then enterskills. - Open skills and create a folder named exactly workflowgen-process-design if it does not exist.
- Copy SKILL.md and the complete references folder from step 2 into this new folder. Preserve all subfolders and files inside references. Select the items, press Command + C, click the destination window and press Command + V.
The resulting structure must be:
~/.cursor/skills/workflowgen-process-design/
SKILL.md
references/
…all supplied reference files and subfolders…
Return to Cursor and open Customize → Skills. Check that workflowgen-process-design appears. If it does not, fully quit and reopen Cursor, then check again. Open the skill to view its instructions and metadata version.
Windows
- In File Explorer, right-click the supplied WorkflowGen Process Design plugin ZIP and select Extract All…, then Extract.
- Open the extracted plugin folder, then skills → workflowgen-process-design. Keep this window open; it contains SKILL.md and references.
- Open another File Explorer window. Click its address bar, enter
%USERPROFILE%\.cursorand press Enter. If the folder does not exist yet, open%USERPROFILE%, create a folder named.cursor, then open it. - Create a folder named exactly skills if it does not exist, using New → Folder or Ctrl + Shift + N.
- Open skills, then create and open a folder named exactly workflowgen-process-design if it does not exist.
- Copy SKILL.md and the complete references folder from step 2 into that folder, using Ctrl + C and Ctrl + V. Preserve all reference subfolders and files.
- Return to Customize → Skills in Cursor and check that workflowgen-process-design appears. Fully quit and reopen Cursor if needed.
The destination is %USERPROFILE%\.cursor\skills\workflowgen-process-design\SKILL.md, with references beside SKILL.md.
Use the skill contained in the supplied plugin; a separate skill download is not needed. Skills → New creates a blank skill. This procedure installs the supplied skill manually and does not use Plugins → Add → From Local Repository, which expects a marketplace catalogue. Local use does not require cloud synchronization.
2 · Add your WorkflowGen connection
- Open Customize → MCPs → New MCP Server. Cursor opens your user
mcp.jsonconfiguration. - Add the following WorkflowGen entry under
mcpServers, replacing the example URL with the full HTTPS address supplied by your administrator. If other servers are already configured, preserve their entries; do not replace the whole file.
{
"mcpServers": {
"WorkflowGen": {
"url": "https://server.example.com/wfgen/mcp"
}
}
}
- Save the file with Command + S on macOS, Ctrl + S on Windows, or … → Save File.
- Return to Customize → MCPs. When WorkflowGen shows Needs authentication, click Authenticate.
- In the browser, sign in with your WorkflowGen account, select the access required for your work and click Authorize. Read access is sufficient for the connection check below; process creation or editing needs the corresponding write scopes and native account permissions.
- Return to Cursor and check that WorkflowGen shows Connected and its tools are listed. Click Done to close the configuration panel.
See Cursor’s Agent Skills and MCP configuration documentation for its current host setup options.
After connecting, continue with Check your connection.
Check your connection
Start a new Cowork task in Claude (or a new conversation in the unified experience), a new Work chat in ChatGPT or a new local Agent chat in Cursor. Send:
Use the workflowgen-process-design skill and the WorkflowGen MCP connection. Call only get_viewer to identify my connected account. Show my name and account status. Do not modify any data. If the tool is unavailable, explain the blockage. Do not inspect the local project repository.
Approve the tool call if prompted. If the expected account details are returned, your connection is working. This check does not create or change a process and does not establish write access.
If the skill is unavailable, check that the plugin is enabled in Claude or installed in ChatGPT. In Cursor, check that the complete skill and its references are in the folder described above. If the MCP tool is unavailable, check the separate connection and authentication, restart the client if needed, then try in a new task or chat.
If a form or file is too large
Send the reported size error to your WorkflowGen administrator. WorkflowGen 10.6.0 recommends 32 MiB for the MCP and Administration request limits; existing or inherited installation settings may be lower or higher, and omitting those settings does not automatically select 32 MiB. The ceiling covers the complete encoded request, including its envelope and encoding overhead, so the file or HTML that fits depends on how it is sent. Existing stored content can also prevent a read or replacement after a limit is lowered. The administrator can review the applicable limits using the release’s upgrade guide; installing the plugin does not change them.
Start using WorkflowGen
Describe the process you want to explore or design in your own words.
- To consult information: allow the required read tools.
- To create or edit processes: also allow the required write tools and ensure your WorkflowGen account has the corresponding access.
Choose approval settings that suit your work:
- Claude and ChatGPT: choose per-call confirmation or persistent tool permissions in the available approval controls. Persistent approval is optional, and workspace policies can restrict it.
- Cursor: Run approves the current call. Always Run, when offered, remembers approval for that tool; other tools may still require approval.
For sensitive write tools, such as publishing server code, deleting requests or changing accounts, keep confirmation enabled when configuring persistent tool approvals. Content read from processes, comments or shared templates may come from other users; it does not authorize additional actions on your behalf.
Approving a tool in the client does not grant access in WorkflowGen. Ask your administrator to authorize the connection for the work you need: reading information, making changes or designing processes. Your WorkflowGen account must also have the corresponding permissions. Sign in again if requested after an access change.
Process designers can modify authorized processes within their managed folders; application and category creation requires a WorkflowGen administrator. Native process-state rules still apply. Shared field templates can affect several processes. As in the native interface, administrators and folder managers can manage this shared template library. That right does not grant access to processes outside their managed folders. Request cleanup starts with a preview; actual deletion requires an explicit deletion request.
ASP.NET code in built-in or custom forms runs on the WorkflowGen server. Have the code and access rules reviewed by your administrator before publishing. Changing a process state does not remove a page that has already been published.
Follow progress in WorkflowGen
Follow changes as they are saved: The skill guides your assistant to open the relevant WorkflowGen Administration or User Portal page and show meaningful progress throughout the work. It prefers an integrated browser panel on the right when your client supports one; otherwise it uses an available external browser. Automatic opening, control and refresh depend on the client’s browser tools and a signed-in WorkflowGen browser session, configured separately from the MCP connection. If browser control is unavailable, the assistant explains this and reports progress in the conversation.
Avoid overwriting changes: Use one active designer at a time. When browser control is available, the assistant refreshes the view it controls after saved changes. If another Designer tab for the same process version was already open before the assistant’s changes, preserve any unsaved input, then reload it before editing or saving there. Saving from an outdated tab can overwrite the assistant’s changes.
When testing: Agree with the assistant on the scenarios, test environment and account to use. MCP tools can create requests, supply test data and complete workflow steps that the connected account is authorized to perform. Those calls do not submit the browser form or test its client-side code and form validations. When browser control is available and authorized, the assistant can also fill and submit the actual forms and show request progress and test results. Starting or completing requests can trigger configured notifications, automatic actions and integrations.
The connected MCP server supplies WorkflowGen data and operations. Keep process work on the selected connection. Investigating local source code is a separate task; if an operation fails, report the server response and what was saved without assuming a local project matches the remote deployment.