API
MCP 服务器
Proxya MCP 服务器让 Claude Code、Cursor、VS Code 等 AI 客户端通过工具操作账户。它使用同一个 API 密钥,权限不会超出密钥本身。
更新于 2026年11月22日
地址#
https://proxya.co/api/mcp服务器使用 Streamable HTTP 传输,支持协议版本 2025-03-26、2025-06-18 和 2025-11-25。API 密钥放在 Authorization: Bearer 请求头中。只能通过 OAuth 登录连接远程服务器的客户端无法连接。
连接客户端#
以下示例中,密钥从环境变量 PROXYA_API_KEY 读取,或在服务器启动时询问,不会写入配置文件。
claude mcp add --transport http proxya https://proxya.co/api/mcp \
--header "Authorization: Bearer $PROXYA_API_KEY"Cursor 读取 ~/.cursor/mcp.json 或项目中的 .cursor/mcp.json。VS Code 读取工作区中的 .vscode/mcp.json。
检查连接#
服务器对 tools/list 返回该密钥可用的工具。
curl -X POST https://proxya.co/api/mcp \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'工具#
客户端只能看到密钥权限允许的工具。
| 工具 | 权限 | 作用 |
|---|---|---|
| get_account | read | 邮箱、余额和密钥权限 |
| list_orders | read | 订单列表 |
| get_order | read, credentials | 订单与代理 |
| get_prices | read | 价格表 |
| check_stock | read | 各地区库存 |
| list_mobile_locations | read | 移动代理地区 |
| list_transactions | read | 余额记录 |
| residential_balance | read | 住宅流量余额 |
| get_whitelist | read | 订单 IP 白名单 |
| generate_residential_proxies | credentials | 住宅代理连接串 |
| add_whitelist_ip | credentials | 向白名单添加 IP |
| quote_order | purchase | 新订单报价与 quote_id |
| quote_renewal | purchase | 续费报价与 quote_id |
| confirm_purchase | purchase | 按报价完成购买 |
| change_proxy_password | manage | 更换代理密码 |
| remove_whitelist_ip | manage, credentials | 从白名单移除 IP |
| rotate_mobile_ip | manage | 立即更换移动 IP |
购买#
quote_order 或 quote_renewal
返回价格和 15 分钟内有效的
quote_id,不会下单。客户端显示价格
confirm_purchase被标记为会修改数据的操作,MCP 客户端在执行前会请用户确认。confirm_purchase
按报价购买并从余额扣款。
quote_id即 Idempotency-Key:用它再次调用会返回同一订单。
限制与安全#
- 每个工具都以相同的密钥和地址调用普通 API。权限、每日限额、IP 列表、频率限制和密钥日志与 API 完全一致。
- 报价只能由创建它的密钥确认。
- 来自其他网站页面的请求会被拒绝。
没有找到答案?
网站在线客服 24 小时回复。通过 Telegram 联系通常最快,提交工单会通过邮件回复。