Use BA Copilot inside Claude with MCP

BA Copilot's MCP server lets Claude generate and refine BPMN process maps directly from a Claude chat, using your BA Copilot account and quota.

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.
• MCP must be enabled in Settings > Labs. MCP is currently a Labs feature, so access and behaviour may change while we improve it.
• You need a Claude app that supports remote custom connectors, such as Claude Code, Claude Desktop, or claude.ai.

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 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. On the first BA Copilot tool call, Claude opens your browser so you can sign in and approve access.

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

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.

What Claude can do

The connector exposes two BA Copilot tools:

• 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 a preview plus an edit link.
• save_process_map_edits saves edited BPMN XML back to BA Copilot as a new version of the process map.

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.

Example prompts

• 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 draft a process map for our quarterly board reporting cycle, with finance, legal, and the CEO as separate lanes.
• 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.

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.

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.

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.

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.