From 26621b4872f296df7d12c1e0a94d54ea97618c8d Mon Sep 17 00:00:00 2001 From: ebembi-crdb Date: Wed, 28 Jan 2026 10:27:54 +0530 Subject: [PATCH] Fix MCP server configuration for Cursor, VS Code, and other clients Updates MCP integration documentation to match Kapa's official configuration format. This fixes the "Unknown transport" error users were experiencing when manually configuring Cursor with the previous npx-based approach. Changes: - Cursor: Use HTTP transport type in .cursor/mcp.json instead of npx - VS Code: Use .vscode/mcp.json with GitHub Copilot (requires 1.102+) - Claude Code: Use CLI command instead of JSON config - ChatGPT Desktop: Add full configuration instructions (was placeholder) - Claude Desktop: Use mcp-remote package instead of server-everything - Other clients: Update generic config format --- src/current/docs-mcp-integration.md | 79 +++++++++++----------- src/current/v23.1/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v23.2/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v24.1/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v24.2/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v24.3/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v25.1/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v25.2/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v25.3/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v25.4/docs-mcp-integration.md | 81 +++++++++++------------ src/current/v26.1/docs-mcp-integration.md | 81 +++++++++++------------ 11 files changed, 428 insertions(+), 461 deletions(-) diff --git a/src/current/docs-mcp-integration.md b/src/current/docs-mcp-integration.md index 75ec4cd9fae..1f9f7cf0d73 100644 --- a/src/current/docs-mcp-integration.md +++ b/src/current/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support diff --git a/src/current/v23.1/docs-mcp-integration.md b/src/current/v23.1/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v23.1/docs-mcp-integration.md +++ b/src/current/v23.1/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v23.2/docs-mcp-integration.md b/src/current/v23.2/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v23.2/docs-mcp-integration.md +++ b/src/current/v23.2/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v24.1/docs-mcp-integration.md b/src/current/v24.1/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v24.1/docs-mcp-integration.md +++ b/src/current/v24.1/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v24.2/docs-mcp-integration.md b/src/current/v24.2/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v24.2/docs-mcp-integration.md +++ b/src/current/v24.2/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v24.3/docs-mcp-integration.md b/src/current/v24.3/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v24.3/docs-mcp-integration.md +++ b/src/current/v24.3/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v25.1/docs-mcp-integration.md b/src/current/v25.1/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v25.1/docs-mcp-integration.md +++ b/src/current/v25.1/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v25.2/docs-mcp-integration.md b/src/current/v25.2/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v25.2/docs-mcp-integration.md +++ b/src/current/v25.2/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v25.3/docs-mcp-integration.md b/src/current/v25.3/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v25.3/docs-mcp-integration.md +++ b/src/current/v25.3/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v25.4/docs-mcp-integration.md b/src/current/v25.4/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v25.4/docs-mcp-integration.md +++ b/src/current/v25.4/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/) diff --git a/src/current/v26.1/docs-mcp-integration.md b/src/current/v26.1/docs-mcp-integration.md index 75ec4cd9fae..19aaac0b955 100644 --- a/src/current/v26.1/docs-mcp-integration.md +++ b/src/current/v26.1/docs-mcp-integration.md @@ -13,70 +13,66 @@ Connect your AI assistant to CockroachDB documentation by configuring the MCP se ### Cursor -1. Open Cursor Settings (⌘+,) -2. Navigate to **Models** → **Model Context Protocol** -3. Add the following configuration: +1. Create or open the file `.cursor/mcp.json` in your project directory +2. Add the following configuration: ```json { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -4. Restart Cursor to apply the configuration -5. You can now ask questions about CockroachDB documentation directly in Cursor +3. Restart Cursor to apply the configuration +4. You can now ask questions about CockroachDB documentation directly in Cursor ### VS Code -1. Install the [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension -2. Open VS Code Settings (⌘+,) -3. Search for "Claude MCP" -4. Add the following to your MCP configuration: +{{site.data.alerts.callout_info}} +Requires VS Code 1.102 or later with GitHub Copilot. +{{site.data.alerts.end}} + +1. Create or open the file `.vscode/mcp.json` in your project directory +2. Add the following configuration: ```json { - "claude.mcpServers": { + "servers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "http", + "url": "https://cockroachdb.mcp.kapa.ai" } } } ``` -5. Reload VS Code window (⌘+R) -6. The CockroachDB documentation is now available through Claude in VS Code +3. Reload VS Code window (⌘+R) +4. The CockroachDB documentation is now available through GitHub Copilot in VS Code ### Claude Code -1. Open Claude Code settings -2. Navigate to MCP Servers configuration -3. Add the CockroachDB Docs server: +1. Run the following command in your terminal: - ```json - { - "mcpServers": { - "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] - } - } - } + ```shell + claude mcp add --transport http cockroachdb-docs https://cockroachdb.mcp.kapa.ai ``` -4. Restart Claude Code -5. CockroachDB documentation is now accessible in your Claude Code environment +2. Execute `/mcp` in Claude Code and authenticate via browser when prompted +3. CockroachDB documentation is now accessible in your Claude Code environment ### ChatGPT Desktop -{{site.data.alerts.callout_info}} -MCP support for ChatGPT Desktop is coming soon. Check back for updates. -{{site.data.alerts.end}} +1. Open ChatGPT Desktop +2. Go to **Settings** → **Features** and enable **Developer mode** +3. Navigate to **Settings** → **MCP Servers** +4. Click **Add Server** and enter: + - **Name**: `cockroachdb-docs` + - **URL**: `https://cockroachdb.mcp.kapa.ai` +5. CockroachDB documentation is now accessible in ChatGPT Desktop ### Claude Desktop @@ -91,8 +87,8 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. { "mcpServers": { "cockroachdb-docs": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything", "https://cockroachdb.mcp.kapa.ai"] + "type": "npx", + "args": ["mcp-remote", "https://cockroachdb.mcp.kapa.ai"] } } } @@ -101,7 +97,7 @@ MCP support for ChatGPT Desktop is coming soon. Check back for updates. 3. Save the file and restart Claude Desktop 4. You can now query CockroachDB documentation directly in Claude Desktop -### Other +### Other MCP Clients For other MCP-compatible clients, use the following server configuration: @@ -111,10 +107,11 @@ For other MCP-compatible clients, use the following server configuration: ```json { - "servers": [{ - "name": "cockroachdb-docs", - "url": "https://cockroachdb.mcp.kapa.ai" - }] + "mcpServers": { + "cockroachdb-docs": { + "url": "https://cockroachdb.mcp.kapa.ai" + } + } } ``` @@ -180,7 +177,7 @@ If the configuration doesn't seem to take effect: 1. Ensure the configuration file is saved in the correct location 2. Check for JSON syntax errors in your configuration 3. Fully quit and restart your application (not just reload) -4. Verify that `npx` is available in your system `PATH` +4. For Claude Desktop: Verify that `npx` is available in your system `PATH` ## Feedback and Support @@ -191,4 +188,4 @@ For issues or feedback about the CockroachDB Docs MCP Server: ## See Also -- [Model Context Protocol](https://modelcontextprotocol.io/) \ No newline at end of file +- [Model Context Protocol](https://modelcontextprotocol.io/)