API

MCP 服务器

Proxya MCP 服务器让 Claude Code、Cursor、VS Code 等 AI 客户端通过工具操作账户。它使用同一个 API 密钥,权限不会超出密钥本身。

更新于 2026年11月22日

地址#

Text
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 返回该密钥可用的工具。

Shell
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_accountread邮箱、余额和密钥权限
list_ordersread订单列表
get_orderread, credentials订单与代理
get_pricesread价格表
check_stockread各地区库存
list_mobile_locationsread移动代理地区
list_transactionsread余额记录
residential_balanceread住宅流量余额
get_whitelistread订单 IP 白名单
generate_residential_proxiescredentials住宅代理连接串
add_whitelist_ipcredentials向白名单添加 IP
quote_orderpurchase新订单报价与 quote_id
quote_renewalpurchase续费报价与 quote_id
confirm_purchasepurchase按报价完成购买
change_proxy_passwordmanage更换代理密码
remove_whitelist_ipmanage, credentials从白名单移除 IP
rotate_mobile_ipmanage立即更换移动 IP

购买#

  1. quote_order 或 quote_renewal

    返回价格和 15 分钟内有效的 quote_id,不会下单。

  2. 客户端显示价格

    confirm_purchase 被标记为会修改数据的操作,MCP 客户端在执行前会请用户确认。

  3. confirm_purchase

    按报价购买并从余额扣款。quote_id 即 Idempotency-Key:用它再次调用会返回同一订单。

限制与安全#

  • 每个工具都以相同的密钥和地址调用普通 API。权限、每日限额、IP 列表、频率限制和密钥日志与 API 完全一致。
  • 报价只能由创建它的密钥确认。
  • 来自其他网站页面的请求会被拒绝。

没有找到答案?

网站在线客服 24 小时回复。通过 Telegram 联系通常最快,提交工单会通过邮件回复。