将您的 AI 智能体连接到 ProxyJam

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

选择您的客户端

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

选择您的客户端

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

Anthropic

Claude

claude.ai、Claude Desktop 和移动应用。将 ProxyJam 添加一次为自定义连接器，它就会出现在这三处。

显示设置隐藏设置登录

Claude

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

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

文档中的完整指南

Anthropic

Claude Code

Anthropic 的终端编程智能体。一条命令添加服务器，/mcp 完成登录。

显示设置隐藏设置登录

Claude Code

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

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

文档中的完整指南

Anysphere

Cursor

AI 代码编辑器。把服务器添加到 mcp.json，Cursor 首次连接时会请您登录。

显示设置隐藏设置登录

Cursor

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

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

文档中的完整指南

OpenAI

ChatGPT

自定义连接器需要开发者模式，OpenAI 在部分套餐中以测试版提供。

显示设置隐藏设置登录

ChatGPT

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

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

文档中的完整指南

OpenAI

Codex CLI

OpenAI 的终端编程智能体。两条命令：添加服务器，然后登录。

显示设置隐藏设置登录

Codex CLI

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

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

文档中的完整指南

Microsoft

VS Code

Copilot Chat 中的智能体模式。使用 API 密钥连接，VS Code 只询问一次并安全保存。

显示设置隐藏设置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}" }
    }
  }
}

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

文档中的完整指南

Google

Gemini CLI

Google 的终端智能体。添加服务器后，用 /mcp auth proxyjam 登录。

显示设置隐藏设置登录

Gemini CLI

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

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

文档中的完整指南

OpenAI

OpenAI Agents SDK

用于构建自有智能体的 Python 框架。通过请求头中的 API 密钥连接。

显示设置隐藏设置API 密钥

OpenAI Agents SDK

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())

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

文档中的完整指南

Prefect

FastMCP

用于 MCP 客户端和服务器的 Python 库。通过浏览器登录并列出工具。

显示设置隐藏设置登录

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())

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

文档中的完整指南

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

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

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

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

您的智能体能做什么

十六个工具，六类工作

浏览目录

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

订购代理

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

续期和增加流量

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

查看订单和流量

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

掌握资金动向

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

修改设置

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

安全

只有您同意，资金才会动

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

设置

三步完成连接

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

Claude Code 插件命令其他客户端

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

/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 提示词的形式提供同样的七个命令：offers、orders、order、balance、buy、extend 和 bandwidth。

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

斜杠命令

七个命令，覆盖日常工作

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

Claude Code 插件在 Claude Code 中运行这两条命令，然后输入 /mcp，选择 proxyjam 并登录。插件也会连接服务器，因此可以跳过上面的设置。命令 offers、orders、单个 order、balance、buy、extend、bandwidth。参数格式自由，缺少的会向您询问：ID 从不靠猜。其他客户端同样的命令以 MCP 提示词形式提供，适用于任何会列出提示词的客户端。

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

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

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

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

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

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

提示词

可以试试的提示词

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

查找代理只读，安全的第一次调用。先预览再购买只在您同意后扣费。续期为订单续期，先预览。用量和余额订单、流量和资金，一次回答。设置不花钱的修改。智能体规则用于 CLAUDE.md、AGENTS.md 或 Cursor rules。

参考

全部 16 个工具

服务器当前列出的工具。三个花钱的工具在带 confirm=true 再次调用之前都返回预览。已登录的客户端只有在您允许花钱时，才能调用最后七个。
工具	作用	影响
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	重新读取代理的当前状态	修改设置，免费

服务器

连接信息

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

文档

延伸阅读

MCP 服务器指南（英文）每个工具的参数和一个完整的下单示例

快速入门（英文）从注册到第一次 API 调用

身份验证（英文）创建、设置过期和撤销密钥

幂等性（英文）重试如何避免重复扣费

API 参考每个 REST 端点，可在浏览器中运行

OpenAPI 规范供代码生成器使用的 API 描述

常见问题

关于 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（英文）：本服务器使用的 Streamable HTTP 传输方式
MCP 服务器卡片：端点、传输方式和身份验证，供自行发现 ProxyJam 的智能体使用
auth.md（英文）：智能体如何登录、注册或使用 API 密钥
OAuth 授权服务器元数据：客户端登录时发现的端点和权限范围
ProxyJam 智能体技能（英文）：智能体可以在第一次调用前加载的使用指南

将您的 AI 智能体 连接到 ProxyJam

选择您的客户端

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

十六个工具，六类工作

浏览目录

订购代理

续期和增加流量

查看订单和流量

掌握资金动向

修改设置

只有您同意，资金才会动

三步完成连接

把服务器添加到您的客户端

登录并选择它可以做什么

从只读提示词开始

七个命令，覆盖日常工作

可以试试的提示词

全部 16 个工具

连接信息

延伸阅读

关于 MCP 服务器的问题

从小处开始

资料来源

将您的 AI 智能体连接到 ProxyJam