代理 MCP 服务器：让 Claude Code、Codex、Cursor 自己用代理

两个都叫“代理”的东西，别搞混

代理 MCP 服务器，指的是替 AI 助手管理 IP 代理的 MCP 服务器。助手调用一个有名字的工具，比如“取某国代理地址”或“通过代理打开网页”，用户名、密码和 API 密钥都留在服务器配置里，不写进对话。

名字容易和 mcp-proxy 混。它是一个开源工具，仓库自己的介绍是“A bridge between Streamable HTTP and stdio MCP transports”（Streamable HTTP 与 stdio 两种 MCP 传输方式之间的桥）。它的作用是在两种传输方式之间转发 MCP 消息，让只会其中一种的客户端也能连上另一种服务器，跟 IP 地址、国家、出口节点都没关系。本文说的“代理 MCP 服务器”，都是前一种。

• 来源：
• mcp-proxy (sparfenyuk) README

本地和远程 MCP 服务器

MCP 官方文档按运行位置把服务器分成两类。本地服务器用 stdio 传输：客户端在你自己的电脑上把它作为一个进程启动，通过标准输入输出和它通信，没有网络开销。远程服务器用 Streamable HTTP 传输：它放在一个网址上，这种传输方式支持 Bearer 令牌、API 密钥和自定义请求头来认证。

这决定了密钥放哪儿。本地服务器：客户端把密钥当环境变量交给进程。远程服务器：密钥一般作为请求头随每次请求发出。不管哪种，代理 MCP 服务器的意义都是密钥不用出现在提示词里。

• 来源：
• MCP documentation: Architecture overview

装之前先查三件事

先看工具列表。代理 MCP 服务器带着你的凭据运行，还能调用要付费的服务，每个工具的名字和说明都读一遍。

看有没有工具能买东西或花钱包里的钱。如果有，想清楚你要不要，能选没有购买功能的就选没有的。

看密钥放哪儿。放环境变量，或者不提交到版本库的客户端配置文件里；不要写进提示词，因为提示词会留在对话历史里。

proxy302-mcp：官方 MCP 服务

proxy302-mcp 是 Proxy302 官方的 MCP 服务，在 GitHub 开源，由 Proxy302 团队维护。账号和计费问题找 Proxy302 客服，服务本身的 bug 提到 GitHub issues。

它免费、开源（MIT 协议），从 GitHub 用 npx 安装，在你自己的电脑上通过 stdio 运行，需要 Node.js 20 及以上，并把 Proxy302 API 密钥放进 PROXY302_API_KEY 环境变量。它的工具包括：用量和钱包余额、国家和地区、产品和套餐、取某国的动态住宅代理地址、你自己的代理，以及通过代理打开网址（纯 HTTP，不渲染 JavaScript）。

它不能买任何东西，也不能花钱包里的钱。它唯一的写操作是创建免费的动态代理凭据，默认关闭，流量只在用到时才计费。Proxy302 的接口本身写在开发者文档里。

• 开发者文档

• 来源：
• proxy302-mcp 的 README（Proxy302 官方 MCP 服务）

在 Claude Code、Codex CLI、Cursor 里装 proxy302-mcp

proxy302-mcp 是用 npx 启动的本地 stdio 服务器，下面三个工具都会把它当进程启动，并把 PROXY302_API_KEY 交给它。把 <key id>:<secret> 换成你自己的 API 密钥。密钥放在环境变量里，不要写进提示词。

Claude Code：服务器名要写在 -e 前面，-- 把 Claude Code 自己的选项和服务器启动命令隔开。-s user 表示所有项目都能用；不写则只在当前项目有效。

• 来源：
• Claude Code docs: Connect Claude Code to tools via MCP
• Codex docs: Model Context Protocol
• Cursor docs: Model Context Protocol

Claude Code：安装命令

claude mcp add proxy302 -s user -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

仅为示例：把 <key id>:<secret> 换成你自己的密钥。

• 来源：
• Claude Code docs: Connect Claude Code to tools via MCP

在 Codex CLI 里安装

Codex CLI：用命令安装，或者把同样的服务器写进 ~/.codex/config.toml。

Codex CLI：安装命令

codex mcp add proxy302 --env PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

仅为示例：把 <key id>:<secret> 换成你自己的密钥。

• 来源：
• Codex docs: Model Context Protocol

Codex CLI：config.toml 写法

[mcp_servers.proxy302]
command = "npx"
args = ["-y", "github:proxy302/proxy302-mcp"]
env = { PROXY302_API_KEY = "<key id>:<secret>" }

同一个服务器，写进 ~/.codex/config.toml。

• 来源：
• Codex docs: Model Context Protocol

在 Cursor 里安装

Cursor：写进 ~/.cursor/mcp.json（所有项目）或某个项目里的 .cursor/mcp.json。

Cursor：mcp.json

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}

仅为示例：把 <key id>:<secret> 换成你自己的密钥。

• 来源：
• Cursor docs: Model Context Protocol

远程 MCP 地址

也可以什么都不装，直接连远程 MCP：https://proxy302.com/v1/mcp。客户端走 Streamable HTTP，把 Proxy302 API 密钥放进 Authorization 请求头，写成 Bearer <key id>:<secret>。它有 9 个工具，能查账户余额和用量、国家和地区列表、商品和价格，拿一个指定国家的动态住宅代理，列出你的代理（静态 IP 带出口地址），换 IP，查 IP 纯净度，还能估算花费并和钱包余额对比。这些工具都不花钱，买东西还是在控制台。

Claude、ChatGPT 网页版用另一个地址 https://mcp.proxy302.com/mcp，它带授权页。在 Claude 里打开 Settings → Connectors → Add custom connector（设置 → 连接器 → 添加自定义连接器）；ChatGPT 要先打开开发者模式（Developer mode），再添加连接器。填入地址，弹出 Proxy302 授权页后，粘贴控制台 API 密钥页的「密钥 ID:密钥」，点同意就行。在控制台删掉这个密钥，连接就断了。Claude Code、Cursor、Dify 这类能填请求头的客户端，两个地址都能用，请求头照样写 Authorization。

• 来源：
• Proxy302 remote MCP endpoint

Claude Code：连远程地址

claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"

--transport http 和 --header 两个参数见 Claude Code 的 MCP 文档。Cursor、VS Code、Codex、Gemini CLI 在各自的 MCP 配置里填同样的地址和 Authorization 请求头。

• 来源：
• Claude Code docs: Connect Claude Code to tools via MCP
• Proxy302 remote MCP endpoint

让 MCP 服务器自己的请求也走代理

给工具配代理，和让 MCP 服务器自己发出去的请求走代理，是两件事。大多数 MCP 服务器是由客户端启动的 Node.js 或 Python 程序，它们拿到的是客户端给的环境变量，所以代理变量就放在这里。

Node.js 默认不读代理变量，要主动开启：设置 NODE_USE_ENV_PROXY=1（Node v24.0.0 和 v22.21.0 及以上），或者用 --use-env-proxy 启动（v24.5.0 和 v22.21.0 及以上），它才会读 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY。只支持 HTTP 或 HTTPS 代理地址，不支持 SOCKS。Node 20 没有这个内置支持，跑在 Node 20 上的服务器读不到这些变量。

Python 简单一些：httpx 和 requests 默认就读代理环境变量；如果代理地址是 SOCKS，requests 还要装 requests[socks]。

客户端把这些变量放在服务器的 env 块里，和 API 密钥写在一起。下面是一个发普通网页请求的服务器的写法：

• 来源：
• Node.js docs: command-line options and built-in proxy support
• Requests documentation: Advanced usage, proxies
• HTTPX documentation: Environment variables

给 MCP 服务器加代理变量的 env 块

{
  "mcpServers": {
    "some-other-server": {
      "command": "npx",
      "args": ["-y", "your-mcp-server-package"],
      "env": {
        "NODE_USE_ENV_PROXY": "1",
        "HTTPS_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
        "HTTP_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
        "NO_PROXY": "localhost,127.0.0.1"
      }
    }
  }
}

仅为示例：把 HOST、PORT、USERNAME、PASSWORD 换成你自己的值，用 HTTP 代理地址。

• 来源：
• Node.js docs: command-line options and built-in proxy support

命令行里的写法

命令行里同样适用：

Node.js：命令行里开启

NODE_USE_ENV_PROXY=1 HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT node server.js

仅为示例：把占位符换成你自己的值。

• 来源：
• Node.js docs: command-line options and built-in proxy support

两段要分开测

助手自己的连接和服务器发出的请求是两段，要分开测。用查询服务看到的出口国家和运营商，和你要的地区对一下。

实测出口：Proxy302 动态住宅，8 个国家

这是 Proxy302 每小时一次的连通性检测，不是 proxy302-mcp 的测量：2026 年 11 月 3 日 18:18（UTC），每个国家通过动态住宅出口向 Amazon 发一次请求。每个国家只有一个样本，不是平均值，之后的检测结果会不同。IP 只公开前三段。

• 来源：
• Proxy302 hourly connectivity check

什么样的调用配什么类型的代理

动态住宅适合从很多地方读公开网页，比如价格页、搜索结果、各国显示不同的文档。流量按 GB 买，每次生成的代理从这笔流量里扣；生成时选国家。

静态 ISP IP 适合跟某个账号绑定的事：租 1 到 90 天，租期内 IP 不变。机房 IP 适合只调接口、不在意网络类型的流量。

代理只改变服务看到的网络地址。账号能做什么、会不会被限制，由平台自己决定。

• 来源：
• Proxy302 product facts and price list

用 Proxy302 怎么做

做代理 MCP 的事，动态住宅最常用：服务器按国家取代理地址，用到的流量从钱包扣。产品页写明了线路和国家。

• 动态住宅页面

用 Proxy302 怎么做：步骤

1. 第 1 步

   在 Proxy302 控制台创建 API 密钥（页面是 /api-keys）。密钥由两部分组成：key id 和 secret，写成 <key id>:<secret>。

2. 第 2 步

   按上面的小节，运行你所用工具的安装命令，密钥放进环境变量。

3. 第 3 步

   如果工具提示需要重启就重启，然后让助手列出这个服务器的工具，并取一个你要的国家的代理地址。

4. 第 4 步

   通过代理访问 https://ipinfo.io/json，核对返回结果中的 country 字段是否与你选择的国家一致。其他检测网站见“代理 IP 怎么查”。

   • 代理 IP 怎么查

5. 第 5 步

   在中国大陆，先在「连接工具」页打开辅助工具，点「一键加速」，使用代理期间保持开着。

   • 辅助工具指南

价格与限制

proxy302-mcp 免费。动态住宅流量经济线每 GB 1.5 美元起，优质线每 GB 5 美元，买大流量包单价更低。静态 ISP IP 一天 0.5 美元、30 天 7.99 美元，各国同价；库存每天变化，以下单页面为准。没有免费试用，最小购买量是 1 GB 动态住宅流量或 1 个 IP 用 1 天。代理不能解除限制、撤销封号或提高限额。

• 来源：
• Proxy302 product facts and price list

Proxy302 一览

价格按 PTC 从钱包扣，1 PTC = 1 美元。没有免费试用：最小一单是 1 GB 动态住宅流量，或一个 IP 用 1 天。核对于 2026-11-04。

• 来源：
• Proxy302 product facts and price list
• Proxy302 ISP for AI subscriptions: public catalog

常见问题

延伸阅读

Claude Code 怎么设置代理

Claude Code 在 HTTP 代理后的设置：HTTPS_PROXY、NO_PROXY、后台代理用的 settings.json，以及确认生效的检查。

Codex CLI 怎么走代理

讲怎么用环境变量让 OpenAI Codex CLI 走 HTTP 代理、让配置长期生效，以及常见错误怎么排查。

Browser Use 代理设置：让浏览器 Agent 走 HTTP 代理

讲怎么让 Browser Use 的浏览器 Agent 走 HTTP 代理：当前的 ProxySettings 写法、一个 Agent 一个代理、Playwright 和 Playwright MCP 的选项、时区与语言，以及常见报错。

动态住宅 IP 代理

覆盖 195+ 国家和地区的真实家庭 IP，可定位到州/省和城市。每次请求轮换，或保持同一个 IP 的连接。US$1.50/GB 起，100 GB 档 US$1.35/GB。支持 HTTP / SOCKS5。

查看配置与价格