From 4a5e766045c0fbe3ace69cd4cb73c28896387986 Mon Sep 17 00:00:00 2001 From: Artyom Keydunov Date: Wed, 13 May 2026 18:59:21 -0700 Subject: [PATCH] docs: move MCP server page into Integrations and drop "remote" qualifier (#10878) Relocate the MCP server reference into the Integrations group alongside Slack, Tableau, Power BI, etc., and rewrite the copy now that there is no local MCP option: remove mentions of running a local server, drop the "(recommended)" qualifier on the hosted endpoint, and strip the "Remote" prefix from section titles and admin UI references. Co-authored-by: Cursor --- docs-mintlify/docs.json | 6 ++- .../integrations}/mcp-server.mdx | 44 +++++++++---------- docs-mintlify/docs/introduction.mdx | 2 +- .../reference/core-data-apis/index.mdx | 2 +- 4 files changed, 28 insertions(+), 26 deletions(-) rename docs-mintlify/{reference => docs/integrations}/mcp-server.mdx (72%) diff --git a/docs-mintlify/docs.json b/docs-mintlify/docs.json index 0eade0bf5b3f5..92b9d5fbd029e 100644 --- a/docs-mintlify/docs.json +++ b/docs-mintlify/docs.json @@ -216,7 +216,7 @@ "docs/integrations/semantic-layer-sync/tableau" ] }, - "reference/mcp-server" + "docs/integrations/mcp-server" ] } ] @@ -732,6 +732,10 @@ { "source": "/embedding/creator-mode", "destination": "/embedding/iframe/creator-mode" + }, + { + "source": "/reference/mcp-server", + "destination": "/docs/integrations/mcp-server" } ] } \ No newline at end of file diff --git a/docs-mintlify/reference/mcp-server.mdx b/docs-mintlify/docs/integrations/mcp-server.mdx similarity index 72% rename from docs-mintlify/reference/mcp-server.mdx rename to docs-mintlify/docs/integrations/mcp-server.mdx index 904f87ddf2f3f..b5389943acb7e 100644 --- a/docs-mintlify/reference/mcp-server.mdx +++ b/docs-mintlify/docs/integrations/mcp-server.mdx @@ -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. @@ -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:///api/mcp` - **OAuth discovery:** `https:///.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** @@ -64,7 +62,7 @@ claude mcp add --transport http cube-mcp-server https:///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. @@ -106,7 +104,7 @@ claude mcp add --transport http cube-mcp-server https:///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 { @@ -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. @@ -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 \ No newline at end of file +[ref-roles]: /admin/users-and-permissions/roles-and-permissions diff --git a/docs-mintlify/docs/introduction.mdx b/docs-mintlify/docs/introduction.mdx index 379ac5cf09152..c05898e02631d 100644 --- a/docs-mintlify/docs/introduction.mdx +++ b/docs-mintlify/docs/introduction.mdx @@ -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 \ No newline at end of file diff --git a/docs-mintlify/reference/core-data-apis/index.mdx b/docs-mintlify/reference/core-data-apis/index.mdx index 80a63ebc1270e..c204fb03e02c9 100644 --- a/docs-mintlify/reference/core-data-apis/index.mdx +++ b/docs-mintlify/reference/core-data-apis/index.mdx @@ -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