From d958002e16509d1380d6f986971e122f3b040856 Mon Sep 17 00:00:00 2001 From: Luke Piette Date: Thu, 15 Oct 2026 15:55:10 -0700 Subject: [PATCH] docs: have agents run the MCP installer with --client @runpod/mcp-server 4.3.0 adds a no-prompt mode (add --client ) with honest exit codes and opencode support. Agents can now run the installer themselves, so the agent-setup page drops the User step that handed it to the user. Co-Authored-By: Claude Opus 5.5 --- agent-setup.mdx | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/agent-setup.mdx b/agent-setup.mdx index 299a3235..77d6719a 100644 --- a/agent-setup.mdx +++ b/agent-setup.mdx @@ -115,11 +115,23 @@ pi mcp add runpod --url https://mcp.runpod.io/ #### Cursor, GitHub Copilot, Windsurf, Cline, opencode, and all other agents -Add a server entry named `runpod` with the HTTP (streamable HTTP) transport and URL `https://mcp.runpod.io/` to your agent's MCP configuration. Merge it into the existing file; do not overwrite other servers. See your agent's MCP documentation in [Resources](#resources) for the file location and format. +For Cursor, Windsurf, VS Code (GitHub Copilot), opencode, and Claude Desktop, run the installer with your agent's id. It writes the config without prompts: -Do not run `npx @runpod/mcp-server@latest add` yourself. It's an interactive wizard for people at a terminal: in an agent shell it exits without writing any config, and it only supports Claude Code, Cursor, Windsurf, Claude Desktop, and VS Code. If you can't edit your agent's MCP config, hand it to the user: +``` +npx @runpod/mcp-server@latest add --client +``` + +| Agent | `--client` id | +|---|---| +| Cursor | `cursor` | +| Windsurf | `windsurf` | +| VS Code (GitHub Copilot) | `vscode` | +| opencode | `opencode` | +| Claude Desktop | `claude-desktop` | + +The installer needs Node 20 or later. It exits `0` when every named client was configured, `1` when one failed, and `2` on bad usage. Run `npx @runpod/mcp-server@latest add --list` to see which clients it detects and where each config lives. Always pass `--client`: without it and without a terminal, the installer exits `2` and configures nothing. After it writes the config, it prints the sign-in step for each client (for example, restart Cursor, or run `opencode mcp auth runpod`); do that step or relay it to the user. -> **User step.** Ask the user to run `npx @runpod/mcp-server@latest add` in their own terminal and pick your agent. +For any other agent, such as Cline, add a server entry named `runpod` with the HTTP (streamable HTTP) transport and URL `https://mcp.runpod.io/` to your agent's MCP configuration. Merge it into the existing file; do not overwrite other servers. See your agent's MCP documentation in [Resources](#resources) for the file location and format. After registering, the user approves the OAuth sign-in in the browser the first time you call a Runpod tool.