Repository navigation
docs(docs): add bring your own MCP servers guide for Coder Agents (#31495) - #31698
Open
github-actions[bot] wants to merge 1 commit into
Open
github-actions[bot] wants to merge 1 commit into
github-actions[bot] wants to merge 1 commit into
Conversation
…1495) Adds a user-facing **Bring your own MCP servers** page for Coder Agents, aimed at developers coming from Claude Code who want `claude mcp add`-style personal servers without an org admin registering each one. The page compares the three options (workspace `.mcp.json`, organization MCP servers, inline MCP servers), then walks through writing `.mcp.json` from dotfiles or `~/personalize`, keeping tokens in user secrets, and reusing a Claude Code setup. It also links the page from **Extending agents** and adds it to the manifest. Behavior verified against `main`: - `.mcp.json` resolves relative to the agent's `dir`. With no `dir`, no file is read (`agent/agentcontextconfig`, `agent.go` `workingDirFn`). - stdio servers inherit user-secret env vars through `updateCommandEnv`. `${VAR}` expansion only applies to `env` values and uses the agent process env, which doesn't include user secrets (`agent/x/agentmcp/config.go`). - Accepted `type` values are `stdio`, `http`, `sse`. `streamable-http` is not accepted yet (#29324 would change that). - The config watcher picks up a late-created `.mcp.json`. MCP-only edits don't mark existing chats out of date. The `claude mcp add --scope project` example follows Claude Code's docs and hasn't been tested end to end in a Coder workspace. `markdownlint-cli2`, `markdown-table-formatter`, and Vale pass on the new page. Requested in Slack by Michael Suchacz, prompted by a customer ask for BYO MCP in Coder Agents. --------- Co-authored-by: coder[bot] <137810501+coder[bot]@users.noreply.github.com> Co-authored-by: Nick Vigilante <nick.vigilante@coder.com> (cherry picked from commit effc49e)
nickvigilante
approved these changes
Nov 3, 2026
matifali
approved these changes
Nov 3, 2026
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Cherry-pick of #31495
Original PR: #31495 — docs(docs): add bring your own MCP servers guide for Coder Agents
Merge commit: effc49e
Requested by: @nickvigilante