Prokso MCP у Claude Desktop і claude.ai

1. Що потрібно й який спосіб обрати

Ключ API Prokso: кабінет, «Налаштування» → «API» → «Створити ключ». Перевірте його curl-ом за інструкцією на сторінці «MCP-сервер Prokso».
Спосіб 1 — конектор із заголовком запиту. Працює і в Claude Desktop, і в claude.ai. Розділ Request headers у вікні додавання конектора — бета-функція, доступна обмеженому колу організацій. Якщо цього розділу у вас немає, переходьте до способу 2.
Спосіб 2 — міст mcp-remote. Лише в застосунку Claude Desktop. Потрібен Node.js 18 або новіший: міст запускається на вашому комп'ютері й пересилає запити на сервер Prokso з вашим заголовком.

Інструкцію звірено з довідкою Claude про конектори і з README пакета mcp-remote станом на листопад 2026. Назви пунктів меню наводимо англійською, як в інтерфейсі Claude.

2. Спосіб 1: конектор із заголовком

Відкрийте Customize → Connectors і натисніть Add custom connector.
У полі адреси сервера вкажіть https://prokso.com/api/v1/mcp.
У виборі автентифікації оберіть No sign-in: ключ передаватиметься заголовком, OAuth не потрібен.
Відкрийте Request headers, оберіть назву authorization і введіть значення Bearer КЛЮЧ — саме так, зі словом Bearer і пробілом: Claude надсилає значення без змін. Позначте заголовок як обов'язковий (Required).
Натисніть Add.

Змінити заголовок після збереження не можна: щоб поставити новий ключ, видаліть конектор і додайте заново. На тарифах Team і Enterprise конектор додає власник організації, і заголовок тоді спільний для всіх учасників — тобто всі бачитимуть плани одного акаунта Prokso. Для особистого ключа краще спосіб 2 або Claude Code.

3. Спосіб 2: міст mcp-remote у Claude Desktop

У Claude Desktop відкрийте меню Claude → Settings (меню застосунку, а не налаштування акаунта), вкладку Developer і натисніть Edit Config. Відкриється файл конфігурації:

Система	Файл
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Додайте сервер Prokso (якщо в файлі вже є інші сервери, допишіть блок prokso усередину mcpServers):

{
  "mcpServers": {
    "prokso": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://prokso.com/api/v1/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer КЛЮЧ"
      }
    }
  }
}

Ключ іде в змінну AUTH_HEADER, а в аргументі після двокрапки немає пробілу. Так радить README mcp-remote: Claude Desktop у Windows неправильно передає пробіли всередині args. Параметр --transport http-only каже мосту не пробувати застарілий SSE. Збережіть файл, повністю закрийте Claude Desktop і запустіть знову.

4. Перевірка

У полі введення повідомлення натисніть кнопку + («Add files, connectors, and more»), наведіть на Connectors і відкрийте Manage connectors. Оберіть prokso — має бути п'ять інструментів: get_account, get_prices, list_plans, get_plan, get_proxy_lines. Там само конектор можна вмикати й вимикати для окремої розмови.

Перші запити:

«Скільки трафіку лишилося на моїх планах Prokso?»
«Дай 5 рядків SOCKS5 з фіксованими IP у Польщі для плану 12.»
«Покажи хост і порти мого плану й поясни, який порт для чого.»

Перед викликом інструмента Claude питає дозвіл. «Always allow» ставте лише тоді, коли впевнені в налаштуваннях.

5. Якщо не працює

Немає розділу Request headers — у вашої організації ще немає доступу до бети. Скористайтеся способом 2 або Claude Code.
Конектор просить увійти чи показує помилку автентифікації — обрано вхід через OAuth або заголовок без Bearer. Видаліть конектор і додайте заново з No sign-in.
Сервер у способі 2 не з'являється — перевірте синтаксис JSON, наявність Node.js 18+ (node --version) і журнали: на macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log, у Windows — папка %APPDATA%\Claude\logs.
У журналі 401 — ключ неправильний або відкликаний; 429 — перевищено ліміт 60 запитів на хвилину.

Решта помилок — на сторінці MCP-сервера, проблеми з проксі — у перевірці за кроками.

6. Безпека ключа

У способі 2 ключ лежить у claude_desktop_config.json відкритим текстом: не пересилайте цей файл і не синхронізуйте його в публічні місця. У способі 1 Claude зберігає значення заголовка й більше його не показує. Заведіть для Claude окремий ключ і в разі сумнівів відкличте його в «Налаштування» → «API». Купувати трафік через MCP агент не може — для цього є кабінет і REST API; налаштування проксі в програмах — у розділі «Інструкції», порти — у довіднику шлюзу.

MCP у Cursor →Як користуватися Prokso