Skip to content

docs(docs): add bring your own MCP servers guide for Coder Agents (#31495) - #31698

Open
github-actions[bot] wants to merge 1 commit into
release/2.39from
backport/31495-to-2.39
Open

github-actions[bot] wants to merge 1 commit into
release/2.39from
backport/31495-to-2.39

Conversation

@github-actions

@github-actions github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

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

…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)
@github-actions github-actions Bot added the cherry-pick/v2.39 Cherry-pick PR targeting release/2.39 label Nov 3, 2026
@github-actions github-actions Bot added the cherry-pick/v2.39 Cherry-pick PR targeting release/2.39 label Nov 3, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cherry-pick/v2.39 Cherry-pick PR targeting release/2.39

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants