AI 原生代理：给 Claude Code、Codex、Cursor 用的 MCP 和代理

在你的 AI 客户端里安装

两种接法：直接连远程地址（什么都不用装），或者在自己电脑上运行 proxy302-mcp。两种都要一个 Proxy302 API 密钥。

在控制台的 API 密钥页创建密钥，按 <key id>:<secret> 的格式填进下面的命令或配置。 API 密钥
密钥只放在命令里的环境变量中，不要贴进对话，也不要提交到代码仓库。
客户端直接连 https://proxy302.com/v1/mcp。传输方式是 Streamable HTTP，API 密钥放在 Authorization 请求头里，写成 Bearer <key id>:<secret>。不用装 Node.js。
https://proxy302.com/v1/mcp
在终端运行。
```
claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"
```
加到 ~/.codex/config.toml，再在启动 Codex 的终端里设置 PROXY302_API_KEY。
```
# ~/.codex/config.toml
[mcp_servers.proxy302]
url = "https://proxy302.com/v1/mcp"
bearer_token_env_var = "PROXY302_API_KEY"

# then, in the shell that starts codex:
export PROXY302_API_KEY="<key id>:<secret>"
```
加到 ~/.gemini/settings.json。
```
{
  "mcpServers": {
    "proxy302": {
      "httpUrl": "https://proxy302.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <key id>:<secret>"
      }
    }
  }
}
```
加到 ~/.cursor/mcp.json。
```
{
  "mcpServers": {
    "proxy302": {
      "url": "https://proxy302.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <key id>:<secret>"
      }
    }
  }
}
```
一键加到 Cursor会打开 Cursor 并填好远程地址。之后把 ~/.cursor/mcp.json 里的 <key id>:<secret> 换成你的密钥。
加到 .vscode/mcp.json，第一次启动时 VS Code 会让你填密钥。
```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "proxy302-key",
      "description": "Proxy302 API key (<key id>:<secret>)",
      "password": true
    }
  ],
  "servers": {
    "proxy302": {
      "type": "http",
      "url": "https://proxy302.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:proxy302-key}"
      }
    }
  }
}
```
在 Claude（网页版和 Claude Desktop）和 ChatGPT 里，把 https://mcp.proxy302.com/mcp 加成自定义连接器：Claude 在 Settings → Connectors → Add custom connector，ChatGPT 在开发者模式里添加连接器。Proxy302 授权页会让你粘贴「密钥 ID:密钥」；在控制台删掉密钥，连接就断了。
https://mcp.proxy302.com/mcp
在 Cline 面板点 MCP Servers > Configure > Configure MCP Servers。
```
{
  "mcpServers": {
    "proxy302": {
      "type": "streamableHttp",
      "url": "https://proxy302.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <key id>:<secret>"
      }
    }
  }
}
```
9 个工具
- 账户余额和用量
- 国家和地区列表
- 商品和价格
- 拿一个指定国家的动态住宅代理
- 列出你的代理，静态 IP 带出口地址
- 换 IP
- 查 IP 纯净度，和购买页同一套打分
- 估算花费，并和钱包余额对比
这些工具都不花钱，买东西还是在控制台。
proxy302-mcp 在你自己的电脑上运行，AI 客户端需要时会自动启动它。需要 Node.js 20 或更高版本，和一个 Proxy302 API 密钥。
在终端运行。加了 -s user，所有项目都能用。
```
claude mcp add proxy302 -s user -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp
```
在终端运行，Codex 会把它写进 ~/.codex/config.toml。
```
codex mcp add proxy302 --env PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp
```
加到 ~/.gemini/settings.json，或者项目里的 .gemini/settings.json。
文件： ~/.gemini/settings.json
```
{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}
```
加到 ~/.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>"
      }
    }
  }
}
```
一键加到 Cursor会打开 Cursor 并填好配置。之后把 ~/.cursor/mcp.json 里的 <key id>:<secret> 换成你的密钥。
加到 .vscode/mcp.json；想所有项目都能用，就用命令「MCP: Open User Configuration」打开用户配置再加。服务器第一次启动时，VS Code 会弹框让你填密钥。
文件： .vscode/mcp.json
```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "proxy302-key",
      "description": "Proxy302 API key (<key id>:<secret>)",
      "password": true
    }
  ],
  "servers": {
    "proxy302": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "${input:proxy302-key}"
      }
    }
  }
}
```
打开 Settings > Developer > Edit Config，加上这段，然后完全退出 Claude Desktop 再重新打开。
文件： claude_desktop_config.json
```
{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}
```
在 Cline 面板点 MCP Servers 图标，打开 Configure，点 Configure MCP Servers，把这段加进去。
文件： cline_mcp_settings.json
```
{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
装上后多了什么
get_account_usage
钱包余额、剩余流量和每天用量
list_countries
能选的国家和国家代码
list_regions
某个国家的州，或者某个州的城市
list_products
产品线和静态 IP 套餐
get_dynamic_proxy
拿到某个国家现成的动态住宅代理地址 http://user:pass@host:port
list_my_proxies
你的动态代理和静态 IP，密码默认打码
fetch_url
通过你的代理打开网页（可以指定国家），返回 Markdown 或纯文本，不执行 JavaScript
它不能买东西，也不能花钱包里的钱。唯一会写入的操作是创建动态代理凭据：免费、默认关闭，用了才按流量计费。
装好后，可以这样问助手
- 我还剩多少代理流量？这周用了多少？
- 我能用哪些国家？给我一个德国的代理。
- 30 天的静态 ISP IP 多少钱？有哪些套餐？

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

在中国大陆用代理？先在辅助工具里打开「一键加速」。辅助工具教程

已付费账号第一次通过 MCP 成功调用，送 1 PTC，每个账号一次，送完即止。

来源：
Claude Code 文档：MCP
Codex 文档：MCP
Gemini CLI 文档：MCP 服务器
Cursor 文档：MCP
VS Code 文档：MCP 服务器
Cline 文档：配置 MCP 服务器
proxy302-mcp 源码

Proxy302 一览（Agent 场景）

可使用方向键横向滚动，阅读完整内容。

Proxy302 一览（Agent 场景）
项目	价格	协议	地区	适合的 Agent 工作
动态住宅	经济线每 GB 1.5 美元起，优质线每 GB 5 美元；买大流量包单价更低	HTTP、SOCKS5	195 个以上国家和地区，支持的线路可选州和主要城市	浏览、调研类 Agent，数据采集
静态 ISP（按 IP）	1 天 0.5 美元，30 天 7.99 美元，各国同价	HTTP 或 SOCKS5，每个 IP 购买时选定	下单页列出 30 个国家，库存每天变化	要登录账号的 Agent：一个账号配一个固定 IP
AI 订阅专用 ISP	每 30 天：Claude 15 PTC，GPT / Grok 10 PTC，Gemini 8 PTC；每档首单 5 折	HTTP 或 SOCKS5	Claude：美国、英国、德国、日本；GPT / Grok：美国、英国、法国、日本、韩国；Gemini：美国、英国、法国、日本	登录 ChatGPT、Claude、Gemini、Grok 账号的编程工具和 Agent
机房 IP（按 IP）	1 天 0.25 美元，30 天 3.99 美元	HTTP 或 SOCKS5，每个 IP 购买时选定	8 个国家	只调接口、不在意 IP 类型的流量
proxy302-mcp	免费、开源（MIT 协议）	MCP，本地 stdio，用 npx 启动	用的是上面这些产品	让 Claude Code、Codex、Cursor 等 MCP 客户端拿代理、通过代理打开网页

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

会开浏览器的 Agent

Browser Use、Playwright MCP 这类浏览器 Agent，填一个带用户名和密码的代理地址就能用，这时要用 HTTP 接入。每个 Agent 配一个自己的动态住宅代理，先打开 IP 查询页确认出口国家，多步骤的任务保持在同一个 IP 上。

数据采集

让助手用 fetch_url 从别的国家打开公开网页，或者把给检索库喂数据的爬虫接到动态住宅代理上。遵守各网站的条款和 robots.txt，请求频率别太高。

AI 订阅

Claude Code、Codex、Gemini CLI 用的是你自己的订阅账号。一个账号配一个固定的 ISP IP，选服务商支持的国家。代理只改变服务看到的网络地址，服务商的条款和支持国家名单照样适用。

常见问题

什么是 AI 原生代理？

AI 工具自己就能用的代理：一种是通过 MCP，在助手里直接调用代理工具，比如拿一个指定国家的代理、通过代理打开网页；另一种是把代理地址交给 Agent 的浏览器或命令行工具，让它的流量从代理走。

Proxy302 有 MCP 服务器吗？

有两种。远程地址 https://proxy302.com/v1/mcp 不用安装，在客户端里加上地址，把 API 密钥放进 Authorization 请求头就行，共 9 个工具，都不花钱。proxy302-mcp 是在你自己电脑上运行的开源版，有 7 个工具。两种都是 Proxy302 官方的，由 Proxy302 团队维护。

MCP 服务器会花我的余额吗？

不会。它不能买东西，也不能花钱包里的钱。唯一会写入的操作是创建动态代理凭据，免费、默认关闭，用了才按流量计费。

我的 Agent 该用哪种代理？

要从很多国家读公开网页，用动态住宅；Agent 要登录的每个账号，各配一个固定的静态 ISP IP；只调接口的，用机房 IP 或者不用代理。价格和协议见上面的表。

AI 编程工具能用 SOCKS5 吗？

请用 HTTP 接入。Anthropic 的 Claude Code 文档写明 Claude Code 不支持 SOCKS 代理；Playwright 也只有 HTTP 代理才能填用户名和密码，所以浏览器 Agent 同样要用 HTTP 接入。