# MCP-сервер для ШІ-агентів | ProxyJam Підключіть Claude, Cursor й інші MCP-клієнти до акаунта ProxyJam: пошук пропозицій, замовлення й продовження проксі, трафік. Покупки — лише з вашого «так». - Canonical: https://proxyjam.com/uk/mcp/ - Updated: 2026-10-14 - Language: uk 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) проксі](/uk/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 до 5000 ГБ трафіку статичному проксі | Витрачає гроші, спершу розрахунок | | 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 — і ваш агент зможе робити у вашому акаунті майже все, що в REST API можна зробити з ключем API. Перш ніж почати, варто знати дві речі. **Ви вирішуєте, що йому можна.** Клієнт, що входить в акаунт, спершу просить вашого схвалення. Читання надається одним блоком, і воно охоплює логіни та паролі ваших проксі; витрати з гаманця, а разом із ними й безкоштовні зміни налаштувань, — окремий пункт, який варто позначати, лише якщо ви хочете, щоб агент діяв. З ключем API інакше: він відкриває весь акаунт, тож там, де клієнт уміє входити, краще входити через акаунт. **Гроші списуються лише після попереднього розрахунку.** Три платні інструменти ніколи не списують кошти з першого виклику. Вони повертають попередній розрахунок із позначкою `dry_run` і списують гроші, лише коли їх викличуть повторно з `confirm=true`, а уважний агент робить це тільки після вашого «так».