Skip to content

docs: document how to start a remote MCP Coder server #19150

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 4, 2025
Merged

docs: document how to start a remote MCP Coder server #19150

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9f129a1
docs: remote mcp
hugodutka Jul 30, 2025
841f725
fix: Claude -> claude.ai
hugodutka Aug 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: remote mcp
  • Loading branch information
@hugodutka
hugodutka committed Aug 4, 2025
commit 9f129a145aa10b59f121556aab50e20004b6c7b2
29 changes: 27 additions & 2 deletions docs/ai-coder/mcp-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MCP Server

Power users can configure Claude Desktop, Cursor, or other external agents to interact with Coder in order to:
Power users can configure Claude, Claude Desktop, Cursor, or other external agents to interact with Coder in order to:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Either

Suggested change
Power users can configure Claude, Claude Desktop, Cursor, or other external agents to interact with Coder in order to:
Power users can configure Claude Code, Claude Desktop, Cursor, or other external agents to interact with Coder in order to:

or

Suggested change
Power users can configure Claude, Claude Desktop, Cursor, or other external agents to interact with Coder in order to:
Power users can configure claude.ai, Claude Desktop, Cursor, or other external agents to interact with Coder in order to:


- List workspaces
- Create/start/stop workspaces
Expand All @@ -12,6 +12,8 @@ Power users can configure Claude Desktop, Cursor, or other external agents to in

In this model, any custom agent could interact with a remote Coder workspace, or Coder can be used in a remote pipeline or a larger workflow.

## Local MCP server

The Coder CLI has options to automatically configure MCP servers for you. On your local machine, run the following command:

```sh
Expand All @@ -30,4 +32,27 @@ coder exp mcp server
```

> [!NOTE]
> The MCP server is authenticated with the same identity as your Coder CLI and can perform any action on the user's behalf. Fine-grained permissions and a remote MCP server are in development. [Contact us](https://coder.com/contact) if this use case is important to you.
> The MCP server is authenticated with the same identity as your Coder CLI and can perform any action on the user's behalf. Fine-grained permissions are in development. [Contact us](https://coder.com/contact) if this use case is important to you.

## Remote MCP server

Coder can expose an MCP server via HTTP. This is useful for connecting web-based agents, like https://claude.ai/, to Coder. This is an experimental feature and is subject to change.

To enable this feature, activate the `oauth2` and `mcp-server-http` experiments using an environment variable or a CLI flag:

```sh
CODER_EXPERIMENTS="oauth2,mcp-server-http" coder server
# or
coder server --experiments=oauth2,mcp-server-http
```

The Coder server will expose the MCP server at:

```txt
https://coder.example.com/api/experimental/mcp/http
```

> [!NOTE]
> At this time, the remote MCP server is not compatible with web-based ChatGPT.

Users can authenticate applications to use the remote MCP server with OAuth2. An authenticated application can perform any action on the user's behalf. Fine-grained permissions are in development.
Loading