The BlueDolphin Model Context Protocol (MCP) Server connects BlueDolphin to third-party AI assistants (e.g., Microsoft Copilot, Claude, Google Gemini) that the user provides, configures, and controls. This feature enables the third-party AI assistant to query data from BlueDolphin. BlueDolphin MCP can only retrieve data. It cannot create, update, or delete anything.
Prerequisite
To connect your BlueDolphin to a third-party AI, you need a BlueDolphin MCP API key. You can find this API key from your BlueDolphin.
NOTE: The MCP server is not enabled by default. Contact your Account Manager to request access.
Click the Main Menu and select System settings
Click Integration
Create API key
Store the API key
IMPORTANT: Your API key should be stored like a password. Do not share it with others or take a screenshot of it.
Authentication and access
BlueDolphin MCP currently runs on a shared API key system, managed at the tenant level, with one token per tenant.
BlueDolphin MCP scopes data across all workspaces within a tenant.
MCP server geolocation
BlueDolphin operates separate MCP servers per geolocation. Use the server URL that matches your tenant's region:
EU:
https://bd-mcpserver-api.eu.bluedolphin.app/mcpUS:
https://bd-mcpserver-api.us.bluedolphin.app/mcp
BlueDolphin MCP Tooling Overview
The BlueDolphin MCP offers multiple tools, allowing your AI assistant (e.g., Claude or Copilot) to source information from the BlueDolphin repository on Archimate objects, Solution Design, or BPMN diagrams. For instance, for an ArchiMate object, your AI assistant can retrieve the ArchiMate object definition; with Solution Design, your AI assistant can get a summary of a BlueDolphin Solution Design view.
NOTE: Contact your Account Manager for information on different tooling and instructions.
For more information on different third-party AI assistants, refer to the respective articles.
For Claude, refer to the Claude to BlueDolphin with MCP article
For CopilotStudio Sonnet-4.6 Agent, refer to the Microsoft Copilot to BlueDolphin with MCP article