跳转到主要内容
PPIO MCP Server 通过 Model Context Protocol 将 PPIO 平台 OpenAPI 暴露给 AI Agent 工具,让 Claude、Cursor 等 AI Agent 能够直接查询和操作你的 PPIO 资源。目前可查询和操作 GPU 实例、存储、镜像、账单等资源。 服务采用 OAuth 2.1 认证,托管端点:
https://mcp.ppio.com/mcp
首次连接时会自动打开 PPIO OAuth 授权页面,使用您的 PPIO 账号登录即可。授权完成后,Agent 发起的所有 API 调用均使用您本人的身份,只能访问您账号下的数据。授权后您可以尝试给 Agent 发送这样的信息测试效果。比如:
“列出我在 PPIO 所有运行中的 GPU 实例”
常见 Agent 的安装方法如下:

Claude Code

claude mcp add --transport http ppio https://mcp.ppio.com/mcp
添加后在 Claude Code 中运行 /mcp,选择 ppio, 选择 Authenticate,会打开授权页面,完成授权即可使用。

Claude Desktop 客户端

前往 Settings > Connectors > 点击顶部的「Go to Customize」> 点击标题「Connectors」右边的 ➕ > Add custom connector 填写: Name: PPIO, Remote MCP server URL: https://mcp.ppio.com/mcp 点击 Add,添加后下方 Not connected 下方会出现 PPIO,选择后点击右侧 Connect,在打开的授权页面中完成授权即可使用。

Cursor

打开 Settings → Cursor Settings → Tools & MCP → New MCP Server,添加:
{
  "mcpServers": {
    "ppio": {
      "url": "https://mcp.ppio.com/mcp"
    }
  }
}
保存后回到 Tools & MCP 页,点击新增的 ppio 右侧的 Connect 按钮,完成授权即可使用。

VS Code

Ctrl/Cmd + P,搜索 MCP: Add Server,选择 HTTP (HTTP or Server-Sent Events),输入:
https://mcp.ppio.com/mcp
然后命名为 ppio 后确认。允许在浏览器打开授权页面,完成授权后即可使用。

Codex

codex mcp add ppio --url https://mcp.ppio.com/mcp
codex mcp login ppio
注意:首次在 Codex 中使用 MCP,需在 ~/.codex/config.toml 中启用 rmcp 功能:
[features]
experimental_use_rmcp_client = true
或者可以直接在 ~/.codex/config.toml 配置文件中完整添加:
[features]
experimental_use_rmcp_client = true

[mcp_servers.ppio]
url = "https://mcp.ppio.com/mcp"

Zed

Cmd + , 打开设置,添加:
{
  "context_servers": {
    "ppio": {
      "url": "https://mcp.ppio.com/mcp"
    }
  }
}
添加后 Zed 会自动开始授权流程,完成后即可使用

可用工具

连接成功后,AI 可使用两个工具:
  • search — 查询 PPIO OpenAPI 规范,发现可用接口
  • execute — 调用 PPIO API,操作你账号下的资源
示例提问:
  • “我在 PPIO 有哪些运行中的 GPU 实例?”
  • “帮我在 PPIO 创建一个 RTX 4090 实例”
  • “列出我的所有镜像”