Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs-mintlify/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -216,7 +216,7 @@
"docs/integrations/semantic-layer-sync/tableau"
]
},
"reference/mcp-server"
"docs/integrations/mcp-server"
]
}
]
Expand Down Expand Up @@ -732,6 +732,10 @@
{
"source": "/embedding/creator-mode",
"destination": "/embedding/iframe/creator-mode"
},
{
"source": "/reference/mcp-server",
"destination": "/docs/integrations/mcp-server"
}
]
}
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: MCP server
description: Connect MCP-aware assistants to Cube through a hosted HTTPS endpoint with OAuth, admin defaults, and no local bridge process.
description: Connect MCP-aware assistants to Cube through a hosted HTTPS endpoint with OAuth and admin-managed defaults.
---

Cube MCP (Model Context Protocol) lets MCP-compatible AI clients connect to Cube over HTTPS using OAuth. You don’t need to run a local MCP server or manage API keys.
Cube MCP (Model Context Protocol) lets MCP-compatible AI clients connect to Cube over HTTPS using OAuth.

<Info>

Expand All @@ -14,36 +14,34 @@ The MCP server is available on [Premium and Enterprise plans](https://cube.dev/p

## What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. The Cube MCP Server acts as a bridge between your AI assistant and Cube's analytics platform, allowing you to ask data questions directly from your coding environment.
Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. The Cube MCP server acts as a bridge between your AI assistant and Cube's analytics platform, allowing you to ask data questions directly from your coding environment.

## Remote MCP server (recommended)
## Overview

Cube hosts a remote MCP server endpoint for your tenant. MCP clients connect over HTTPS and authenticate via OAuth.

### Overview
Cube hosts an MCP server endpoint for your tenant. MCP clients connect over HTTPS and authenticate via OAuth.

- **Endpoint:** `https://<cube-mcp-server-host>/api/mcp`
- **OAuth discovery:** `https://<cube-mcp-server-host>/.well-known/oauth`
- **OAuth flow:** Authorization Code + PKCE, `client_id` = `cube-mcp-client`, scope = `mcp-agent-access`
- **Agent selection:** Uses the **Remote MCP Defaults** (default deployment + agent) set by your admin
- **Agent selection:** Uses the **MCP Defaults** (default deployment + agent) set by your admin

### Admin setup
## Admin setup

#### Prerequisites
### Prerequisites

Before enabling Remote MCP, make sure you have:
Before enabling MCP, make sure you have:

- **Admin privileges** in your Cube instance
- An active Cube tenant
- Remote MCP URL configured
- MCP server URL configured

#### 1) Confirm Remote MCP URL
### 1) Confirm MCP server URL

Remote MCP uses your Cube MCP server host. If the URL isn’t configured, the Remote MCP page will show “Remote MCP configuration is unavailable.”
MCP uses your Cube MCP server host. If the URL isn’t configured, the MCP page will show “MCP configuration is unavailable.”

#### 2) Set Remote MCP Defaults
### 2) Set MCP Defaults

Go to **Admin → Remote MCP** and select:
Go to **Admin → MCP** and select:

- **Default Deployment**
- **Default Agent**
Expand All @@ -64,7 +62,7 @@ claude mcp add --transport http cube-mcp-server https://<cube-mcp-server-host>/a

#### Authentication and usage flow:

1. Run the command copied from **Admin → Remote MCP → Claude → Claude Code**.
1. Run the command copied from **Admin → MCP → Claude → Claude Code**.
2. Then run Claude and use `/mcp` to list available servers.
3. Select `cube-mcp-server` and choose `Authenticate`.
2. A browser window opens for authentication.
Expand Down Expand Up @@ -106,7 +104,7 @@ claude mcp add --transport http cube-mcp-server https://<cube-mcp-server-host>/a

## Connect to Cursor

Add the Remote MCP endpoint under Tools & MCP Settings, then complete the OAuth flow.
Add the MCP endpoint under Tools & MCP Settings, then complete the OAuth flow.

```json
{
Expand Down Expand Up @@ -150,7 +148,7 @@ Then run `codex mcp login cube-mcp-server` to authenticate.

For any MCP-compatible client:

1. Add a new server with the **Remote MCP Endpoint**.
1. Add a new server with the **MCP endpoint**.
2. The client will auto-discover OAuth and prompt for authentication.
3. Complete the OAuth flow to grant access to your Cube deployment.

Expand All @@ -172,9 +170,9 @@ For any MCP-compatible client:

## Troubleshooting

- **Remote MCP configuration is unavailable**: Configure the Remote MCP URL.
- **Remote MCP OAuth integration is not configured**: Enable MCP in **Admin → Team & Security → OAuth Integrations**.
- **Remote MCP defaults are not configured**: Set defaults in **Admin → Remote MCP** under **Remote MCP Defaults**.
- **MCP configuration is unavailable**: Configure the MCP server URL.
- **MCP OAuth integration is not configured**: Enable MCP in **Admin → Team & Security → OAuth Integrations**.
- **MCP defaults are not configured**: Set defaults in **Admin → MCP** under **MCP Defaults**.
- **redirect_uri is not allowed**: For self-hosted or custom clients, update `MCP_ALLOWED_REDIRECT_PATTERNS` on console-server.

[ref-roles]: /admin/users-and-permissions/roles-and-permissions
[ref-roles]: /admin/users-and-permissions/roles-and-permissions
2 changes: 1 addition & 1 deletion docs-mintlify/docs/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,6 @@ Rather than inventing proprietary protocols, Cube implements widely adopted stan
[ref-workbooks]: /docs/workspace/workbooks
[ref-embedding]: /reference/embedding
[ref-chat-api]: /reference/chat-api
[ref-mcp-server]: /reference/mcp-server
[ref-mcp-server]: /docs/integrations/mcp-server
[ref-agent-rules]: /admin/ai/rules
[ref-agent-memories]: /admin/ai/memory-isolation
2 changes: 1 addition & 1 deletion docs-mintlify/reference/core-data-apis/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ tools][ref-viz-tools]:
[ref-js-sdk]: /reference/javascript-sdk
[ref-cube-cloud-for-excel]: /docs/integrations/microsoft-excel
[ref-cube-cloud-for-sheets]: /docs/integrations/google-sheets
[ref-mcp-server]: /reference/mcp-server
[ref-mcp-server]: /docs/integrations/mcp-server
[ref-viz-tools]: /admin/connect-to-data/visualization-tools
[ref-hierarchies]: /reference/data-modeling/hierarchies
[ref-folders]: /reference/data-modeling/view#folders
Expand Down
Loading