# MCP-сервер для ИИ-агентов | ProxyJam Подключите Claude, Cursor и другие MCP-клиенты к аккаунту ProxyJam: поиск, заказ и продление прокси, трафик. Покупки — только после вашего «да». - Canonical: https://proxyjam.com/ru/mcp/ - Updated: 2026-10-14 - Language: ru MCP-сервер ProxyJam даёт Claude, Cursor и другим ИИ-клиентам 16 инструментов для работы с вашим аккаунтом: поиск предложений, заказ и продление прокси, проверка трафика и баланса. Вы входите в аккаунт и сами решаете, что агенту можно, а всё, что стоит денег, сначала показывает предварительный расчёт и ждёт вашего «да». Нужен аккаунт ProxyJam. Большинство клиентов входят через него, остальным нужен API-ключ. Сам сервер бесплатный: вы платите только за прокси, которые закажет агент. У ProxyJam есть удалённый MCP-сервер по адресу `https://proxyjam.com/mcp` (транспорт Streamable HTTP). Ваш ИИ-клиент входит через аккаунт ProxyJam (OAuth) или передаёт API-ключ — и получает 16 инструментов: девять читают данные, четыре меняют настройки и три тратят деньги — причём эти три только показывают предварительный расчёт, пока вы не подтвердите покупку. ## Шестнадцать инструментов, шесть задач ### Смотреть каталог list_offers ищет актуальные предложения по типу, стране, региону и городу и возвращает все тарифы с ценами. Идентификаторы предложений выдаёт только он, поэтому любая покупка начинается с него. ### Заказывать прокси create_proxy_order покупает от 1 до 50 прокси по одному предложению. Первый вызов только показывает цену и ваш баланс, а заказ оформляется, когда вы его подтвердите. ### Продлевать и докупать трафик extend_proxy_period продлевает прокси ещё на один период, а buy_proxy_bandwidth добавляет трафик статическому прокси. Оба сначала показывают расчёт и списывают деньги только после вашего подтверждения. ### Проверять заказы и трафик Ваши заказы с данными для подключения и израсходованный трафик — по каждому прокси или по всем сразу. Это только чтение, так что агент может обращаться сюда сколько угодно. ### Следить за деньгами Балансы кошелька в каждой валюте и полная история транзакций — по одной или постранично. Тоже только чтение. ### Менять настройки Переключить прокси между HTTP и SOCKS5, заменить его белый список IP, включить или выключить автопродление, обновить состояние. Всё это бесплатно, но клиенту, вошедшему через аккаунт, для таких действий нужно разрешение на списания. ## Деньги списываются только с вашего согласия 1. **По умолчанию — только чтение.** Когда клиент входит через аккаунт, ProxyJam показывает, какой доступ он запрашивает. Чтение заказов, кошелька и каталога выдаётся одним блоком — а в заказах есть логины и пароли ваших прокси. Списания — отдельная галочка *Разрешить списания с моего кошелька*, изначально снятая; она же открывает и бесплатные изменения настроек. 2. **Сначала расчёт.** `create_proxy_order`, `extend_proxy_period` и `buy_proxy_bandwidth` начинают с `confirm=false`: возвращают предложение, цену и ваш баланс и ничего не списывают. 3. **Сначала ваше «да», потом списание.** Агент повторяет вызов с `confirm=true` только после того, как вы одобрите расчёт. Правила для агента в промптах ниже говорят об этом прямым текстом. 4. **Без двойных списаний.** Подтверждающий вызов передаёт тот же `idempotency_key`, что и расчёт, поэтому повторённый запрос вернёт первый результат, а не купит второй раз. Для новой покупки — новый ключ. 5. **API-ключ открывает весь аккаунт.** У ключей из панели управления нет более узких прав: им доступно всё, и чтение, и списания. Где клиент умеет входить через аккаунт, входите так, а любому ключу, которым всё же пользуетесь, задайте срок действия. 6. **Доступ заканчивается, когда вы его отзываете.** Клиент, вошедший через аккаунт, появляется в разделе *Подключённые приложения* в [настройках панели управления](https://app.proxyjam.com/settings); отзовите доступ там, и он прекратится в течение пяти минут. Смена пароля или выход на всех устройствах отзывает все подключения разом. Ключ перестаёт работать, как только вы удалите его на [странице «API-ключи»](https://app.proxyjam.com/apikey). ## Подключение в три шага 1. **Добавьте сервер в клиент** Выберите свой клиент выше и скопируйте его конфигурацию. Адрес сервера — `https://proxyjam.com/mcp`. 2. **Войдите и решите, что ему можно** Клиент откроет ProxyJam в браузере. Войдите, прочитайте, какой доступ он запрашивает, и ставьте галочку *Разрешить списания с моего кошелька*, только если агент должен заказывать, продлевать или менять настройки. Каждое новое одобрение заменяет предыдущее, так что позже можно переподключиться и передумать. Клиенту, который не умеет входить через аккаунт, вместо этого нужен [API-ключ](https://app.proxyjam.com/apikey): он начинается с `pj_` и показывается только один раз. 3. **Начните с запроса только на чтение** Сначала попросите показать предложения — это тот же актуальный каталог, что и на странице [статических резидентных (ISP) прокси](/ru/isp-proxies/). Так вы убедитесь, что подключение работает, а агент получит идентификаторы предложений, без которых не обойдётся всё остальное. Потом попробуйте промпты ниже. ## Выберите клиент Нажмите на клиент, чтобы увидеть, как его подключить. Большинство клиентов входят через ваш аккаунт ProxyJam; VS Code и OpenAI Agents SDK работают с API-ключом — замените pj_... на свой. ### Claude (Anthropic) У claude.ai, Claude Desktop и мобильных приложений общий список коннекторов. 1. В Claude откройте настройки коннекторов и добавьте собственный коннектор. 2. Назовите его ProxyJam и вставьте https://proxyjam.com/mcp как адрес сервера. 3. Подключитесь, войдите в ProxyJam и одобрите доступ. Полное руководство в документации: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) Выполните команду в терминале, затем наберите /mcp в Claude Code, выберите proxyjam и войдите. Добавьте --scope user, чтобы сервер был доступен во всех проектах. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json или .cursor/mcp.json в проекте. При первом подключении Cursor попросит вас войти. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT сам представляется серверу и открывает вход в ProxyJam. 1. В настройках ChatGPT включите режим разработчика и создайте собственный коннектор. 2. Укажите https://proxyjam.com/mcp в качестве его URL и выберите OAuth. 3. Войдите в ProxyJam и одобрите доступ. Полное руководство в документации: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Выполните обе в терминале; вторая откроет браузер для входа. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, с API-ключом. VS Code запросит ключ один раз и надёжно его сохранит. ``` { "inputs": [ { "type": "promptString", "id": "proxyjam-api-key", "description": "ProxyJam API key", "password": true } ], "servers": { "proxyjam": { "type": "http", "url": "https://proxyjam.com/mcp", "headers": { "X-API-Key": "${input:proxyjam-api-key}" } } } } ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Выполните команду в терминале, затем наберите /mcp auth proxyjam в Gemini CLI, чтобы войти. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, с API-ключом. pip install openai-agents. ``` import asyncio from agents import Agent, Runner from agents.mcp import MCPServerStreamableHttp async def main(): async with MCPServerStreamableHttp( name="ProxyJam", params={ "url": "https://proxyjam.com/mcp", "headers": {"X-API-Key": "pj_..."}, }, ) as proxyjam: agent = Agent( name="Assistant", instructions="Use the ProxyJam tools. Never confirm " "a purchase without the user's yes.", mcp_servers=[proxyjam], ) result = await Runner.run( agent, "List ISP proxy offers in the United States.") print(result.final_output) asyncio.run(main()) ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Выполняет вход через браузер и выводит список инструментов. ``` import asyncio from fastmcp import Client async def main(): # auth="oauth" opens your browser to sign in to ProxyJam. async with Client("https://proxyjam.com/mcp", auth="oauth") as client: for tool in await client.list_tools(): print(tool.name) asyncio.run(main()) ``` Полное руководство в документации: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## Попробуйте эти промпты Когда сервер подключён, вставьте любой из них в чат агента. Замените ORDER_ID номером заказа из панели управления. Последняя вкладка — набор правил, который стоит держать в инструкциях агента. ### Найти прокси Только чтение. Безопасный первый запрос. Через MCP-сервер ProxyJam покажи предложения статических резидентных (ISP) прокси в США с ценами за месяц. Ничего не заказывай. ### Покупка с подтверждением Списание только после вашего «да». Закажи в ProxyJam один статический резидентный (ISP) прокси в США на один месяц. Сначала покажи мне предварительный расчёт — предложение, цену и баланс моего кошелька — и дождись моего явного «да», прежде чем подтверждать. При подтверждении используй тот же ключ идемпотентности. ### Продление Продлить заказ, сначала — расчёт. Продли мой заказ ProxyJam ORDER_ID на один месяц. Покажи предварительный расчёт с ценой и моим балансом и дождись моего «да», прежде чем подтверждать. ### Расход и баланс Заказы, трафик и деньги в одном ответе. Покажи мои активные прокси ProxyJam с датами окончания и трафиком, который израсходовал каждый из них, затем баланс моего кошелька в USD и последние 10 транзакций. ### Настройки Изменения, которые ничего не стоят. Для моего заказа ProxyJam ORDER_ID: переключи протокол на SOCKS5, задай белый список IP 203.0.113.7 и включи автопродление. Потом сообщи мне новые настройки. ### Правила для агента Для CLAUDE.md, AGENTS.md или правил Cursor. Когда работаешь с MCP-сервером ProxyJam: - Сначала вызывай list_offers. Это единственный источник идентификаторов предложений. - create_proxy_order, extend_proxy_period и buy_proxy_bandwidth лишь показывают предварительный расчёт, пока не передан confirm=true. Показывай мне расчёт и никогда не подтверждай без моего явного «да». - Подтверждай с тем же idempotency_key, что и в расчёте. Для каждой новой покупки бери новый ключ. - Если в расчёте баланс меньше цены, остановись и сообщи мне, а не подтверждай. - Если инструмент отказывает, потому что списания не разрешены, сообщи мне, а не пробуй снова; переподключаться ли с разрешением на списания, решаю я. - Обращайся с моим API-ключом как с секретом: никогда не выводи его, не пиши в логи и не сохраняй в файлы, которыми я могу с кем-то поделиться. ## Все 16 инструментов | Инструмент | Что делает | Тип | |---|---|---| | list_offers | Ищет в каталоге по типу, стране, региону и городу; возвращает идентификаторы предложений и тарифы | Чтение | | list_my_orders | Список ваших заказов прокси, постранично | Чтение | | get_order | Один заказ целиком, включая данные для подключения к прокси | Чтение | | get_my_traffic_summary | Трафик, израсходованный всеми вашими активными прокси | Чтение | | get_order_traffic | Трафик, израсходованный одним заказом | Чтение | | list_my_wallets | Ваши кошельки, по одному на валюту | Чтение | | get_wallet_balance | Баланс одного кошелька | Чтение | | list_wallet_transactions | История транзакций кошелька, постранично | Чтение | | get_transaction | Одна транзакция | Чтение | | create_proxy_order | Покупает от 1 до 50 прокси по одному предложению | Списание, сначала расчёт | | extend_proxy_period | Продлевает активный прокси ещё на один период | Списание, сначала расчёт | | buy_proxy_bandwidth | Добавляет статическому прокси от 1 до 5 000 ГБ трафика | Списание, сначала расчёт | | set_auto_renew | Включает или выключает автопродление | Настройки, бесплатно | | set_proxy_whitelist | Заменяет список IP, которым разрешено пользоваться прокси | Настройки, бесплатно | | change_proxy_protocol | Переключает протокол между HTTP и SOCKS5 | Настройки, бесплатно | | sync_proxy_state | Заново считывает текущее состояние прокси | Настройки, бесплатно | Инструменты, которые сервер отдаёт сегодня. Три платных инструмента возвращают предварительный расчёт, пока их не вызовут повторно с confirm=true. Клиент, вошедший через аккаунт, может вызывать последние семь, только если вы разрешили списания. ## Параметры подключения - **Адрес:** https://proxyjam.com/mcp - **Транспорт:** Streamable HTTP - **Аутентификация:** Вход через аккаунт ProxyJam (OAuth 2.1) или API-ключ в заголовке X-API-Key - **Доступ:** По умолчанию только чтение; списания и изменение настроек — только с вашего разрешения - **Справочники:** Статусы заказов, валюты, протоколы прокси, типы предложений и способы оплаты — в виде MCP-ресурсов - **Цена:** Бесплатно. Вы платите только за заказанные прокси ## Вопросы о MCP-сервере ### Какие ИИ-клиенты можно подключить? Любой MCP-клиент, который подключается к удалённому серверу по Streamable HTTP и либо умеет входить через OAuth, либо позволяет добавить заголовок запроса. Конфигурации выше охватывают Claude (claude.ai, Claude Desktop и мобильные приложения), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, OpenAI Agents SDK и FastMCP. ### Можно ли подключить его к claude.ai или ChatGPT? Да. В Claude добавьте собственный коннектор с адресом https://proxyjam.com/mcp и войдите в ProxyJam; коннектор появится также в Claude Desktop и мобильных приложениях. В ChatGPT для собственных MCP-коннекторов нужен режим разработчика, который OpenAI предлагает в бета-версии на некоторых тарифах; добавьте тот же адрес и выберите OAuth. ### MCP-сервер платный? Нет. Подключение и вызовы инструментов бесплатны. Вы платите только за то, что закажет агент, — по тем же ценам, что и в панели управления, с вашего кошелька ProxyJam. ### Может ли агент потратить деньги, не спросив меня? Случайно — нет. Клиент, вошедший через аккаунт, вообще не может тратить деньги, если при одобрении вы не поставили галочку *Разрешить списания с моего кошелька*. Но и тогда три платных инструмента — заказ, продление и покупка трафика — на первый вызов возвращают предварительный расчёт и списывают деньги только при повторном вызове с confirm=true; аккуратный агент покажет вам этот расчёт и дождётся ответа, и правила для агента выше требуют от него именно этого. У API-ключа нет лимита на траты, поэтому давайте агенту такой ключ, который сможете удалить. ### Чего агент не может сделать через MCP? Пополнить кошелёк, управлять API-ключами, менять настройки аккаунта, проверять IP-адреса и пользоваться действиями для мобильных прокси, например сменой IP. Всё это остаётся в панели управления и REST API. ### Нужен ли API-ключ? Нет, если ваш клиент умеет входить через аккаунт. Запрос без входа и без ключа отклоняется с указанием, где войти в ProxyJam, — именно так claude.ai, Claude Code, Cursor и другие клиенты сами запускают вход. Клиенты, которые входить не умеют, вместо этого передают API-ключ. ### Как разрешить списания позже или отозвать разрешение? Подключитесь заново и одобрите доступ с галочкой или без неё: каждое одобрение заменяет предыдущее. В Claude Code, например, это /mcp и повторный вход в proxyjam. ### Как отозвать доступ агента? Если клиент входил через аккаунт, отзовите доступ в разделе «Подключённые приложения» в настройках панели управления: он прекратится в течение пяти минут, а остальные подключения продолжат работать. Смена пароля или выход на всех устройствах отзывает их все разом. API-ключ удалите на странице «API-ключи»; ключ, созданный со сроком действия, к тому же перестанет работать сам. ### Может ли агент зарегистрироваться сам? Да, с ограничениями. Агент, за которым нет аккаунта, может зарегистрироваться и получить ключ, который читает только публичный каталог. Если вы привяжете этот ключ к себе кодом, который ProxyJam пришлёт вам на почту, ключ перейдёт в ваш аккаунт и сможет читать ваши заказы и кошелёк, но тратить деньги не сможет никогда. Инструкция для агентов — в auth.md. ## Начните с малого Подключитесь, попросите показать предложения и посмотрите, что пришло в ответ, прежде чем разрешать агенту что-либо заказывать. Когда дойдёт до покупки, расчёт покажет предложение, цену и ваш баланс, и ничего не спишется, пока вы не скажете «да». ## Источники - [Model Context Protocol — транспорты](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — транспорт Streamable HTTP, на котором работает этот сервер - [Карточка MCP-сервера](/.well-known/mcp/server-card.json) — адрес, транспорт и аутентификация для агентов, которые находят ProxyJam сами - [auth.md](/auth.md) — как агент входит, регистрируется или пользуется API-ключом - [Метаданные сервера авторизации OAuth](/.well-known/oauth-authorization-server) — эндпоинты и области доступа (scopes), которые клиент узнаёт при входе - [Навык агента ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — руководство по работе, которое агент может загрузить перед первым вызовом MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) — открытый стандарт, через который ИИ-ассистенты вызывают внешние инструменты. Подключите MCP-клиент к серверу ProxyJam, и агент сможет делать в вашем аккаунте большую часть того, что API-ключ позволяет в REST API. Прежде чем начать, полезно знать две вещи. **Вы решаете, что ему можно.** Клиент, который входит через аккаунт, сначала просит вашего одобрения. Чтение выдаётся одним блоком, и в него входят логины и пароли ваших прокси; списания с кошелька — а вместе с ними и бесплатные изменения настроек — это отдельная галочка, которую стоит ставить, только если вы хотите, чтобы агент действовал сам. С API-ключом всё иначе: он открывает весь аккаунт, поэтому, если клиент умеет входить через аккаунт, лучше входить так. **Деньги — только после расчёта.** Три платных инструмента никогда не списывают деньги на первом вызове. Они возвращают предварительный расчёт с пометкой `dry_run` и списывают деньги только при повторном вызове с `confirm=true`, а аккуратный агент делает такой вызов только после вашего «да».