API
MCP-сервер
MCP-сервер Proxya позволяет ИИ-клиентам, таким как Claude Code, Cursor и VS Code, работать с аккаунтом через инструменты. Сервер использует тот же API-ключ и не имеет полномочий сверх прав ключа.
Обновлено 22 ноября 2026
Адрес#
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
Возвращает цену и
quote_id, действующий 15 минут. Покупка не выполняется.Клиент показывает цену
confirm_purchaseотмечен как действие, изменяющее данные, и MCP-клиенты запрашивают подтверждение пользователя перед его запуском.confirm_purchase
Покупает то, что указано в расчёте, и списывает баланс.
quote_idслужит Idempotency-Key: повторный вызов с ним возвращает тот же заказ.
Ограничения и безопасность#
- Каждый инструмент вызывает обычный API с тем же ключом и тем же адресом. Права, дневной лимит, список IP, ограничения частоты и журнал ключа действуют так же, как для API.
- Расчёт можно подтвердить только тем ключом, которым он создан.
- Запросы со страниц других сайтов отклоняются.
Не нашли ответ?
Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.