Перегляд каталогу
list_offers шукає актуальні пропозиції за типом, країною, регіоном і містом та повертає всі тарифи з цінами. Лише з нього можна дізнатися ідентифікатори пропозицій, тож будь-яка покупка починається саме тут.
MCP-сервер ProxyJam дає Claude, Cursor та іншим ШІ-клієнтам 16 інструментів для роботи з вашим акаунтом: шукати пропозиції, замовляти й продовжувати проксі, перевіряти трафік і баланс. Ви входите в акаунт і самі вирішуєте, що дозволено агентові, а все, що коштує грошей, спершу показує попередній розрахунок і чекає на ваше «так».
Потрібен акаунт ProxyJam. Більшість клієнтів входять через нього, решта працює з ключем API. Сам сервер безкоштовний: ви платите лише за проксі, які замовить ваш агент.
Виберіть клієнт, щоб побачити, як його підключити. Більшість клієнтів входять через ваш акаунт ProxyJam; VS Code та OpenAI Agents SDK працюють із ключем API, тож замініть pj_... на свій.
claude.ai, Claude Desktop і мобільні застосунки. Додайте ProxyJam один раз як власний конектор — і він з'явиться в усіх трьох.
1. У Claude відкрийте налаштування конекторів і додайте власний конектор.
2. Назвіть його ProxyJam і вставте https://proxyjam.com/mcp як адресу сервера.
3. Підключіть його, увійдіть у ProxyJam і підтвердьте доступ.claude.ai, Claude Desktop і мобільні застосунки мають спільний список конекторів.
Повна інструкція в документаціїАгент Anthropic для програмування в терміналі. Сервер додається однією командою, а вхід виконує /mcp.
claude mcp add --transport http proxyjam https://proxyjam.com/mcpВиконайте команду в терміналі, потім введіть /mcp у Claude Code, виберіть proxyjam і увійдіть. Додайте --scope user, щоб сервер був доступний у всіх проєктах.
Повна інструкція в документаціїРедактор коду з ШІ. Додайте сервер у mcp.json — і під час першого підключення Cursor попросить вас увійти.
{
"mcpServers": {
"proxyjam": {
"url": "https://proxyjam.com/mcp"
}
}
}
~/.cursor/mcp.json або .cursor/mcp.json у проєкті. Cursor попросить увійти під час першого підключення.
Повна інструкція в документаціїДля власних конекторів потрібен режим розробника, який OpenAI пропонує як бета-функцію на деяких тарифах.
1. У налаштуваннях ChatGPT увімкніть режим розробника й створіть власний конектор.
2. Вкажіть https://proxyjam.com/mcp як його URL і виберіть OAuth.
3. Увійдіть у ProxyJam і підтвердьте доступ.ChatGPT сам представляється серверу й відкриває сторінку входу в ProxyJam.
Повна інструкція в документаціїАгент OpenAI для програмування в терміналі. Дві команди: перша додає сервер, друга виконує вхід.
codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjamВиконайте обидві в терміналі; друга відкриє браузер, щоб ви увійшли.
Повна інструкція в документаціїРежим агента в Copilot Chat. Підключається з ключем 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 для термінала. Додайте сервер, а потім увійдіть командою /mcp auth proxyjam.
gemini mcp add --transport http proxyjam https://proxyjam.com/mcpВиконайте команду в терміналі, потім введіть /mcp auth proxyjam у Gemini CLI, щоб увійти.
Повна інструкція в документаціїPython-фреймворк для створення власних агентів. Підключається з ключем API в заголовку запиту.
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.
Повна інструкція в документаціїPython-бібліотека для MCP-клієнтів і серверів. Виконує вхід через браузер і показує список інструментів.
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 — і ваш агент зможе робити у вашому акаунті майже все, що в REST API можна зробити з ключем API. Перш ніж почати, варто знати дві речі.
Ви вирішуєте, що йому можна. Клієнт, що входить в акаунт, спершу просить вашого схвалення. Читання надається одним блоком, і воно охоплює логіни та паролі ваших проксі; витрати з гаманця, а разом із ними й безкоштовні зміни налаштувань, — окремий пункт, який варто позначати, лише якщо ви хочете, щоб агент діяв. З ключем API інакше: він відкриває весь акаунт, тож там, де клієнт уміє входити, краще входити через акаунт.
Гроші списуються лише після попереднього розрахунку. Три платні інструменти ніколи не списують кошти з першого виклику. Вони повертають попередній розрахунок із позначкою dry_run і списують гроші, лише коли їх викличуть повторно з confirm=true, а уважний агент робить це тільки після вашого «так».
list_offers шукає актуальні пропозиції за типом, країною, регіоном і містом та повертає всі тарифи з цінами. Лише з нього можна дізнатися ідентифікатори пропозицій, тож будь-яка покупка починається саме тут.
create_proxy_order купує від 1 до 50 проксі за однією пропозицією. Перший виклик лише показує ціну та ваш баланс, а замовлення оформлюється, коли ви його підтвердите.
extend_proxy_period продовжує проксі ще на один період, а buy_proxy_bandwidth додає трафік статичному проксі. Обидва спершу показують попередній розрахунок і списують гроші лише після вашого підтвердження.
Ваші замовлення з даними для підключення, а також трафік, який використав кожен проксі окремо чи всі разом. Це лише читання, тож агент може звертатися сюди скільки завгодно.
Баланси гаманця в кожній валюті й повна історія транзакцій — по одній або цілою сторінкою. Теж лише читання.
Перемкнути проксі між HTTP і SOCKS5, замінити його білий список IP, увімкнути чи вимкнути автопродовження або оновити стан проксі. Жодна з цих дій нічого не коштує, але клієнтові, що ввійшов в акаунт, для них потрібен дозвіл на витрати.
create_proxy_order, extend_proxy_period і buy_proxy_bandwidth починають із confirm=false: вони повертають пропозицію, ціну та ваш баланс і нічого не списують.confirm=true лише після того, як ви схвалите попередній розрахунок. Правила для агента в промптах нижче кажуть про це прямим текстом.idempotency_key, що й попередній розрахунок, тож повторений запит поверне перший результат, а не купить удруге. Нова покупка — новий ключ.Оберіть свій клієнт вище й скопіюйте його конфігурацію. Адреса сервера — 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 на номер замовлення з панелі керування. Остання вкладка — набір правил, які варто тримати в інструкціях агента.
| Інструмент | Що робить | Дія |
|---|---|---|
| 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 до 5000 ГБ трафіку статичному проксі | Витрачає гроші, спершу розрахунок |
| set_auto_renew | Вмикає або вимикає автопродовження | Змінює налаштування, безкоштовно |
| set_proxy_whitelist | Замінює список IP, яким дозволено користуватися проксі | Змінює налаштування, безкоштовно |
| change_proxy_protocol | Перемикає між HTTP і SOCKS5 | Змінює налаштування, безкоштовно |
| sync_proxy_state | Повторно зчитує поточний стан проксі | Змінює налаштування, безкоштовно |
Будь-який MCP-клієнт, що підключається до віддаленого сервера через Streamable HTTP і або входить в акаунт через OAuth, або дає змогу додати заголовок запиту. Конфігурації вище охоплюють Claude (claude.ai, Claude Desktop і мобільні застосунки), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, OpenAI Agents SDK і FastMCP.
Так. У Claude додайте власний конектор з адресою https://proxyjam.com/mcp і увійдіть у ProxyJam; конектор з'явиться також у Claude Desktop і мобільних застосунках. У ChatGPT для власних MCP-конекторів потрібен режим розробника, який OpenAI пропонує як бета-функцію на деяких тарифах; додайте ту саму адресу й виберіть OAuth.
Ні. Підключення й виклики інструментів безкоштовні. Ви платите лише за те, що замовить агент, — за тими самими цінами, що й у панелі керування, з вашого гаманця ProxyJam.
Випадково — ні. Клієнт, що входить в акаунт, узагалі не може нічого витрачати, якщо під час схвалення ви не позначили *Дозволити витрати з мого гаманця*. Але й тоді три платні інструменти — замовлення, продовження й купівля трафіку — на перший виклик повертають попередній розрахунок і списують гроші, лише коли їх викличуть повторно з confirm=true. Уважний агент показує вам цей розрахунок і чекає, а правила для агента вище саме цього від нього й вимагають. У ключа API немає ліміту витрат, тож давайте агентові ключ, який зможете видалити.
Поповнити гаманець, керувати ключами API, змінити налаштування акаунта, перевірити IP-адреси чи виконати дії з мобільними проксі, як-от зміну IP. Усе це лишається в панелі керування та REST API.
Ні, якщо ваш клієнт уміє входити в акаунт. Запит, у якому немає ні входу, ні ключа, сервер відхиляє й вказує, де увійти в ProxyJam, — саме так claude.ai, Claude Code, Cursor та інші клієнти самі запускають вхід. Клієнти, які входити не вміють, натомість надсилають ключ API.
Підключіться знову й схваліть доступ, позначивши пункт або знявши позначку: кожне схвалення замінює попереднє. У Claude Code, наприклад, це /mcp, а потім повторний вхід у proxyjam.
Клієнта, що ввійшов в акаунт, відкличте в розділі «Підключені застосунки» в налаштуваннях панелі керування: він утратить доступ протягом п'яти хвилин, а решта підключень працюватиме далі. Зміна пароля або вихід на всіх пристроях відкликає їх усі одразу. Ключ API видаліть на сторінці «Ключі API»; ключ, створений із терміном дії, і сам перестане працювати, коли той спливе.
Так, але з обмеженнями. Агент, за яким не стоїть жоден акаунт, може зареєструватися й отримати ключ, що лише читає публічний каталог. Якщо ви прив'яжете цей ключ за кодом, який ProxyJam надішле вам на пошту, він приєднається до вашого акаунта й зможе читати ваші замовлення та гаманець, але витрачати гроші не зможе ніколи. Інструкція для агентів — в auth.md.