From dc741b475378ddd193ee62d761e0f2ea59002cdc Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Thu, 1 Oct 2026 15:06:42 -0400 Subject: [PATCH 1/6] docs: order MCP clients by popularity and rename Windsurf and Gemini CLI --- docs/cli-mcp/mcp-getting-started.md | 205 +++++++++++++++------------- docs/cli-mcp/mcp-reference.md | 64 ++++----- 2 files changed, 142 insertions(+), 127 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 5d52ddfe..e8c52adc 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -5,7 +5,7 @@ displayed_sidebar: cli_mcp # DevCyle MCP Getting Started -The DevCycle Model Context Protocol (MCP) Server is based on the DevCycle CLI, it enables AI-powered code editors like Cursor and Windsurf, or general-purpose tools like Claude Desktop, to interact directly with your DevCycle projects and make changes on your behalf. +The DevCycle Model Context Protocol (MCP) Server is based on the DevCycle CLI, it enables AI coding tools like Claude Code and Cursor, or general-purpose tools like Claude Desktop, to interact directly with your DevCycle projects and make changes on your behalf. ## Quick Setup @@ -41,7 +41,38 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + + +**Step 1: Open Terminal** +Open your terminal to access the Claude CLI. + +**Step 2: Add DevCycle MCP Server** + +```bash +claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp +``` + +**Step 3: Manage MCP Connection** +In the Claude CLI, enter the MCP management interface: + +```bash +/mcp +``` + +**Step 4: Authentication** +You'll see the DevCycle server listed as "disconnected • Enter to login": + +1. Select the DevCycle server and press Enter to login +2. Follow the CLI prompts to initiate the Authentication process +3. This will open a browser page at `mcp.devcycle.com` for authorization +4. Review and click **"Allow Access"** to grant permissions +5. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +6. Return to Claude Code where the server will show as connected + +For more details, see the [Claude Code MCP documentation](https://docs.anthropic.com/claude/docs/mcp). + + + 📦 Install in Cursor @@ -95,63 +126,36 @@ To open VS Code and automatically add the DevCycle MCP, click the install button 8. You'll be redirected back to VS Code with the server now active - - -**Step 1: Open Terminal** -Open your terminal to access the Claude CLI. - -**Step 2: Add DevCycle MCP Server** - -```bash -claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp -``` - -**Step 3: Manage MCP Connection** -In the Claude CLI, enter the MCP management interface: - -```bash -/mcp -``` - -**Step 4: Authentication** -You'll see the DevCycle server listed as "disconnected • Enter to login": + -1. Select the DevCycle server and press Enter to login -2. Follow the CLI prompts to initiate the Authentication process -3. This will open a browser page at `mcp.devcycle.com` for authorization -4. Review and click **"Allow Access"** to grant permissions -5. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -6. Return to Claude Code where the server will show as connected +**Step 1: Access MCP Configuration** -For more details, see the [Claude Code MCP documentation](https://docs.anthropic.com/claude/docs/mcp). +Locate and edit your OpenAI Codex CLI configuration file: - - +- **All platforms**: `~/.codex/config.toml` -**Step 1: Add DevCycle MCP Server** +**Step 2: Add DevCycle MCP Server** -Run the following command and follow the interactive prompts to add the DevCycle MCP server (name: `devcycle`, type: `remote`, url: `https://mcp.devcycle.com/mcp`): +Add the following TOML configuration to enable the DevCycle MCP server: -```bash -opencode mcp add +```toml +[mcp_servers.devcycle] +url = "https://mcp.devcycle.com/mcp" ``` -**Step 2: Authenticate** - -Run the following command to authenticate with DevCycle: +**Step 3: Restart Codex CLI** -```bash -opencode mcp auth devcycle -``` +Restart your Codex CLI session for the changes to take effect. -1. This will open a browser page at `mcp.devcycle.com` for authorization -2. Review and click **"Allow Access"** to grant permissions -3. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -4. Return to your terminal where authentication will complete +**Step 4: Authentication** -The next time you start OpenCode, the DevCycle MCP tools will be available. +1. When you first use DevCycle MCP tools, the Codex CLI will prompt for authentication +2. This will open a browser page at `mcp.devcycle.com` for authorization +3. Review and click **"Allow Access"** to grant permissions +4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +5. Return to the Codex CLI where the DevCycle MCP tools will be active -For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). +For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). @@ -196,80 +200,88 @@ Close and reopen Claude Desktop for the changes to take effect. 5. Return to Claude Desktop where the MCP tools will be active - + -**Step 1: Access MCP Configuration** +**Step 1: Add DevCycle MCP Server** -1. Open Windsurf and go to **Settings > Winsurf Settings** -2. Scroll to the **Cascade** section -3. Click **"Manage MCPs"** +Run the following command and follow the interactive prompts to add the DevCycle MCP server (name: `devcycle`, type: `remote`, url: `https://mcp.devcycle.com/mcp`): -**Step 2: Edit Raw Configuration** +```bash +opencode mcp add +``` -1. In the "Manage MCP servers" interface, click **"View raw config"** -2. Add the following configuration to the JSON file: +**Step 2: Authenticate** -```json -{ - "mcpServers": { - "DevCycle": { - "serverUrl": "https://mcp.devcycle.com/mcp" - } - } -} +Run the following command to authenticate with DevCycle: + +```bash +opencode mcp auth devcycle ``` -**Step 3: Refresh and Authenticate** +1. This will open a browser page at `mcp.devcycle.com` for authorization +2. Review and click **"Allow Access"** to grant permissions +3. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +4. Return to your terminal where authentication will complete + +The next time you start OpenCode, the DevCycle MCP tools will be available. -1. Save the configuration file -2. Click **"Refresh"** in the "Manage MCP servers" interface -3. The DevCycle server will appear and prompt for authentication -4. Follow the authentication flow: - - Browser opens at `mcp.devcycle.com` for authorization - - Click **"Allow Access"** to grant permissions - - If you have multiple organizations, select your desired organization at `auth.devcycle.com` - - Return to Windsurf where DevCycle will show as "Enabled" with all tools available which can be configured independently +For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). - + + +Antigravity CLI replaces Gemini CLI. The same MCP configuration is shared by Antigravity CLI and the Antigravity desktop app. **Step 1: Access MCP Configuration** -Locate and edit your OpenAI Codex CLI configuration file: +Locate and edit your Antigravity MCP configuration file: -- **All platforms**: `~/.codex/config.toml` +- **All platforms**: `~/.gemini/config/mcp_config.json` **Step 2: Add DevCycle MCP Server** -Add the following TOML configuration to enable the DevCycle MCP server: +Add or merge the following configuration to enable the DevCycle MCP server: -```toml -[mcp_servers.devcycle] -url = "https://mcp.devcycle.com/mcp" +```json +{ + "mcpServers": { + "devcycle": { + "serverUrl": "https://mcp.devcycle.com/mcp" + } + } +} ``` -**Step 3: Restart Codex CLI** +**Step 3: Manage MCP Connection** -Restart your Codex CLI session for the changes to take effect. +Start Antigravity CLI with `agy`, then enter the MCP management interface: + +```bash +/mcp +``` **Step 4: Authentication** -1. When you first use DevCycle MCP tools, the Codex CLI will prompt for authentication +1. Use the arrow keys to select the DevCycle server, choose **Authenticate**, and press Enter 2. This will open a browser page at `mcp.devcycle.com` for authorization 3. Review and click **"Allow Access"** to grant permissions 4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to the Codex CLI where the DevCycle MCP tools will be active +5. If prompted, paste the authorization code back into the terminal +6. Return to Antigravity CLI where the DevCycle MCP tools will be active -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). +For more details, see the [Antigravity MCP documentation](https://antigravity.google/docs/mcp). - + + +Devin Desktop (formerly Windsurf) configures MCP servers for its default Devin Local agent in the Devin config files. **Step 1: Access MCP Configuration** -Locate and edit your Gemini CLI settings file: +Locate and edit your Devin MCP configuration file: -- **All platforms**: `~/.gemini/settings.json` +- **macOS/Linux**: `~/.config/devin/mcp_config.json` +- **Windows**: `%APPDATA%\devin\mcp_config.json` **Step 2: Add DevCycle MCP Server** @@ -285,19 +297,20 @@ Add or merge the following configuration to enable the DevCycle MCP server: } ``` -**Step 3: Restart Gemini CLI** +**Step 3: Authentication** -Restart your Gemini CLI session for the changes to take effect. +Run the following command to log in to the DevCycle MCP server: -**Step 4: Authentication** +```bash +devin mcp login devcycle +``` -1. When you first use DevCycle MCP tools, the Gemini CLI will prompt for authentication -2. This will open a browser page at `mcp.devcycle.com` for authorization -3. Review and click **"Allow Access"** to grant permissions -4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to the Gemini CLI where the DevCycle MCP tools will be active +1. This will open a browser page at `mcp.devcycle.com` for authorization +2. Review and click **"Allow Access"** to grant permissions +3. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +4. Return to Devin Desktop and open a new agent tab where the DevCycle MCP tools will be active -For more details, see the [Gemini CLI MCP documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#how-to-set-up-your-mcp-server). +For more details, see the [Devin MCP documentation](https://docs.devin.ai/cli/extensibility/mcp/configuration). diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index b0f91c55..47f44cd5 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -376,7 +376,16 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + + +Run the following command: + +```bash +claude mcp add --transport stdio devcycle dvc-mcp +``` + + + Add the following to your `~/.cursor/mcp_settings.json` file: @@ -406,24 +415,16 @@ Add the following to your `settings.json` file: ``` - - -Run the following command: - -```bash -claude mcp add --transport stdio devcycle dvc-mcp -``` - - - + -Run the following command and follow the interactive prompts to add the local DevCycle MCP server (name: `devcycle`, type: `local`, command: `dvc-mcp`): +Locate and edit your configuration file at `~/.codex/config.toml`: -```bash -opencode mcp add +```toml +[mcp_servers.devcycle] +command = "dvc-mcp" ``` -For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). +For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). @@ -446,9 +447,20 @@ Add the following configuration: ``` - + + +Run the following command and follow the interactive prompts to add the local DevCycle MCP server (name: `devcycle`, type: `local`, command: `dvc-mcp`): + +```bash +opencode mcp add +``` + +For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + + + -In Windsurf Settings → Cascade → Manage MCPs → View raw config: +Locate and edit your configuration file at `~/.gemini/config/mcp_config.json`: ```json { @@ -460,22 +472,12 @@ In Windsurf Settings → Cascade → Manage MCPs → View raw config: } ``` - - - -Locate and edit your configuration file at `~/.codex/config.toml`: - -```toml -[mcp_servers.devcycle] -command = "dvc-mcp" -``` - -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). +For more details, see the [Antigravity MCP documentation](https://antigravity.google/docs/mcp). - + -Locate and edit your configuration file at `~/.gemini/settings.json`: +Locate and edit your Devin MCP configuration file at `~/.config/devin/mcp_config.json` (`%APPDATA%\devin\mcp_config.json` on Windows): ```json { @@ -487,7 +489,7 @@ Locate and edit your configuration file at `~/.gemini/settings.json`: } ``` -For more details, see the [Gemini CLI MCP documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#how-to-set-up-your-mcp-server). +For more details, see the [Devin MCP documentation](https://docs.devin.ai/cli/extensibility/mcp/configuration). From 872d31bf29583ef4e4f8fdb0776041b2212b7c02 Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Thu, 1 Oct 2026 15:25:19 -0400 Subject: [PATCH 2/6] docs: move Codex CLI to second in MCP client order --- docs/cli-mcp/mcp-getting-started.md | 64 ++++++++++++++--------------- docs/cli-mcp/mcp-reference.md | 24 +++++------ 2 files changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index e8c52adc..80c3bc58 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -71,6 +71,38 @@ You'll see the DevCycle server listed as "disconnected • Enter to login": For more details, see the [Claude Code MCP documentation](https://docs.anthropic.com/claude/docs/mcp). + + + +**Step 1: Access MCP Configuration** + +Locate and edit your OpenAI Codex CLI configuration file: + +- **All platforms**: `~/.codex/config.toml` + +**Step 2: Add DevCycle MCP Server** + +Add the following TOML configuration to enable the DevCycle MCP server: + +```toml +[mcp_servers.devcycle] +url = "https://mcp.devcycle.com/mcp" +``` + +**Step 3: Restart Codex CLI** + +Restart your Codex CLI session for the changes to take effect. + +**Step 4: Authentication** + +1. When you first use DevCycle MCP tools, the Codex CLI will prompt for authentication +2. This will open a browser page at `mcp.devcycle.com` for authorization +3. Review and click **"Allow Access"** to grant permissions +4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +5. Return to the Codex CLI where the DevCycle MCP tools will be active + +For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). + @@ -125,38 +157,6 @@ To open VS Code and automatically add the DevCycle MCP, click the install button 7. If you have multiple organizations, select your desired organization at `auth.devcycle.com` 8. You'll be redirected back to VS Code with the server now active - - - -**Step 1: Access MCP Configuration** - -Locate and edit your OpenAI Codex CLI configuration file: - -- **All platforms**: `~/.codex/config.toml` - -**Step 2: Add DevCycle MCP Server** - -Add the following TOML configuration to enable the DevCycle MCP server: - -```toml -[mcp_servers.devcycle] -url = "https://mcp.devcycle.com/mcp" -``` - -**Step 3: Restart Codex CLI** - -Restart your Codex CLI session for the changes to take effect. - -**Step 4: Authentication** - -1. When you first use DevCycle MCP tools, the Codex CLI will prompt for authentication -2. This will open a browser page at `mcp.devcycle.com` for authorization -3. Review and click **"Allow Access"** to grant permissions -4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to the Codex CLI where the DevCycle MCP tools will be active - -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). - diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index 47f44cd5..4b706874 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -384,6 +384,18 @@ Run the following command: claude mcp add --transport stdio devcycle dvc-mcp ``` + + + +Locate and edit your configuration file at `~/.codex/config.toml`: + +```toml +[mcp_servers.devcycle] +command = "dvc-mcp" +``` + +For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). + @@ -414,18 +426,6 @@ Add the following to your `settings.json` file: } ``` - - - -Locate and edit your configuration file at `~/.codex/config.toml`: - -```toml -[mcp_servers.devcycle] -command = "dvc-mcp" -``` - -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). - From 87401b2c5736c1f7fb59d738b84e16db2ab2ccf4 Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Thu, 1 Oct 2026 15:44:16 -0400 Subject: [PATCH 3/6] docs: refresh MCP client setup steps and add Codex App --- docs/cli-mcp/mcp-getting-started.md | 124 +++++++++++++++------------- docs/cli-mcp/mcp-reference.md | 20 ++++- 2 files changed, 81 insertions(+), 63 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 80c3bc58..d1e55179 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -43,40 +43,40 @@ import TabItem from '@theme/TabItem'; -**Step 1: Open Terminal** -Open your terminal to access the Claude CLI. +**Step 1: Add DevCycle MCP Server** -**Step 2: Add DevCycle MCP Server** +Run the following command in your terminal: ```bash claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp ``` -**Step 3: Manage MCP Connection** -In the Claude CLI, enter the MCP management interface: +**Step 2: Manage MCP Connection** + +Start Claude Code and enter the MCP management interface: ```bash /mcp ``` -**Step 4: Authentication** -You'll see the DevCycle server listed as "disconnected • Enter to login": +**Step 3: Authentication** -1. Select the DevCycle server and press Enter to login -2. Follow the CLI prompts to initiate the Authentication process -3. This will open a browser page at `mcp.devcycle.com` for authorization -4. Review and click **"Allow Access"** to grant permissions -5. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -6. Return to Claude Code where the server will show as connected +You'll see the DevCycle server listed as **"Needs authentication"**: + +1. Select the DevCycle server and press Enter to authenticate +2. This will open a browser page at `mcp.devcycle.com` for authorization +3. Review and click **"Allow Access"** to grant permissions +4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +5. Return to Claude Code where the server will show as connected -For more details, see the [Claude Code MCP documentation](https://docs.anthropic.com/claude/docs/mcp). +For more details, see the [Claude Code MCP documentation](https://code.claude.com/docs/en/mcp). **Step 1: Access MCP Configuration** -Locate and edit your OpenAI Codex CLI configuration file: +Locate and edit your Codex configuration file. This file is shared by the Codex CLI, the Codex IDE extension, and the ChatGPT desktop app: - **All platforms**: `~/.codex/config.toml` @@ -89,26 +89,49 @@ Add the following TOML configuration to enable the DevCycle MCP server: url = "https://mcp.devcycle.com/mcp" ``` -**Step 3: Restart Codex CLI** +**Step 3: Authentication** -Restart your Codex CLI session for the changes to take effect. +Run the following command to log in to the DevCycle MCP server: -**Step 4: Authentication** +```bash +codex mcp login devcycle +``` + +1. This will open a browser page at `mcp.devcycle.com` for authorization +2. Review and click **"Allow Access"** to grant permissions +3. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +4. Start a new Codex session where the DevCycle MCP tools will be active + +For more details, see the [OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp). + + + -1. When you first use DevCycle MCP tools, the Codex CLI will prompt for authentication +The Codex app is now part of the ChatGPT desktop app, and shares its MCP configuration with the Codex CLI and IDE extension. + +**Step 1: Add DevCycle MCP Server** + +1. Open the ChatGPT desktop app and go to **Settings** → **MCP servers** +2. Click **"Add server"** and choose **Streamable HTTP** +3. Enter `devcycle` as the name and `https://mcp.devcycle.com/mcp` as the URL +4. Save the server, then click **"Restart"** + +**Step 2: Authentication** + +1. Click **"Authenticate"** next to the DevCycle server in the MCP servers list 2. This will open a browser page at `mcp.devcycle.com` for authorization 3. Review and click **"Allow Access"** to grant permissions 4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to the Codex CLI where the DevCycle MCP tools will be active +5. Return to the app where the DevCycle MCP tools will be active in Codex -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). +For more details, see the [OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp). 📦 Install in Cursor -To open Cursor and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your `~/.cursor/mcp_settings.json` file. To learn more, see the [Cursor documentation](https://docs.cursor.com/advanced/mcp). +To open Cursor and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your `~/.cursor/mcp.json` file. To learn more, see the [Cursor documentation](https://cursor.com/docs/mcp). ```json { @@ -122,8 +145,8 @@ To open Cursor and automatically add the DevCycle MCP, click the install button **Authentication in Cursor:** -1. After configuration, you'll see DevCycle MCP listed as **"Needs login"** with a yellow indicator -2. Click on the DevCycle MCP server to initiate the authorization process +1. After configuration, you'll see DevCycle MCP listed as **"Needs authentication"** on Cursor's **Customize** page +2. Click **"Connect"** on the DevCycle MCP server to initiate the authorization process 3. This opens a browser authorization page at `mcp.devcycle.com` 4. Review and click **"Allow Access"** to grant permissions 5. If you have multiple organizations, select your desired organization at `auth.devcycle.com` @@ -134,12 +157,13 @@ To open Cursor and automatically add the DevCycle MCP, click the install button 📦 Install in VS Code -To open VS Code and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your `.continue/config.json` file. To learn more, see the [Continue documentation](https://docs.continue.dev/reference/Model-Context-Protocol). +To open VS Code and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your workspace `.vscode/mcp.json` file, or run **"MCP: Open User Configuration"** from the Command Palette to add it for all workspaces. To learn more, see the [VS Code MCP documentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers). ```json { - "mcpServers": { - "DevCycle": { + "servers": { + "devcycle": { + "type": "http", "url": "https://mcp.devcycle.com/mcp" } } @@ -148,8 +172,8 @@ To open VS Code and automatically add the DevCycle MCP, click the install button **Authentication in VS Code:** -1. After configuration, open the MCP settings panel in VS Code -2. Find the DevCycle MCP server and click **"Start Server"** +1. After configuration, run **"MCP: List Servers"** from the Command Palette, or use the **Start** code lens in `mcp.json` +2. Select the DevCycle MCP server and start it 3. VS Code will show a dialog: "The MCP Server Definition 'DevCycle' wants to authenticate to mcp.devcycle.com" 4. Click **"Allow"** to proceed with authentication 5. This opens a browser authorization page at `mcp.devcycle.com` @@ -160,44 +184,26 @@ To open VS Code and automatically add the DevCycle MCP, click the install button -**Step 1: Access MCP Configuration** - -**Option 1: Through Claude Desktop Settings (Recommended)** +Claude Desktop connects to the DevCycle MCP as a custom connector, so there's no configuration file to edit. Connectors added here are also available on claude.ai. -1. Open Claude Desktop and go to **Settings** -2. Navigate to **Developer** → **Local MCP servers** -3. Click **"Edit Config"** to open the configuration file directly +**Step 1: Add the DevCycle Connector** -**Option 2: Manual Configuration File** -Alternatively, locate and edit your Claude Desktop configuration file: +1. Open Claude Desktop and go to **Customize** → **Connectors** +2. Click **"+ Add"**, then **"Add custom connector"** +3. Enter `DevCycle` as the name and `https://mcp.devcycle.com/mcp` as the remote MCP server URL, then click **"Continue"** +4. Keep the default authentication settings and click **"Add"** -- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` -- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` +**Team and Enterprise plans:** An Owner must first add the connector in **Organization settings** → **Connectors** using the same URL. Members then find DevCycle under **Customize** → **Connectors** and click **"Connect"**. -**Step 2: Add DevCycle Configuration** -Add or merge the following configuration: +**Step 2: Authentication** -```json -{ - "mcpServers": { - "devcycle": { - "command": "npx", - "args": ["mcp-remote@0.1.18", "https://mcp.devcycle.com/mcp"] - } - } -} -``` - -**Step 3: Restart Claude Desktop** -Close and reopen Claude Desktop for the changes to take effect. - -**Step 4: Authentication** - -1. When you first use DevCycle MCP tools, Claude Desktop will prompt for authentication +1. Click **"Connect"** on the DevCycle connector if you aren't prompted to sign in automatically 2. This will open a browser page at `mcp.devcycle.com` for authorization 3. Review and click **"Allow Access"** to grant permissions 4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to Claude Desktop where the MCP tools will be active +5. Return to Claude Desktop and enable DevCycle from the **"+"** menu → **"Connectors"** in a conversation + +Free plans are limited to one custom connector. For more details, see the [Claude custom connectors documentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index 4b706874..2f21a09d 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -394,12 +394,24 @@ Locate and edit your configuration file at `~/.codex/config.toml`: command = "dvc-mcp" ``` -For more details, see the [OpenAI Codex MCP documentation](https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers). +For more details, see the [OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp). + + + + +The Codex app (part of the ChatGPT desktop app) shares `~/.codex/config.toml` with the Codex CLI. Add the same configuration there, or go to **Settings** → **MCP servers** → **"Add server"**, choose **STDIO**, and enter `dvc-mcp` as the command: + +```toml +[mcp_servers.devcycle] +command = "dvc-mcp" +``` + +For more details, see the [OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp). -Add the following to your `~/.cursor/mcp_settings.json` file: +Add the following to your `~/.cursor/mcp.json` file: ```json { @@ -414,11 +426,11 @@ Add the following to your `~/.cursor/mcp_settings.json` file: -Add the following to your `settings.json` file: +Add the following to your workspace `.vscode/mcp.json` file, or run **"MCP: Open User Configuration"** from the Command Palette to add it for all workspaces. To learn more, see the [VS Code MCP documentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers). ```json { - "mcp.servers": { + "servers": { "devcycle": { "command": "dvc-mcp" } From b838d59b1c6d4d26985e8204130164af735ba530 Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Thu, 1 Oct 2026 16:05:16 -0400 Subject: [PATCH 4/6] docs: group Claude and Codex MCP client tabs and fix tab label wrapping --- docs/cli-mcp/mcp-getting-started.md | 50 ++++++++++++++--------------- docs/cli-mcp/mcp-reference.md | 42 ++++++++++++------------ src/css/custom.css | 9 ++++++ 3 files changed, 55 insertions(+), 46 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index d1e55179..147fd16c 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -40,7 +40,7 @@ These instructions use the remote DevCycle MCP server. For installation of the l import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + **Step 1: Add DevCycle MCP Server** @@ -71,6 +71,30 @@ You'll see the DevCycle server listed as **"Needs authentication"**: For more details, see the [Claude Code MCP documentation](https://code.claude.com/docs/en/mcp). + + + +Claude Desktop connects to the DevCycle MCP as a custom connector, so there's no configuration file to edit. Connectors added here are also available on claude.ai. + +**Step 1: Add the DevCycle Connector** + +1. Open Claude Desktop and go to **Customize** → **Connectors** +2. Click **"+ Add"**, then **"Add custom connector"** +3. Enter `DevCycle` as the name and `https://mcp.devcycle.com/mcp` as the remote MCP server URL, then click **"Continue"** +4. Keep the default authentication settings and click **"Add"** + +**Team and Enterprise plans:** An Owner must first add the connector in **Organization settings** → **Connectors** using the same URL. Members then find DevCycle under **Customize** → **Connectors** and click **"Connect"**. + +**Step 2: Authentication** + +1. Click **"Connect"** on the DevCycle connector if you aren't prompted to sign in automatically +2. This will open a browser page at `mcp.devcycle.com` for authorization +3. Review and click **"Allow Access"** to grant permissions +4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` +5. Return to Claude Desktop and enable DevCycle from the **"+"** menu → **"Connectors"** in a conversation + +Free plans are limited to one custom connector. For more details, see the [Claude custom connectors documentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). + @@ -181,30 +205,6 @@ To open VS Code and automatically add the DevCycle MCP, click the install button 7. If you have multiple organizations, select your desired organization at `auth.devcycle.com` 8. You'll be redirected back to VS Code with the server now active - - - -Claude Desktop connects to the DevCycle MCP as a custom connector, so there's no configuration file to edit. Connectors added here are also available on claude.ai. - -**Step 1: Add the DevCycle Connector** - -1. Open Claude Desktop and go to **Customize** → **Connectors** -2. Click **"+ Add"**, then **"Add custom connector"** -3. Enter `DevCycle` as the name and `https://mcp.devcycle.com/mcp` as the remote MCP server URL, then click **"Continue"** -4. Keep the default authentication settings and click **"Add"** - -**Team and Enterprise plans:** An Owner must first add the connector in **Organization settings** → **Connectors** using the same URL. Members then find DevCycle under **Customize** → **Connectors** and click **"Connect"**. - -**Step 2: Authentication** - -1. Click **"Connect"** on the DevCycle connector if you aren't prompted to sign in automatically -2. This will open a browser page at `mcp.devcycle.com` for authorization -3. Review and click **"Allow Access"** to grant permissions -4. If you have multiple organizations, select your desired organization at `auth.devcycle.com` -5. Return to Claude Desktop and enable DevCycle from the **"+"** menu → **"Connectors"** in a conversation - -Free plans are limited to one custom connector. For more details, see the [Claude custom connectors documentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). - diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index 2f21a09d..d0b8a47f 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -375,7 +375,7 @@ export DEVCYCLE_PROJECT_KEY="your-project-key" import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + Run the following command: @@ -384,6 +384,26 @@ Run the following command: claude mcp add --transport stdio devcycle dvc-mcp ``` + + + +Locate and edit your Claude Desktop configuration file: + +- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` +- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` + +Add the following configuration: + +```json +{ + "mcpServers": { + "devcycle": { + "command": "dvc-mcp" + } + } +} +``` + @@ -438,26 +458,6 @@ Add the following to your workspace `.vscode/mcp.json` file, or run **"MCP: Open } ``` - - - -Locate and edit your Claude Desktop configuration file: - -- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` -- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` - -Add the following configuration: - -```json -{ - "mcpServers": { - "devcycle": { - "command": "dvc-mcp" - } - } -} -``` - diff --git a/src/css/custom.css b/src/css/custom.css index 62b11f33..8e14cdf0 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -347,6 +347,15 @@ html[data-theme='dark'] .DocSearch { color: #3b82f6 !important; } +/* MCP client tabs: wrap onto extra rows instead of squeezing labels onto two lines */ +.mcp-client-tabs { + flex-wrap: wrap; +} + +.mcp-client-tabs .tabs__item { + white-space: nowrap; +} + /* Architecture diagram dark mode fixes */ [data-theme='dark'] img[src*="architecture-docs-diagrams"], [data-theme='dark'] img[src*="architecture-api-diagram"], From e294e0d15f585eb3bd8df2fad42ec8fe44bed840 Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Thu, 1 Oct 2026 16:14:35 -0400 Subject: [PATCH 5/6] docs: match Cursor MCP steps to the Customize page --- docs/cli-mcp/mcp-getting-started.md | 6 +++--- docs/cli-mcp/mcp-reference.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 147fd16c..df917e00 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -155,7 +155,7 @@ For more details, see the [OpenAI Codex MCP documentation](https://developers.op 📦 Install in Cursor -To open Cursor and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your `~/.cursor/mcp.json` file. To learn more, see the [Cursor documentation](https://cursor.com/docs/mcp). +To open Cursor and automatically add the DevCycle MCP, click the install button above. Alternatively, go to **Customize** → **MCPs** in Cursor and click **"New MCP Server"**, which opens your `~/.cursor/mcp.json` file, then add the following configuration. To learn more, see the [Cursor documentation](https://cursor.com/docs/mcp). ```json { @@ -169,8 +169,8 @@ To open Cursor and automatically add the DevCycle MCP, click the install button **Authentication in Cursor:** -1. After configuration, you'll see DevCycle MCP listed as **"Needs authentication"** on Cursor's **Customize** page -2. Click **"Connect"** on the DevCycle MCP server to initiate the authorization process +1. After configuration, DevCycle MCP will be listed under **Needs Attention** as **"Needs authentication"** in **Customize** → **MCPs** +2. Click **"Authenticate"** on the DevCycle MCP server to initiate the authorization process 3. This opens a browser authorization page at `mcp.devcycle.com` 4. Review and click **"Allow Access"** to grant permissions 5. If you have multiple organizations, select your desired organization at `auth.devcycle.com` diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index d0b8a47f..7cb965a5 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -431,7 +431,7 @@ For more details, see the [OpenAI Codex MCP documentation](https://developers.op -Add the following to your `~/.cursor/mcp.json` file: +Go to **Customize** → **MCPs** in Cursor and click **"New MCP Server"**, which opens your `~/.cursor/mcp.json` file, then add the following configuration: ```json { From ff8e2f8b2234f92ad1c329fd7a6882bb6ddda3be Mon Sep 17 00:00:00 2001 From: Jonathan Norris Date: Sun, 4 Oct 2026 22:01:18 -0400 Subject: [PATCH 6/6] docs: address MCP setup review feedback --- docs/cli-mcp/mcp-getting-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index df917e00..81691e16 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -3,9 +3,9 @@ title: MCP Getting Started displayed_sidebar: cli_mcp --- -# DevCyle MCP Getting Started +# DevCycle MCP Getting Started -The DevCycle Model Context Protocol (MCP) Server is based on the DevCycle CLI, it enables AI coding tools like Claude Code and Cursor, or general-purpose tools like Claude Desktop, to interact directly with your DevCycle projects and make changes on your behalf. +The DevCycle Model Context Protocol (MCP) Server is based on the DevCycle CLI and enables AI coding tools like Claude Code and Cursor, or general-purpose tools like Claude Desktop, to interact directly with your DevCycle projects and make changes on your behalf. ## Quick Setup @@ -198,7 +198,7 @@ To open VS Code and automatically add the DevCycle MCP, click the install button 1. After configuration, run **"MCP: List Servers"** from the Command Palette, or use the **Start** code lens in `mcp.json` 2. Select the DevCycle MCP server and start it -3. VS Code will show a dialog: "The MCP Server Definition 'DevCycle' wants to authenticate to mcp.devcycle.com" +3. VS Code will show a dialog saying the MCP server definition wants to authenticate to `mcp.devcycle.com` 4. Click **"Allow"** to proceed with authentication 5. This opens a browser authorization page at `mcp.devcycle.com` 6. Review and click **"Allow Access"** to grant permissions