Use BA Copilot inside Claude with MCP

BA Copilot's MCP server connects Claude to your BA Copilot account directly from a Claude chat. Claude can generate and refine BPMN process maps using your account and quota, and manage your wider process-map library: your organizations, workspaces, folders, and maps.

Use it when you want to describe a process in Claude, turn that description into a BPMN-compliant process map, preview it inline, and save the result back to BA Copilot.

Before you start

• You need a BA Copilot account.
• You need a Claude app that supports remote custom connectors, such as Claude Desktop, claude.ai, or Claude Code.
• MCP is currently a Labs feature, so access and behaviour may change while we improve it. Connecting BA Copilot from Claude enables MCP for your account; you can turn it off again in Settings > Labs.

MCP server URL

Use this server URL for BA Copilot:

https://ba-copilot.com/api/mcp

You can also copy the current server URL from Dashboard > MCP. That page is useful if you are working against staging or another BA Copilot environment.

Install in Claude Desktop

1. Open Settings > Connectors > Add custom connector.
2. Paste the server URL:

https://ba-copilot.com/api/mcp

3. Approve the BA Copilot sign-in flow when Claude opens your browser.

Claude Desktop 1.0 or later is required for remote HTTP MCP servers.

Install in claude.ai

1. Open your profile menu in claude.ai.
2. Go to Settings > Connectors > Add custom connector.
3. Paste the BA Copilot MCP server URL.
4. Approve the BA Copilot sign-in flow.

Install in Claude Code

1. Run the command in your terminal, not inside a Claude Code conversation:

claude mcp add-json ba-copilot '{"type":"http","url":"https://ba-copilot.com/api/mcp"}'

For older Claude Code versions, use the legacy syntax:

claude mcp add --transport http ba-copilot https://ba-copilot.com/api/mcp

2. Restart Claude Code.
3. Run claude mcp list to confirm BA Copilot is registered.
4. Start Claude Code with claude, run /mcp, select BA Copilot, and choose Authenticate to sign in.

By default, Claude Code adds the connector to the current project. Add --scope user if you want it available across all projects.

If an earlier install attempt failed with Claude MCP callback URL is required, remove the old connector or re-run the install command above and authenticate again. That was a server-side redirect URI issue and has been fixed.

What Claude can do

Connecting Claude lets it both create maps for you and manage your BA Copilot process library: your organizations, workspaces, folders, and process maps.

Create and refine process maps

• generate_process_map creates a BPMN process map from a prompt and optional source text, such as an SOP, transcript, or list of steps. BA Copilot saves the generated process map and returns both an edit link and a preview image.
• save_process_map_edits saves edited BPMN XML back to BA Copilot as a new version of the process map.

Manage your process library

• Browse and search your organizations, workspaces, folders, and process maps.
• Create, rename, move, duplicate, and delete organizations, workspaces, folders, and process maps.
• Review your maps with version history, quality checks, duplicate and overlap detection, and an overall organization health assessment.
• Improve maps with AI-assisted authoring and save changes back to BA Copilot.

Claude can show the process map preview inline. When supported, the BA Copilot MCP app card also lets you open the map in full-screen edit mode and save changes back to BA Copilot.

About the access you grant

Connecting Claude grants full management of your BA Copilot account, including the ability to delete organizations, workspaces, folders, and process maps. Deletions can't be undone. The Connect screen shows this before you approve, and you can disconnect or turn MCP off at any time in Settings > Labs.

Example prompts

Create and refine maps:

• Use BA Copilot to make a BPMN process map for onboarding a new SaaS customer, including credit check and CRM sync.
• Use BA Copilot to turn this SOP into a swimlane process map: [paste SOP]
• Use BA Copilot to refine the last process map: add an exception path when payment fails and an SLA review gateway before the final step.

Manage and review your library:

• Use BA Copilot to list the process maps in my workspace and tell me which ones haven't been published yet.
• Use BA Copilot to review my organization for duplicate or overlapping process maps and summarise what it finds.
• Use BA Copilot to assess the overall health of my process library and highlight gaps or missing maps.
• Use BA Copilot to create an "Onboarding" folder and move the related process maps into it.
• Use BA Copilot to run a quality check on my invoice approval process map and save the improved version.

Quota and billing

• Paid plans: MCP and the REST API share your monthly process-map generation quota. Whichever route you use, it draws from the same allowance.
• Free trial: MCP includes a small lifetime allowance. Subscribe to keep using it after that.
• You can see MCP usage on Dashboard > MCP and in your account usage breakdown.

Authentication and security

BA Copilot's MCP server uses OAuth 2.0 with PKCE. You do not copy an API key into Claude. Instead, Claude opens a browser sign-in flow, you approve access, and Claude stores the connector authorization.

Claude Desktop and claude.ai use Claude's hosted OAuth callback. Claude Code is a native app and uses a local loopback callback such as http://127.0.0.1:54321/.... BA Copilot accepts both supported redirect styles, while still rejecting non-loopback HTTP redirects and https://localhost.

Access tokens last 1 hour. Refresh tokens last 30 days. If your account or subscription requires multi-factor authentication, BA Copilot may ask you to verify before authorising the connector.

Troubleshooting

Tools are not showing in Claude

Restart Claude. In Claude Code, run claude mcp list and confirm ba-copilot is listed, then run /mcp in a Claude Code chat and choose Authenticate.

Claude MCP callback URL is required

This error came from an older BA Copilot server-side redirect URI check. Re-run the install command above, then authenticate again. If it still fails, remove the connector first:

claude mcp remove ba-copilot

Authentication failed

Remove the connector and add it again so the OAuth flow restarts. In Claude Code:

claude mcp remove ba-copilot

MCP is not enabled

Open Settings > Labs in BA Copilot and enable MCP, then try again. If you connected from Claude, the consent flow should enable MCP automatically.

Quota exceeded or 429 error

Check Dashboard > MCP or Settings > Account for your current usage. If you have used your allowance, upgrade your plan or wait until the quota resets.

Need help

Open a support thread from the Help link in the BA Copilot sidebar. Include the approximate time of the failing call and which Claude app you were using.