API

MCP-сервер

MCP-сервер Proxya позволяет ИИ-клиентам, таким как Claude Code, Cursor и VS Code, работать с аккаунтом через инструменты. Сервер использует тот же API-ключ и не имеет полномочий сверх прав ключа.

Обновлено 22 ноября 2026

Адрес#

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

    Возвращает цену и quote_id, действующий 15 минут. Покупка не выполняется.

  2. Клиент показывает цену

    confirm_purchase отмечен как действие, изменяющее данные, и MCP-клиенты запрашивают подтверждение пользователя перед его запуском.

  3. confirm_purchase

    Покупает то, что указано в расчёте, и списывает баланс. quote_id служит Idempotency-Key: повторный вызов с ним возвращает тот же заказ.

Ограничения и безопасность#

  • Каждый инструмент вызывает обычный API с тем же ключом и тем же адресом. Права, дневной лимит, список IP, ограничения частоты и журнал ключа действуют так же, как для API.
  • Расчёт можно подтвердить только тем ключом, которым он создан.
  • Запросы со страниц других сайтов отклоняются.

Не нашли ответ?

Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.