> For the complete documentation index, see [llms.txt](https://docs.decube.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decube.io/mcp/quick-start.md).

# Quick Start

## Connect from Claude

1. In Claude, go to **Customize > Connectors**.
2. Select **Add custom connector**.
3. Open the **Add** dropdown menu on the top-right and select **Add custom connector**.
4. Enter the following details:
   * **Name:** type in `Decube MCP` or another name of your preference
   * **Remote MCP server URL:** type in your region's connector URL e.g. `https://connect.apac.decube.io/mcp`

     | Region | Remote MCP server URL                |
     | ------ | ------------------------------------ |
     | US     | `https://connect.us1.decube.io/mcp`  |
     | EU     | `https://connect.eu1.decube.io/mcp`  |
     | APAC   | `https://connect.apac.decube.io/mcp` |
   * Ignore **advanced settings**
5. Click **Add**.
6. Log in to Decube when prompted, and approve access.

Once connected, try one of the [suggested prompts](/mcp/suggested-prompts.md) to confirm it's working.

## Connect from Cursor

1. In Cursor, go to **Settings > Tools & MCP**.
2. Click **Add Custom MCP**.
3. Paste the following code snippet in the opened `mcp.json` file. Or add it as a new entry if you have existing MCPs connected.

   ```json
   {
     "mcpServers":
     {
       "decube-mcp": // You can change this to any preferred name
         {
           "url": "https://connect.<region>.decube.io/mcp" // Replace this with your region's Remote MCP server URL
         }
     }
   } 
   ```

   | Region | Remote MCP server URL                |
   | ------ | ------------------------------------ |
   | US     | `https://connect.us1.decube.io/mcp`  |
   | EU     | `https://connect.eu1.decube.io/mcp`  |
   | APAC   | `https://connect.apac.decube.io/mcp` |
4. **Save** the file.
5. If you do not see the new MCP added in your interface, restart Cursor. Otherwise, proceed to the next step.
6. You should see your new MCP in the UI indicating that it requires authentication, click **Connect**. You should be redirected to a web page in approximately 30 seconds.
7. Log in to Decube when prompted, and approve access.

Once connected, try one of the [suggested prompts](/mcp/suggested-prompts.md) to confirm it's working.

## Connect from ChatGPT (OpenAI)

{% hint style="warning" %}
Custom MCP connectors in ChatGPT require **Developer mode**.
{% endhint %}

1. Turn on Developer mode: in ChatGPT, go to **Settings > Security and login** and toggle on **Developer mode**. If you don't see this option, ask your workspace admin to enable it.
2. Go to **Plugins**.
3. Click on the **+** icon.
4. Enter the following details:
   * **Name:** type in `Decube MCP` or another name of your preference
   * **Connection:** type in your region's connector URL e.g. `https://connect.apac.decube.io/mcp`

     | Region | Remote MCP server URL                |
     | ------ | ------------------------------------ |
     | US     | `https://connect.us1.decube.io/mcp`  |
     | EU     | `https://connect.eu1.decube.io/mcp`  |
     | APAC   | `https://connect.apac.decube.io/mcp` |
   * **Authentication**: OAuth
5. Select **I understand and want to continue**.
6. Select **Create**.
7. Wait for 15-30 seconds for it to connect. Log in to Decube when prompted, and approve access.

Once connected, try one of the [suggested prompts](/mcp/suggested-prompts.md) to confirm it's working.

## Connect from Microsoft Copilot Studio

{% hint style="info" %}
Reference: [Connect your agent to an existing Model Context Protocol (MCP) server](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent).
{% endhint %}

1. Go to the **Tools** page.
2. Select **Add a tool > New tool > Model Context Protocol**.
3. Fill in the required fields:
   * **Server name:** type in `Decube MCP` or another name of your preference
   * **Server description:** e.g. `Decube's catalog, lineage, and data quality context`
   * **Server URL:** type in your region's connector URL

     | Region | Remote MCP server URL                |
     | ------ | ------------------------------------ |
     | US     | `https://connect.us1.decube.io/mcp`  |
     | EU     | `https://connect.eu1.decube.io/mcp`  |
     | APAC   | `https://connect.apac.decube.io/mcp` |
4. Under authentication type, select **OAuth 2.0**, then **Dynamic discovery**.
5. Select **Create**.
6. On the **Add tool** dialog, select **Create a new connection**. Log in to Decube when prompted, and approve access.
7. Select **Add to agent** to finish.

Once connected, try one of the [suggested prompts](/mcp/suggested-prompts.md) to confirm it's working.

## Next Steps

Now that you're connected, try asking Decube MCP a question relevant to your role:

* [Data engineers](/mcp/suggested-prompts.md#for-data-engineers) — root-causing failures, dependency checks, freshness breaches
* [Data analysts](/mcp/suggested-prompts.md#for-data-analysts) — trust checks, ownership lookups, metric definitions
* [Data governance or data stewards](/mcp/suggested-prompts.md#for-data-governance-or-data-stewards) — audit readiness, ownership gaps, PII classification
* [Data and platform leaders](/mcp/suggested-prompts.md#for-data-and-platform-leaders) — quality health and compliance summaries

See the full [suggested prompts](/mcp/suggested-prompts.md) page for more examples, including write and action prompts.