BP1 AI MCP Connector
The BP1 AI MCP connector brings BPMN diagram editing into Claude and other MCP-compatible hosts. Generate process diagrams from natural-language descriptions, modify them with AI, and manage your workspace of diagrams without leaving the chat.
Connecting in Claude
- Open Claude and go to Settings → Connectors.
- Choose Add custom connector.
- Enter the server URL
https://bp1.ai/mcp. - Sign in with your BP1 AI account when the OAuth consent page opens.
- Approve access for the workspace you want Claude to work with.
You can also connect with a personal API token (bp1_live_…) created at Settings → Connectors inside BP1 AI, passed as an Authorization: Bearer header.
Tools
Every tool declares an explicit read/write annotation. Read-only tools never modify your workspace. Write tools are marked additive when they only create new diagrams, or destructive when they overwrite or delete — Claude asks for confirmation before destructive actions.
| Tool | Access | Description |
|---|---|---|
| whoami | Read-only | Verify the token and return the bound workspace, plan, and scopes. |
| list_workspaces | Read-only | List the workspace(s) this token can act on. |
| list_diagrams | Read-only | List diagrams in the workspace, optionally filtered by status or folder. |
| get_diagram | Read-only | Fetch a diagram’s metadata, BPMN XML, and a PNG preview. |
| list_folders | Read-only | List the folders in the workspace. |
| export_diagram_pdf | Read-only | Render a diagram and return it as a base64 PDF. |
| bpmn_to_text | Read-only | Produce a deterministic text description of a diagram. |
| create_diagram | Write (additive) | Create a new diagram. Does not overwrite existing diagrams. |
| clone_diagram | Write (additive) | Copy a diagram into a new draft. Does not modify the original. |
| generate_bpmn_from_text | Write (additive) | AI: generate a new diagram from a description. Persists only as a new diagram. |
| modify_bpmn | Write (additive) | AI: apply a natural-language edit, persisting the result as a new diagram. |
| update_diagram | Write (destructive) | Overwrite a diagram’s name/XML. A new version is appended (recoverable). |
| delete_diagram | Write (destructive) | Permanently delete a diagram. |
OAuth scopes
The connector uses the bpmn scope, which grants access to read and manage BPMN diagrams, folders, and AI generation within the workspace you authorise. It does not grant access to billing, account settings, or other users.
Other scopes (internal). The discovery metadata also lists a pm scope reserved for internal use. It is not part of this connector and is not requested during the BPMN connector flow.
Allowed origins
Requests that carry a browser Origin header must match the allowlist below (server-to-server calls without an Origin are accepted and gated by the Bearer token). A * matches a single label.
- https://claude.ai
- https://*.claude.ai
- https://*.anthropic.com
- https://chat.openai.com
- https://chatgpt.com
- https://cursor.sh
- https://*.cursor.sh
- vscode-webview://*
- https://bp1.ai
- https://app.bp1.ai
- https://staging.bp1.ai
In development the following local origins are additionally accepted: http://localhost:* and http://127.0.0.1:*.
Rate limits
The endpoint allows up to 120 calls per minute per token, applied as a sliding window. Exceeding the limit returns an HTTP 429 response.
What data is shared with Claude
The MCP host receives, on a per-call basis, only the data returned by the specific tool you invoke — for example the BPMN XML of a diagram you ask Claude to read, or the list of diagrams in a workspace. The host has no ambient access to your workspace; access is gated by the scope you granted and the Bearer token presented on each call.
AI generation and modification send your prompt text and the relevant diagram content to a third-party AI provider (Anthropic Claude or Google Gemini). We do not include your email or name in the prompt body. You can revoke a connector at any time at Settings → Connected apps.
See our Privacy Policy and Terms of Service for details.
Support
Questions or issues with the connector? Email support@bp1.ai.