Подключите ИИ-агента к ProxyJam

MCP-сервер ProxyJam даёт Claude, Cursor и другим ИИ-клиентам 16 инструментов для работы с вашим аккаунтом: поиск предложений, заказ и продление прокси, проверка трафика и баланса. Вы входите в аккаунт и сами решаете, что агенту можно, а всё, что стоит денег, сначала показывает предварительный расчёт и ждёт вашего «да».

Выбрать клиент

Нужен аккаунт ProxyJam. Большинство клиентов входят через него, остальным нужен API-ключ. Сам сервер бесплатный: вы платите только за прокси, которые закажет агент.

Выберите клиент

Нажмите на клиент, чтобы увидеть, как его подключить. Большинство клиентов входят через ваш аккаунт ProxyJam; VS Code и OpenAI Agents SDK работают с API-ключом — замените pj_... на свой.

Anthropic

Claude

claude.ai, Claude Desktop и мобильные приложения. Добавьте ProxyJam один раз как собственный коннектор, и он появится во всех трёх.

Показать настройкуСкрыть настройкуВход в аккаунт

Claude

1. В Claude откройте настройки коннекторов и добавьте собственный коннектор.
2. Назовите его ProxyJam и вставьте https://proxyjam.com/mcp как адрес сервера.
3. Подключитесь, войдите в ProxyJam и одобрите доступ.

У claude.ai, Claude Desktop и мобильных приложений общий список коннекторов.

Полное руководство в документации

Anthropic

Claude Code

Агент Anthropic для программирования в терминале. Сервер добавляется одной командой, а вход выполняется через /mcp.

Показать настройкуСкрыть настройкуВход в аккаунт

Claude Code

claude mcp add --transport http proxyjam https://proxyjam.com/mcp

Выполните команду в терминале, затем наберите /mcp в Claude Code, выберите proxyjam и войдите. Добавьте --scope user, чтобы сервер был доступен во всех проектах.

Полное руководство в документации

Anysphere

Cursor

Редактор кода со встроенным ИИ. Добавьте сервер в mcp.json, и при первом подключении Cursor попросит вас войти.

Показать настройкуСкрыть настройкуВход в аккаунт

Cursor

{
  "mcpServers": {
    "proxyjam": {
      "url": "https://proxyjam.com/mcp"
    }
  }
}

~/.cursor/mcp.json или .cursor/mcp.json в проекте. При первом подключении Cursor попросит вас войти.

Полное руководство в документации

OpenAI

ChatGPT

Для собственных коннекторов нужен режим разработчика, который OpenAI предлагает в бета-версии на некоторых тарифах.

Показать настройкуСкрыть настройкуВход в аккаунт

ChatGPT

1. В настройках ChatGPT включите режим разработчика и создайте собственный коннектор.
2. Укажите https://proxyjam.com/mcp в качестве его URL и выберите OAuth.
3. Войдите в ProxyJam и одобрите доступ.

ChatGPT сам представляется серверу и открывает вход в ProxyJam.

Полное руководство в документации

OpenAI

Codex CLI

Агент OpenAI для программирования в терминале. Две команды: первая добавляет сервер, вторая выполняет вход.

Показать настройкуСкрыть настройкуВход в аккаунт

Codex CLI

codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjam

Выполните обе в терминале; вторая откроет браузер для входа.

Полное руководство в документации

Microsoft

VS Code

Режим агента в Copilot Chat. Подключается по API-ключу: VS Code запросит его один раз и надёжно сохранит.

Показать настройкуСкрыть настройку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}" }
    }
  }
}

.vscode/mcp.json, с API-ключом. VS Code запросит ключ один раз и надёжно его сохранит.

Полное руководство в документации

Google

Gemini CLI

Агент Google для терминала. Добавьте сервер, затем войдите командой /mcp auth proxyjam.

Показать настройкуСкрыть настройкуВход в аккаунт

Gemini CLI

gemini mcp add --transport http proxyjam https://proxyjam.com/mcp

Выполните команду в терминале, затем наберите /mcp auth proxyjam в Gemini CLI, чтобы войти.

Полное руководство в документации

OpenAI

OpenAI Agents SDK

Python-фреймворк для создания собственных агентов. Подключается с API-ключом в заголовке запроса.

Показать настройкуСкрыть настройкуAPI-ключ

OpenAI Agents SDK

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())

Python, с API-ключом. pip install openai-agents.

Полное руководство в документации

Prefect

FastMCP

Python-библиотека для MCP-клиентов и серверов. Выполняет вход через браузер и выводит список инструментов.

Показать настройкуСкрыть настройкуВход в аккаунт

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())

Python. pip install fastmcp. Выполняет вход через браузер и выводит список инструментов.

Полное руководство в документации

Коротко: У ProxyJam есть удалённый MCP-сервер по адресу https://proxyjam.com/mcp (транспорт Streamable HTTP). Ваш ИИ-клиент входит через аккаунт ProxyJam (OAuth) или передаёт API-ключ — и получает 16 инструментов: девять читают данные, четыре меняют настройки и три тратят деньги — причём эти три только показывают предварительный расчёт, пока вы не подтвердите покупку.

MCP (Model Context Protocol) — открытый стандарт, через который ИИ-ассистенты вызывают внешние инструменты. Подключите MCP-клиент к серверу ProxyJam, и агент сможет делать в вашем аккаунте большую часть того, что API-ключ позволяет в REST API. Прежде чем начать, полезно знать две вещи.

Вы решаете, что ему можно. Клиент, который входит через аккаунт, сначала просит вашего одобрения. Чтение выдаётся одним блоком, и в него входят логины и пароли ваших прокси; списания с кошелька — а вместе с ними и бесплатные изменения настроек — это отдельная галочка, которую стоит ставить, только если вы хотите, чтобы агент действовал сам. С API-ключом всё иначе: он открывает весь аккаунт, поэтому, если клиент умеет входить через аккаунт, лучше входить так.

Деньги — только после расчёта. Три платных инструмента никогда не списывают деньги на первом вызове. Они возвращают предварительный расчёт с пометкой dry_run и списывают деньги только при повторном вызове с confirm=true, а аккуратный агент делает такой вызов только после вашего «да».

ЧТО УМЕЕТ ВАШ АГЕНТ

Шестнадцать инструментов, шесть задач

Смотреть каталог

list_offers ищет актуальные предложения по типу, стране, региону и городу и возвращает все тарифы с ценами. Идентификаторы предложений выдаёт только он, поэтому любая покупка начинается с него.

Заказывать прокси

create_proxy_order покупает от 1 до 50 прокси по одному предложению. Первый вызов только показывает цену и ваш баланс, а заказ оформляется, когда вы его подтвердите.

Продлевать и докупать трафик

extend_proxy_period продлевает прокси ещё на один период, а buy_proxy_bandwidth добавляет трафик статическому прокси. Оба сначала показывают расчёт и списывают деньги только после вашего подтверждения.

Проверять заказы и трафик

Ваши заказы с данными для подключения и израсходованный трафик — по каждому прокси или по всем сразу. Это только чтение, так что агент может обращаться сюда сколько угодно.

Следить за деньгами

Балансы кошелька в каждой валюте и полная история транзакций — по одной или постранично. Тоже только чтение.

Менять настройки

Переключить прокси между HTTP и SOCKS5, заменить его белый список IP, включить или выключить автопродление, обновить состояние. Всё это бесплатно, но клиенту, вошедшему через аккаунт, для таких действий нужно разрешение на списания.

БЕЗОПАСНОСТЬ

Деньги списываются только с вашего согласия

По умолчанию — только чтение. Когда клиент входит через аккаунт, ProxyJam показывает, какой доступ он запрашивает. Чтение заказов, кошелька и каталога выдаётся одним блоком — а в заказах есть логины и пароли ваших прокси. Списания — отдельная галочка Разрешить списания с моего кошелька, изначально снятая; она же открывает и бесплатные изменения настроек.
Сначала расчёт. create_proxy_order, extend_proxy_period и buy_proxy_bandwidth начинают с confirm=false: возвращают предложение, цену и ваш баланс и ничего не списывают.
Сначала ваше «да», потом списание. Агент повторяет вызов с confirm=true только после того, как вы одобрите расчёт. Правила для агента в промптах ниже говорят об этом прямым текстом.
Без двойных списаний. Подтверждающий вызов передаёт тот же idempotency_key, что и расчёт, поэтому повторённый запрос вернёт первый результат, а не купит второй раз. Для новой покупки — новый ключ.
API-ключ открывает весь аккаунт. У ключей из панели управления нет более узких прав: им доступно всё, и чтение, и списания. Где клиент умеет входить через аккаунт, входите так, а любому ключу, которым всё же пользуетесь, задайте срок действия.
Доступ заканчивается, когда вы его отзываете. Клиент, вошедший через аккаунт, появляется в разделе Подключённые приложения в настройках панели управления; отзовите доступ там, и он прекратится в течение пяти минут. Смена пароля или выход на всех устройствах отзывает все подключения разом. Ключ перестаёт работать, как только вы удалите его на странице «API-ключи».

НАСТРОЙКА

Подключение в три шага

Добавьте сервер в клиент
Выберите свой клиент выше и скопируйте его конфигурацию. Адрес сервера — https://proxyjam.com/mcp.
Войдите и решите, что ему можно
Клиент откроет ProxyJam в браузере. Войдите, прочитайте, какой доступ он запрашивает, и ставьте галочку Разрешить списания с моего кошелька, только если агент должен заказывать, продлевать или менять настройки. Каждое новое одобрение заменяет предыдущее, так что позже можно переподключиться и передумать. Клиенту, который не умеет входить через аккаунт, вместо этого нужен API-ключ: он начинается с pj_ и показывается только один раз.
Начните с запроса только на чтение
Сначала попросите показать предложения — это тот же актуальный каталог, что и на странице статических резидентных (ISP) прокси. Так вы убедитесь, что подключение работает, а агент получит идентификаторы предложений, без которых не обойдётся всё остальное. Потом попробуйте промпты ниже.

Через MCP-сервер ProxyJam покажи предложения статических резидентных (ISP) прокси в США с ценами за месяц. Ничего не заказывай.

Закажи в ProxyJam один статический резидентный (ISP) прокси в США на один месяц. Сначала покажи мне предварительный расчёт — предложение, цену и баланс моего кошелька — и дождись моего явного «да», прежде чем подтверждать. При подтверждении используй тот же ключ идемпотентности.

Продли мой заказ ProxyJam ORDER_ID на один месяц. Покажи предварительный расчёт с ценой и моим балансом и дождись моего «да», прежде чем подтверждать.

Покажи мои активные прокси ProxyJam с датами окончания и трафиком, который израсходовал каждый из них, затем баланс моего кошелька в USD и последние 10 транзакций.

Для моего заказа ProxyJam ORDER_ID: переключи протокол на SOCKS5, задай белый список IP 203.0.113.7 и включи автопродление. Потом сообщи мне новые настройки.

Когда работаешь с MCP-сервером ProxyJam:
- Сначала вызывай list_offers. Это единственный источник идентификаторов предложений.
- create_proxy_order, extend_proxy_period и buy_proxy_bandwidth лишь показывают предварительный расчёт, пока не передан confirm=true. Показывай мне расчёт и никогда не подтверждай без моего явного «да».
- Подтверждай с тем же idempotency_key, что и в расчёте. Для каждой новой покупки бери новый ключ.
- Если в расчёте баланс меньше цены, остановись и сообщи мне, а не подтверждай.
- Если инструмент отказывает, потому что списания не разрешены, сообщи мне, а не пробуй снова; переподключаться ли с разрешением на списания, решаю я.
- Обращайся с моим API-ключом как с секретом: никогда не выводи его, не пиши в логи и не сохраняй в файлы, которыми я могу с кем-то поделиться.

ПРОМПТЫ

Попробуйте эти промпты

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

Найти прокси Только чтение. Безопасный первый запрос. Покупка с подтверждением Списание только после вашего «да». Продление Продлить заказ, сначала — расчёт. Расход и баланс Заказы, трафик и деньги в одном ответе. Настройки Изменения, которые ничего не стоят. Правила для агента Для CLAUDE.md, AGENTS.md или правил Cursor.

СПРАВОЧНИК

Все 16 инструментов

Инструменты, которые сервер отдаёт сегодня. Три платных инструмента возвращают предварительный расчёт, пока их не вызовут повторно с confirm=true. Клиент, вошедший через аккаунт, может вызывать последние семь, только если вы разрешили списания.
Инструмент	Что делает	Тип
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	Заново считывает текущее состояние прокси	Настройки, бесплатно

СЕРВЕР

Параметры подключения

Адрес: https://proxyjam.com/mcp
Транспорт: Streamable HTTP
Аутентификация: Вход через аккаунт ProxyJam (OAuth 2.1) или API-ключ в заголовке X-API-Key
Доступ: По умолчанию только чтение; списания и изменение настроек — только с вашего разрешения
Справочники: Статусы заказов, валюты, протоколы прокси, типы предложений и способы оплаты — в виде MCP-ресурсов
Цена: Бесплатно. Вы платите только за заказанные прокси

ДОКУМЕНТАЦИЯ

Читать дальше

Руководство по MCP-серверу Аргументы каждого инструмента и разбор заказа от начала до конца

Быстрый старт От регистрации до первого запроса к API

Аутентификация Как создавать ключи, задавать им срок и отзывать их

Идемпотентность Как повторные запросы обходятся без двойных списаний

Справочник API Все REST-эндпоинты, с запуском прямо в браузере

Спецификация OpenAPI Описание API для генераторов кода

ВОПРОСЫ И ОТВЕТЫ

Вопросы о 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 — транспорты — транспорт Streamable HTTP, на котором работает этот сервер
Карточка MCP-сервера — адрес, транспорт и аутентификация для агентов, которые находят ProxyJam сами
auth.md — как агент входит, регистрируется или пользуется API-ключом
Метаданные сервера авторизации OAuth — эндпоинты и области доступа (scopes), которые клиент узнаёт при входе
Навык агента ProxyJam — руководство по работе, которое агент может загрузить перед первым вызовом

Подключите ИИ-агента к ProxyJam

Выберите клиент

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

Шестнадцать инструментов, шесть задач

Смотреть каталог

Заказывать прокси

Продлевать и докупать трафик

Проверять заказы и трафик

Следить за деньгами

Менять настройки

Деньги списываются только с вашего согласия

Подключение в три шага

Добавьте сервер в клиент

Войдите и решите, что ему можно

Начните с запроса только на чтение

Попробуйте эти промпты

Все 16 инструментов

Параметры подключения

Читать дальше

Вопросы о MCP-сервере

Начните с малого

Источники