> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PPIO MCP Server

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

```bash theme={null}
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](https://mcp.ppio.com/mcp)

点击 Add，添加后下方 Not connected 下方会出现 PPIO，选择后点击右侧 Connect，在打开的授权页面中完成授权即可使用。

***

## Cursor

打开 **Settings → Cursor Settings → Tools & MCP → New MCP Server**，添加：

```json theme={null}
{
  "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

```bash theme={null}
codex mcp add ppio --url https://mcp.ppio.com/mcp
codex mcp login ppio
```

注意：首次在 Codex 中使用 MCP，需在 `~/.codex/config.toml` 中启用 `rmcp` 功能：

```toml theme={null}
[features]
experimental_use_rmcp_client = true
```

或者可以直接在 `~/.codex/config.toml` 配置文件中完整添加：

```toml theme={null}
[features]
experimental_use_rmcp_client = true

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

***

## Zed

按 `Cmd + ,` 打开设置，添加：

```json theme={null}
{
  "context_servers": {
    "ppio": {
      "url": "https://mcp.ppio.com/mcp"
    }
  }
}
```

添加后 Zed 会自动开始授权流程，完成后即可使用

***

## 可用工具

连接成功后，AI 可使用两个工具：

* **`search`** — 查询 PPIO OpenAPI 规范，发现可用接口
* **`execute`** — 调用 PPIO API，操作你账号下的资源

示例提问：

* "我在 PPIO 有哪些运行中的 GPU 实例？"
* "帮我在 PPIO 创建一个 RTX 4090 实例"
* "列出我的所有镜像"

***