From 6c5649fc59db30e80dc0eb4418d6cb81ad22c694 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 11:40:49 -0400 Subject: [PATCH 1/9] docs: add OpenCode MCP install instructions --- docs/_partials/mcpInstall.mdx | 6 +++++ docs/cli-mcp/mcp-getting-started.md | 41 +++++++++++++++++++++++++++++ docs/cli-mcp/mcp-reference.md | 19 +++++++++++++ 3 files changed, 66 insertions(+) diff --git a/docs/_partials/mcpInstall.mdx b/docs/_partials/mcpInstall.mdx index d0ea0d05..ccea84ea 100644 --- a/docs/_partials/mcpInstall.mdx +++ b/docs/_partials/mcpInstall.mdx @@ -26,4 +26,10 @@ Follow the [MCP Getting Started](/cli-mcp/mcp-getting-started) guide to quickly claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp ``` +**OpenCode** — add to your `opencode.json`: + +```json +{"mcp":{"devcycle":{"type":"remote","url":"https://mcp.devcycle.com/mcp"}}} +``` + diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 0eeca801..80b6f604 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -271,6 +271,47 @@ Restart your Gemini CLI session for the changes to take effect. 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). + + + +**Step 1: Access MCP Configuration** + +Locate and edit your OpenCode configuration file, `opencode.json`, in your project root or global config directory. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + +**Step 2: Add DevCycle MCP Server** + +Add the following configuration to your `opencode.json`: + +```json +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "devcycle": { + "type": "remote", + "url": "https://mcp.devcycle.com/mcp" + } + } +} +``` + +**Step 3: Restart OpenCode** + +Restart your OpenCode session for the changes to take effect. + +**Step 4: Authentication** + +OpenCode automatically handles OAuth authentication for remote MCP servers. You can also manually trigger authentication: + +```bash +opencode mcp auth devcycle +``` + +1. When you first use DevCycle MCP tools, OpenCode will detect the authentication requirement and initiate the OAuth flow +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 OpenCode where the DevCycle MCP tools will be active + diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index abf3c0c1..7d8a7460 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -447,6 +447,25 @@ 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). + + + +Add the following to your `opencode.json` configuration file: + +```json +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "devcycle": { + "type": "local", + "command": ["dvc-mcp"] + } + } +} +``` + +For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + From f523c812a2c64b315da35aaf6616b599ca369708 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 11:44:58 -0400 Subject: [PATCH 2/9] docs: specify default OpenCode config file paths --- docs/cli-mcp/mcp-getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 80b6f604..0ebeab1b 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -276,7 +276,7 @@ For more details, see the [Gemini CLI MCP documentation](https://github.com/goog **Step 1: Access MCP Configuration** -Locate and edit your OpenCode configuration file, `opencode.json`, in your project root or global config directory. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). +Locate and edit your OpenCode configuration file. This can be either `opencode.json` in your project root or `~/.config/opencode/opencode.json` for global configuration. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). **Step 2: Add DevCycle MCP Server** From 1d472b2d033806cb4156a2ad5e7caaad9e894170 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 11:45:39 -0400 Subject: [PATCH 3/9] docs: simplify OpenCode auth steps to reflect automatic login prompt --- docs/cli-mcp/mcp-getting-started.md | 21 ++++++--------------- 1 file changed, 6 insertions(+), 15 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 0ebeab1b..c9324793 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -294,23 +294,14 @@ Add the following configuration to your `opencode.json`: } ``` -**Step 3: Restart OpenCode** +**Step 3: Authentication** -Restart your OpenCode session for the changes to take effect. +Start OpenCode and it will automatically detect the DevCycle MCP server and prompt you to authenticate: -**Step 4: Authentication** - -OpenCode automatically handles OAuth authentication for remote MCP servers. You can also manually trigger authentication: - -```bash -opencode mcp auth devcycle -``` - -1. When you first use DevCycle MCP tools, OpenCode will detect the authentication requirement and initiate the OAuth flow -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 OpenCode where the DevCycle MCP tools will be active +1. OpenCode 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 OpenCode where the DevCycle MCP tools will be active From 4300d9a952efd2ee7dee9afbd458df104d6cca67 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 11:46:30 -0400 Subject: [PATCH 4/9] docs: use opencode mcp auth command as primary auth step --- docs/cli-mcp/mcp-getting-started.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index c9324793..2e6ba330 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -294,14 +294,20 @@ Add the following configuration to your `opencode.json`: } ``` -**Step 3: Authentication** +**Step 3: Authenticate** -Start OpenCode and it will automatically detect the DevCycle MCP server and prompt you to authenticate: +Run the following command to authenticate with DevCycle: -1. OpenCode will open a browser page at `mcp.devcycle.com` for authorization +```bash +opencode mcp auth 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. Return to OpenCode where the DevCycle MCP tools will be active +4. Return to your terminal where authentication will complete + +The next time you start OpenCode, the DevCycle MCP tools will be available. From 2e76caf38ff783ddc018141391b1676e3717d167 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 11:47:51 -0400 Subject: [PATCH 5/9] docs: pretty-print OpenCode JSON snippet in MCP install partial --- docs/_partials/mcpInstall.mdx | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/_partials/mcpInstall.mdx b/docs/_partials/mcpInstall.mdx index ccea84ea..7a903f82 100644 --- a/docs/_partials/mcpInstall.mdx +++ b/docs/_partials/mcpInstall.mdx @@ -29,7 +29,14 @@ claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp **OpenCode** — add to your `opencode.json`: ```json -{"mcp":{"devcycle":{"type":"remote","url":"https://mcp.devcycle.com/mcp"}}} +{ + "mcp": { + "devcycle": { + "type": "remote", + "url": "https://mcp.devcycle.com/mcp" + } + } +} ``` From 27ad0ca6ee8506774616b47dbbbb024ad3253336 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 12:01:34 -0400 Subject: [PATCH 6/9] docs: move OpenCode tab to right after Claude Code --- docs/cli-mcp/mcp-getting-started.md | 76 ++++++++++++++--------------- docs/cli-mcp/mcp-reference.md | 38 +++++++-------- 2 files changed, 57 insertions(+), 57 deletions(-) diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 2e6ba330..303f0043 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -125,6 +125,44 @@ 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 OpenCode configuration file. This can be either `opencode.json` in your project root or `~/.config/opencode/opencode.json` for global configuration. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + +**Step 2: Add DevCycle MCP Server** + +Add the following configuration to your `opencode.json`: + +```json +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "devcycle": { + "type": "remote", + "url": "https://mcp.devcycle.com/mcp" + } + } +} +``` + +**Step 3: Authenticate** + +Run the following command to authenticate with DevCycle: + +```bash +opencode mcp auth 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. Return to your terminal where authentication will complete + +The next time you start OpenCode, the DevCycle MCP tools will be available. + @@ -271,44 +309,6 @@ Restart your Gemini CLI session for the changes to take effect. 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). - - - -**Step 1: Access MCP Configuration** - -Locate and edit your OpenCode configuration file. This can be either `opencode.json` in your project root or `~/.config/opencode/opencode.json` for global configuration. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). - -**Step 2: Add DevCycle MCP Server** - -Add the following configuration to your `opencode.json`: - -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "devcycle": { - "type": "remote", - "url": "https://mcp.devcycle.com/mcp" - } - } -} -``` - -**Step 3: Authenticate** - -Run the following command to authenticate with DevCycle: - -```bash -opencode mcp auth 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. Return to your terminal where authentication will complete - -The next time you start OpenCode, the DevCycle MCP tools will be available. - diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index 7d8a7460..e4670902 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -383,6 +383,25 @@ Run the following command: claude mcp add --transport stdio devcycle dvc-mcp ``` + + + +Add the following to your `opencode.json` configuration file: + +```json +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "devcycle": { + "type": "local", + "command": ["dvc-mcp"] + } + } +} +``` + +For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + @@ -447,25 +466,6 @@ 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). - - - -Add the following to your `opencode.json` configuration file: - -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "devcycle": { - "type": "local", - "command": ["dvc-mcp"] - } - } -} -``` - -For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). - From a2a2f1513a4209468b738522811a00e3eabe56ab Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 12:03:48 -0400 Subject: [PATCH 7/9] docs: use opencode mcp add CLI command instead of manual config editing --- docs/_partials/mcpInstall.mdx | 13 +------------ docs/cli-mcp/mcp-getting-started.md | 24 +++++++----------------- 2 files changed, 8 insertions(+), 29 deletions(-) diff --git a/docs/_partials/mcpInstall.mdx b/docs/_partials/mcpInstall.mdx index 7a903f82..dbb87da6 100644 --- a/docs/_partials/mcpInstall.mdx +++ b/docs/_partials/mcpInstall.mdx @@ -26,17 +26,6 @@ Follow the [MCP Getting Started](/cli-mcp/mcp-getting-started) guide to quickly claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp ``` -**OpenCode** — add to your `opencode.json`: - -```json -{ - "mcp": { - "devcycle": { - "type": "remote", - "url": "https://mcp.devcycle.com/mcp" - } - } -} -``` +**OpenCode** — run `opencode mcp add` and then `opencode mcp auth devcycle` diff --git a/docs/cli-mcp/mcp-getting-started.md b/docs/cli-mcp/mcp-getting-started.md index 303f0043..0e3a0343 100644 --- a/docs/cli-mcp/mcp-getting-started.md +++ b/docs/cli-mcp/mcp-getting-started.md @@ -128,27 +128,15 @@ For more details, see the [Claude Code MCP documentation](https://docs.anthropic -**Step 1: Access MCP Configuration** - -Locate and edit your OpenCode configuration file. This can be either `opencode.json` in your project root or `~/.config/opencode/opencode.json` for global configuration. To learn more, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). - -**Step 2: Add DevCycle MCP Server** +**Step 1: Add DevCycle MCP Server** -Add the following configuration to your `opencode.json`: +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`): -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "devcycle": { - "type": "remote", - "url": "https://mcp.devcycle.com/mcp" - } - } -} +```bash +opencode mcp add ``` -**Step 3: Authenticate** +**Step 2: Authenticate** Run the following command to authenticate with DevCycle: @@ -163,6 +151,8 @@ opencode mcp auth devcycle The next time you start OpenCode, the DevCycle MCP tools will be available. +For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/). + From 012992cae4b7ce016b3513efb0118b08282e1b84 Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 16:29:41 -0400 Subject: [PATCH 8/9] docs: remove OpenCode from MCP install partial --- docs/_partials/mcpInstall.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/_partials/mcpInstall.mdx b/docs/_partials/mcpInstall.mdx index dbb87da6..d0ea0d05 100644 --- a/docs/_partials/mcpInstall.mdx +++ b/docs/_partials/mcpInstall.mdx @@ -26,6 +26,4 @@ Follow the [MCP Getting Started](/cli-mcp/mcp-getting-started) guide to quickly claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp ``` -**OpenCode** — run `opencode mcp add` and then `opencode mcp auth devcycle` - From b8476a03854c96cf8e94aa98b886e0c19222862e Mon Sep 17 00:00:00 2001 From: Norris Date: Fri, 13 Mar 2026 16:31:54 -0400 Subject: [PATCH 9/9] docs: use opencode mcp add for local server instructions --- docs/cli-mcp/mcp-reference.md | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/docs/cli-mcp/mcp-reference.md b/docs/cli-mcp/mcp-reference.md index e4670902..a51a3bac 100644 --- a/docs/cli-mcp/mcp-reference.md +++ b/docs/cli-mcp/mcp-reference.md @@ -386,18 +386,10 @@ claude mcp add --transport stdio devcycle dvc-mcp -Add the following to your `opencode.json` configuration file: +Run the following command and follow the interactive prompts to add the local DevCycle MCP server (name: `devcycle`, type: `local`, command: `dvc-mcp`): -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "devcycle": { - "type": "local", - "command": ["dvc-mcp"] - } - } -} +```bash +opencode mcp add ``` For more details, see the [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/).