# 面向 AI 智能体的 MCP 服务器 | ProxyJam

将 Claude、Cursor 和其他 MCP 客户端连接到您的 ProxyJam 账户：查找套餐、订购和续期代理、查看流量。购买需要等您确认。

- Canonical: https://proxyjam.com/zh/mcp/
- Updated: 2026-10-20
- Language: zh

ProxyJam 的 MCP 服务器为 Claude、Cursor 和其他 AI 客户端提供作用于您账户的 16 个工具：查找套餐、订购和续期代理、查看流量和余额。由您登录并决定智能体可以做什么；任何花钱的操作都会先给您看预览，等您同意后才执行。

您需要一个 ProxyJam 账户。大多数客户端用它登录，其余的使用 API 密钥。服务器本身免费，您只需为智能体订购的代理付费。


ProxyJam 在 `https://proxyjam.com/mcp` 运行一个远程 MCP 服务器，使用 Streamable HTTP。您的 AI 客户端可以用您的 ProxyJam 账户登录（OAuth），也可以发送 API 密钥，然后获得 16 个工具：九个只读、四个修改设置、三个花钱，而这三个在您确认前只做预览。


## 十六个工具，六类工作

### 浏览目录

list_offers 按类型、国家、地区和城市搜索在售套餐，并返回每个套餐的价格。它是套餐 ID 的唯一来源，所以每次购买都从这里开始。

### 订购代理

create_proxy_order 从一个套餐购买 1 到 50 个代理。第一次调用只显示价格和您的余额；您确认后才会下单。

### 续期和增加流量

extend_proxy_period 为代理续期一个周期，buy_proxy_bandwidth 为静态代理增加流量。两者都先显示预览，只在您确认后扣费。

### 查看订单和流量

您的订单及其连接信息，以及每个代理或全部代理已用的流量。只读，智能体可以随意多次调用。

### 掌握资金动向

各币种的钱包余额和完整的交易记录，可以逐笔查看，也可以一次查看一页。同样只读。

### 修改设置

在 HTTP 和 SOCKS5 之间切换代理、替换 IP 白名单、开启或关闭自动续期，或刷新代理状态。这些操作都不收费，但已登录的客户端需要获得花钱权限才能执行。


## 只有您同意，资金才会动

1. **默认只读。** 客户端登录时，ProxyJam 会向您展示它请求的权限。读取订单、钱包和目录的权限一起授予，而订单中包含您代理的登录名和密码。花钱是单独的 *Allow spending from my wallet*（允许从我的钱包花钱）复选框，默认不勾选，它也涵盖免费的设置修改。
2. **先预览。** `create_proxy_order`、`extend_proxy_period` 和 `buy_proxy_bandwidth` 以 `confirm=false` 开始：它们返回套餐、价格和您的余额，不扣任何费用。
3. **您同意，然后扣费。** 智能体只有在您批准预览后，才会带着 `confirm=true` 再次调用。下方提示词中的智能体规则用直白的话写明了这一点。
4. **不会重复扣费。** 确认调用沿用预览的 `idempotency_key`，因此重试的请求会返回第一次的结果，而不是再买一次。新的购买使用新的密钥。
5. **API 密钥会开放整个账户。** 控制台中的密钥没有更细的权限，读取和花钱都包括在内。客户端能登录时请选择登录，并为您确实要用的密钥设置过期日期。
6. **撤销后访问即终止。** 已登录的客户端会列在您[控制台设置](https://app.proxyjam.com/settings)的 *Connected apps*（已连接的应用）下；在那里撤销后，五分钟内停止工作。修改密码或在所有设备上退出登录会撤销所有连接。在 [API 密钥页面](https://app.proxyjam.com/apikey)删除密钥后，该密钥即失效。

## 三步完成连接

1. **把服务器添加到您的客户端** 在上方选择您的客户端并复制其配置。地址是 `https://proxyjam.com/mcp`。
2. **登录并选择它可以做什么** 客户端会在浏览器中打开 ProxyJam。登录后阅读它请求的权限；只有当智能体需要订购、续期或修改设置时，才勾选 *Allow spending from my wallet*。每次批准都会替换上一次，因此之后可以重新连接来更改。无法登录的客户端改用 [API 密钥](https://app.proxyjam.com/apikey)：它以 `pj_` 开头，只显示一次。
3. **从只读提示词开始** 先查询套餐，这与[静态住宅（ISP）代理](/zh/isp-proxies/)页面是同一个实时目录。这样既能证明连接正常，也能让智能体拿到后续操作所需的套餐 ID。然后试试下面的提示词。

## 选择您的客户端

选择一个即可查看连接方法。大多数客户端使用您的 ProxyJam 账户登录；VS Code 和 OpenAI Agents SDK 使用 API 密钥，请把 pj_... 换成您自己的密钥。

### Claude (Anthropic)

claude.ai、Claude Desktop 和移动应用共用同一个连接器列表。

1. 在 Claude 中打开 Connectors（连接器）设置，添加一个自定义连接器。
2. 将其命名为 ProxyJam，并粘贴 https://proxyjam.com/mcp 作为服务器地址。
3. 点击连接，登录 ProxyJam 并批准。

文档中的完整指南: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop

### Claude Code (Anthropic)

在终端中运行，然后在 Claude Code 中输入 /mcp，选择 proxyjam 并登录。加上 --scope user 即可在所有项目中使用。

```
claude mcp add --transport http proxyjam https://proxyjam.com/mcp
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#claude-code

### Cursor (Anysphere)

~/.cursor/mcp.json，或项目中的 .cursor/mcp.json。Cursor 首次连接时会请您登录。

```
{
  "mcpServers": {
    "proxyjam": {
      "url": "https://proxyjam.com/mcp"
    }
  }
}
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#cursor

### ChatGPT (OpenAI)

ChatGPT 会表明自身身份并打开 ProxyJam 登录页面。

1. 在 ChatGPT 设置中开启开发者模式，并创建一个自定义连接器。
2. 输入 https://proxyjam.com/mcp 作为其 URL，并选择 OAuth。
3. 登录 ProxyJam 并批准。

文档中的完整指南: https://docs.proxyjam.com/mcp-server#chatgpt

### Codex CLI (OpenAI)

在终端中依次运行两条命令；第二条会打开浏览器让您登录。

```
codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjam
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#codex-cli

### VS Code (Microsoft)

.vscode/mcp.json，使用 API 密钥。VS Code 只询问一次密钥并安全保存。

```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "proxyjam-api-key",
      "description": "ProxyJam API key",
      "password": true
    }
  ],
  "servers": {
    "proxyjam": {
      "type": "http",
      "url": "https://proxyjam.com/mcp",
      "headers": { "X-API-Key": "${input:proxyjam-api-key}" }
    }
  }
}
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#vs-code

### Gemini CLI (Google)

在终端中运行，然后在 Gemini CLI 中输入 /mcp auth proxyjam 登录。

```
gemini mcp add --transport http proxyjam https://proxyjam.com/mcp
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#gemini-cli

### OpenAI Agents SDK (OpenAI)

Python，使用 API 密钥。pip install openai-agents。

```
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="ProxyJam",
        params={
            "url": "https://proxyjam.com/mcp",
            "headers": {"X-API-Key": "pj_..."},
        },
    ) as proxyjam:
        agent = Agent(
            name="Assistant",
            instructions="Use the ProxyJam tools. Never confirm "
                         "a purchase without the user's yes.",
            mcp_servers=[proxyjam],
        )
        result = await Runner.run(
            agent, "List ISP proxy offers in the United States.")
        print(result.final_output)

asyncio.run(main())
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#openai-agents-sdk

### FastMCP (Prefect)

Python。pip install fastmcp。通过浏览器登录并列出工具。

```
import asyncio
from fastmcp import Client

async def main():
    # auth="oauth" opens your browser to sign in to ProxyJam.
    async with Client("https://proxyjam.com/mcp", auth="oauth") as client:
        for tool in await client.list_tools():
            print(tool.name)

asyncio.run(main())
```

文档中的完整指南: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python


## 七个命令，覆盖日常工作

用简短的命令查找套餐、查看订单和余额，以及购买、续期或增加流量。在 Claude Code 中它们随 ProxyJam 插件提供；其他客户端将同样的命令列为 MCP 提示词。三个花钱的命令会先显示预览，等您同意。

### Claude Code 插件

在 Claude Code 中运行这两条命令，然后输入 /mcp，选择 proxyjam 并登录。插件也会连接服务器，因此可以跳过上面的设置。

```
/plugin marketplace add getproxyjam/claude-plugin
/plugin install proxyjam@proxyjam
```

### 命令

offers、orders、单个 order、balance、buy、extend、bandwidth。参数格式自由，缺少的会向您询问：ID 从不靠猜。

```
/proxyjam:offers [kind] [country]
/proxyjam:orders [status]
/proxyjam:order <order_id>
/proxyjam:balance
/proxyjam:buy <offer_id> [quantity] [period] [payment_method] [promo_code]
/proxyjam:extend <order_id> [months]
/proxyjam:bandwidth <order_id> <gb>
```

### 其他客户端

同样的命令以 MCP 提示词形式提供，适用于任何会列出提示词的客户端。

服务器以 MCP 提示词的形式提供同样的七个命令：offers、orders、order、balance、buy、extend 和 bandwidth。

未安装插件的 Claude Code 会将它们列为 /mcp__proxyjam__offers、/mcp__proxyjam__buy 等。其他支持 MCP 提示词的客户端会在各自的提示词或命令菜单中显示它们。


## 可以试试的提示词

服务器连接后，把其中一条粘贴到智能体的对话中。将 ORDER_ID 替换为控制台中的订单号。最后一个标签页是一组规则，建议放进智能体的指令中。

### 查找代理

只读，安全的第一次调用。

通过 ProxyJam MCP 服务器，列出美国的静态住宅（ISP）代理套餐及其月价格。不要订购任何东西。

### 先预览再购买

只在您同意后扣费。

在 ProxyJam 订购一个美国的静态住宅（ISP）代理，为期一个月。先给我看预览（套餐、价格和我的钱包余额），在确认前等待我明确同意。确认时沿用同一个幂等键。

### 续期

为订单续期，先预览。

将我的 ProxyJam 订单 ORDER_ID 续期一个月。给我看包含价格和余额的预览，在确认前等待我同意。

### 用量和余额

订单、流量和资金，一次回答。

列出我活跃的 ProxyJam 代理及其到期日期和各自已用的流量，然后显示我的美元钱包余额和最近 10 笔交易。

### 设置

不花钱的修改。

对于我的 ProxyJam 订单 ORDER_ID：把协议切换为 SOCKS5，把 IP 白名单设置为 203.0.113.7，并开启自动续期。然后告诉我新的设置。

### 智能体规则

用于 CLAUDE.md、AGENTS.md 或 Cursor rules。

使用 ProxyJam MCP 服务器时：
- 先调用 list_offers。它是套餐 ID 的唯一来源。
- create_proxy_order、extend_proxy_period 和 buy_proxy_bandwidth 在 confirm=true 之前都只是预览。把预览给我看，没有我的明确同意绝不确认。
- 确认时使用与预览相同的 idempotency_key。每次新的购买都使用新的密钥。
- 如果预览显示余额低于价格，请停下来告诉我，而不是确认。
- 如果某个工具因为未允许花钱而被拒绝，请告诉我而不是重试；是否带着花钱权限重新连接由我决定。
- 把我的 API 密钥当作机密：绝不打印、记录，或写进我可能分享的文件。


## 全部 16 个工具

| 工具 | 作用 | 影响 |
|---|---|---|
| list_offers | 按类型、国家、地区和城市搜索目录；返回套餐 ID 和价格 | 只读 |
| list_my_orders | 分页列出您的代理订单 | 只读 |
| get_order | 单个订单的完整信息，包括代理的连接信息 | 只读 |
| get_my_traffic_summary | 过去 7 天内您所有代理的流量用量 | 只读 |
| get_order_traffic | 过去 7 天内单个订单的流量用量 | 只读 |
| list_my_wallets | 您的钱包，每个币种一个 | 只读 |
| get_wallet_balance | 单个钱包的余额 | 只读 |
| list_wallet_transactions | 分页查看钱包的交易记录 | 只读 |
| get_transaction | 单笔交易 | 只读 |
| create_proxy_order | 从一个套餐购买 1 到 50 个代理 | 花钱，先预览 |
| extend_proxy_period | 为活跃代理续期 1 到 24 个月 | 花钱，先预览 |
| buy_proxy_bandwidth | 为静态代理增加 1 到 5,000 GB 流量 | 花钱，先预览 |
| set_auto_renew | 开启或关闭自动续期 | 修改设置，免费 |
| set_proxy_whitelist | 替换允许使用该代理的 IP 列表 | 修改设置，免费 |
| change_proxy_protocol | 在 HTTP 和 SOCKS5 之间切换 | 修改设置，免费 |
| sync_proxy_state | 重新读取代理的当前状态 | 修改设置，免费 |

服务器当前列出的工具。三个花钱的工具在带 confirm=true 再次调用之前都返回预览。已登录的客户端只有在您允许花钱时，才能调用最后七个。


## 连接信息

- **端点:** https://proxyjam.com/mcp
- **传输方式:** Streamable HTTP
- **身份验证:** 使用您的 ProxyJam 账户登录（OAuth 2.1），或在 X-API-Key 请求头中提供 API 密钥
- **访问权限:** 默认只读；花钱和修改设置只在您允许时可用
- **参考列表:** 订单状态、币种、代理协议、套餐种类和付款方式，以 MCP 资源形式提供
- **价格:** 免费。您只需为订购的代理付费

## 关于 MCP 服务器的问题

### 哪些 AI 客户端可以连接？

任何能够通过 Streamable HTTP 连接远程服务器，并且支持 OAuth 登录或允许添加请求头的 MCP 客户端。上面的配置涵盖 Claude（claude.ai、Claude Desktop 和移动应用）、Claude Code、Cursor、ChatGPT、VS Code、Codex CLI、Gemini CLI、OpenAI Agents SDK 和 FastMCP。

### 可以连接到 claude.ai 或 ChatGPT 吗？

可以。在 Claude 中添加一个地址为 https://proxyjam.com/mcp 的自定义连接器，然后登录 ProxyJam；该连接器也会出现在 Claude Desktop 和移动应用中。在 ChatGPT 中，自定义 MCP 连接器需要开发者模式，OpenAI 在部分套餐中以测试版提供；添加同一个地址并选择 OAuth。

### MCP 服务器收费吗？

不收费。连接和调用工具都是免费的。您只需从 ProxyJam 钱包为智能体订购的东西付费，价格与控制台相同。

### 我的智能体会不经询问就花钱吗？

不会意外发生。登录的客户端如果在您批准时没有勾选 *Allow spending from my wallet*，就完全不能花钱。即使勾选了，三个收费工具（订购、续期和购买流量）第一次调用也只返回预览，只有带 confirm=true 再次调用时才扣费；谨慎的智能体会把预览给您看并等待，上面的智能体规则也是这样要求的。API 密钥没有花钱上限，因此请给智能体一个可以随时删除的密钥。

### 智能体通过 MCP 不能做什么？

为钱包充值、管理 API 密钥、修改账户设置、检查 IP 地址，或使用移动代理的操作（例如重置 IP）。这些仍在控制台和 REST API 中进行。

### 我需要 API 密钥吗？

如果您的客户端能登录，就不需要。既没有登录也没有密钥的请求会被拒绝，并指向 ProxyJam 的登录页面，claude.ai、Claude Code、Cursor 等客户端正是这样自行发起登录的。无法登录的客户端改为发送 API 密钥。

### 之后如何允许花钱，或收回这项权限？

重新连接，并在批准时勾选或取消勾选该复选框：每次批准都会替换上一次。例如在 Claude Code 中，就是输入 /mcp，然后再次登录 proxyjam。

### 如何撤销智能体的访问权限？

对于已登录的客户端，在控制台设置的 Connected apps 下撤销；五分钟内停止工作，您的其他连接不受影响。修改密码或在所有设备上退出登录会一次性撤销全部连接。对于 API 密钥，在 API 密钥页面删除即可；设置了过期日期的密钥到期后也会自动失效。

### 智能体可以自行注册吗？

可以，但有限制。没有账户的智能体可以注册并获得一个只能读取公开目录的密钥。如果您用 ProxyJam 发到您邮箱的验证码认领该密钥，它就会加入您的账户，可以读取您的订单和钱包，但永远不能花钱。面向智能体的步骤写在 auth.md 中。


## 从小处开始

先连接、查询套餐，读一读返回的内容，再让智能体订购任何东西。到了购买的时候，预览会显示套餐、价格和您的余额，在您同意之前不会扣任何费用。



## 资料来源

- [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)（英文）：本服务器使用的 Streamable HTTP 传输方式
- [MCP 服务器卡片](/.well-known/mcp/server-card.json)：端点、传输方式和身份验证，供自行发现 ProxyJam 的智能体使用
- [auth.md](/auth.md)（英文）：智能体如何登录、注册或使用 API 密钥
- [OAuth 授权服务器元数据](/.well-known/oauth-authorization-server)：客户端登录时发现的端点和权限范围
- [ProxyJam 智能体技能](/.well-known/agent-skills/proxyjam/SKILL.md)（英文）：智能体可以在第一次调用前加载的使用指南




MCP，即 [Model Context Protocol](https://modelcontextprotocol.io/)（英文），是 AI 助手调用外部工具所用的开放标准。把 MCP 客户端指向 ProxyJam 的服务器后，您的智能体就能在您的账户上完成 REST API 中 API 密钥能做的大部分事情。开始之前，有两点值得了解。

**由您决定它可以做什么。** 登录的客户端会先请求您批准。读取权限作为一个整体授予，其中包括您代理的登录名和密码；从钱包花钱（以及随之而来的免费设置修改）是一个单独的复选框，只有当您希望智能体采取行动时才勾选。API 密钥则不同：它会开放整个账户，因此客户端能登录时请优先选择登录。

**资金只在预览之后才会动。** 三个收费工具在第一次调用时从不扣费。它们返回一个标记为 `dry_run` 的预览，只有带 `confirm=true` 再次调用时才扣费，而谨慎的智能体只会在您同意后才这样做。