Skip to content

Update mcp-server.mdx #10379

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
morgan-at-cube wants to merge 1 commit into
base: master
Choose a base branch
from
+9 −9
Open

Update mcp-server.mdx #10379

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
18 changes: 9 additions & 9 deletions docs/pages/product/apis-integrations/mcp-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@ Model Context Protocol (MCP) is an open standard that enables AI assistants to s

## Remote MCP server (recommended)

Cube hosts a remote MCP server endpoint for your tenant. MCP clients connect over HTTPS and authenticate via OAuth.
Cube hosts a remote MCP server endpoint for your tenant. MCP clients connect over HTTPS and authenticate via OAuth. OAuth sessions are active for 7 days.

### Overview

- **Endpoint:** `https://<cube-mcp-server-host>/api/mcp`
- **Endpoint:** `https://<cube-mcp-server-host>/api/mcp` (found in <Btn>Admin → MCP Server</Btn>)
- **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 Server Configuration** (default deployment + agent)

### Admin setup

Expand All @@ -35,14 +35,14 @@ Before enabling Remote MCP, make sure you have:

#### 1) Confirm Remote MCP 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.”
Remote MCP uses your Cube MCP server host. If the URL isn’t configured, the MCP Servers page will show “Remote MCP configuration is unavailable.”

#### 2) Set Remote MCP Defaults

Go to <Btn>Admin → Remote MCP</Btn> and select:
Go to <Btn>Admin → MCP Server</Btn> and set:

- **Default Deployment**
- **Default Agent**
- **Deployment**
- **Agent**

These defaults are required for the OAuth token exchange.

Expand All @@ -58,7 +58,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 <Btn>Admin → Remote MCP → Claude → Claude Code</Btn>.
1. Run the command copied from <Btn>Admin → MCP Server → Claude → Claude Code</Btn>.
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 @@ -164,7 +164,7 @@ For any MCP-compatible client:

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

## Local MCP server
Expand Down