공식 Runpod Model Context Protocol (MCP) 서버. Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, opencode 및 Pi와 같은 MCP 클라이언트가 Runpod Pods, Serverless 엔드포인트, 템플릿, 네트워크 볼륨 등을 관리합니다.

** https://mcp.runpod.io/]**에서 클라이언트를 호스트하고 Runpod에 로그인합니다. 설치, 디스크에 API 키 없음. 또는 npm에서 @runpod/mcp-server로 로컬로 실행합니다.

빠른 시작

guided installer는 클라이언트를 설치하고, 구성할 것을 요구하고, 당신을 위한 config를 쓰다:

그것은 2개의 연결 형태를 제안합니다:

• **Hosted (recommended) ** - 호스팅 서버에서 클라이언트를 점하고 Runpod (OAuth)와 "Sign in with Runpod"로 인증합니다. API 키가 디스크에 저장되지 않습니다.
• Local — 서버가 npx을 통해 실행하고 클라이언트의 설정에서 [T3]]를 저장합니다.

나중에 undo에:

프롬프트를 건너 뛰기 (스크립트, CI, 또는 코딩 에이전트의 쉘에서), 클라이언트 이름을. 지원된 에이즈는 claude-code, cursor], windsurf], claude-desktop], vscode], opencode, pi]:

--client과 단말이 없다면, 설치자는 코드 2로 종료하고 아무것도 구성합니다.

Runpod MCP server

The official Runpod Model Context Protocol (MCP) server. It lets MCP clients such as Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, opencode, and Pi manage your Runpod Pods, Serverless endpoints, templates, network volumes, and more.

We host it for you at https://mcp.runpod.io/ — point your client at that URL and sign in with Runpod. Nothing to install, no API key on disk. Or run it locally from npm as @runpod/mcp-server.

Quick start

The guided installer detects the clients you have installed, asks which to configure, and writes the config for you:

npx @runpod/mcp-server@latest add

It offers two connection modes:

• Hosted (recommended) — points the client at the hosted server and authenticates with “Sign in with Runpod” (OAuth). No API key is stored on disk.
• Local — runs the server through npx and stores a RUNPOD_API_KEY in the client’s config.

To undo later:

npx @runpod/mcp-server@latest remove

To skip the prompts (from a script, CI, or a coding agent’s shell), name the clients. Supported ids are claude-code, cursor, windsurf, claude-desktop, vscode, opencode, and pi:

npx @runpod/mcp-server@latest add --client opencode,pi          # hosted, sign in with Runpod
npx @runpod/mcp-server@latest add --client cursor --local       # local, key read from RUNPOD_API_KEY
npx @runpod/mcp-server@latest remove --client opencode
npx @runpod/mcp-server@latest add --list                        # what's detected, and where each config lives

Without --client and without a terminal, the installer exits with code 2 and configures nothing. With flags it exits 0 when every client was configured and 1 when one failed.

Or install the whole Runpod plugin

For the full agent setup, the official plugin marketplace bundles this server with a router skill plus five more — runpod-mcp, runpodctl, flash, runpod-usage, and companion-clis:

npx skills add runpod/runpod-plugins-official

That works in Claude Code, Codex, Cursor, Copilot, Windsurf, Cline, Gemini, opencode, and 17+ other agents, and installs the skills — pair it with npx @runpod/mcp-server@latest add above for the control-plane tools.

In Claude Code, the native plugin route also wires up the hosted MCP server for you (OAuth included), so no separate setup is needed:

/plugin marketplace add runpod/runpod-plugins-official
/plugin install runpod@runpod

Requirements

• Node.js 20 or higher.
• A Runpod account and API key.

Connect to the hosted server

To configure a client by hand, point it at the hosted server over HTTP (no local process, no API key stored).

Claude Code:

claude mcp add --transport http runpod -s user https://mcp.runpod.io/