$
УвійтиРеєстрація

MCP-сервер Prokso в Claude Code

Claude Code підключає віддалені MCP-сервери однією командою й уміє передавати власний заголовок, тому ключ API Prokso працює в ньому без обхідних шляхів. Нижче — команда, спільний файл для проєкту й перевірка.

1. Що потрібно

  • Claude Code — консольний агент Anthropic. Віддалені сервери через HTTP він підключає з транспортом --transport http; інструкція звірена з його документацією про MCP станом на листопад 2026.
  • Ключ API Prokso: кабінет, «Налаштування» → «API» → «Створити ключ». Ключ показується повністю лише один раз — скопіюйте його одразу.
  • Перевірте ключ перед налаштуванням — команда curl є на сторінці «MCP-сервер Prokso».

2. Підключення однією командою

Виконайте в терміналі, підставивши свій ключ:

claude mcp add --transport http prokso https://prokso.com/api/v1/mcp \
  --header "Authorization: Bearer КЛЮЧ"

Спершу йдуть параметри, потім назва сервера prokso і адреса. Без параметра --scope сервер додається в область local: він доступний лише вам і лише в поточному проєкті, а запис зберігається у файлі ~/.claude.json. Щоб сервер був у всіх ваших проєктах, додайте --scope user:

claude mcp add --transport http --scope user prokso https://prokso.com/api/v1/mcp \
  --header "Authorization: Bearer КЛЮЧ"

У цих двох варіантах ключ записується у ~/.claude.json відкритим текстом. Не пересилайте цей файл і не кладіть його в репозиторій.

3. Спільний файл .mcp.json для команди

Область project зберігає сервер у файлі .mcp.json у корені проєкту, і його бачать усі, хто працює з репозиторієм. Ключ у такий файл не пишіть — Claude Code підставляє змінні середовища у поля url і headers:

{
  "mcpServers": {
    "prokso": {
      "type": "http",
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${PROKSO_API_KEY}"
      }
    }
  }
}

Кожен учасник задає свій ключ у змінній перед запуском Claude Code, наприклад у ~/.zshrc:

export PROKSO_API_KEY="КЛЮЧ"

Для серверів з .mcp.json Claude Code при першому запуску питає дозвіл. Доки ви не погодились, claude mcp list показує сервер як такий, що чекає підтвердження. Скинути збережені рішення можна командою claude mcp reset-project-choices.

4. Перевірка й перші запити

Подивіться стан сервера:

claude mcp list
claude mcp get prokso

Біля prokso має стояти ✔ Connected. Усередині сесії Claude Code те саме показує команда /mcp: у рядку сервера — галочка, а в деталях — п'ять інструментів get_account, get_prices, list_plans, get_plan і get_proxy_lines.

Перші запити для перевірки:

  • «Скільки трафіку лишилося на моїх планах Prokso?»
  • «Дай 5 рядків SOCKS5 з фіксованими IP у Польщі для плану 12.»
  • «Збережи 10 рядків проксі з Німеччини у файл proxies.txt у форматі хост:порт:логін:пароль.»

Перед викликом інструмента Claude Code питає дозвіл. Порти й параметри гео в рядках — як у довіднику шлюзу.

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

  • Статус ! Needs authentication або помилка 401 — сервер не отримав правильний ключ. Сервер Prokso не має входу через OAuth, тому кнопка входу тут не допоможе: перевірте заголовок командою claude mcp get prokso.
  • Ключ зі змінної не підставився — змінна не задана в тому терміналі, з якого запущено Claude Code. Перевірте echo $PROKSO_API_KEY і перезапустіть Claude Code.
  • ✘ Failed to connect — перевірте адресу: має бути https://prokso.com/api/v1/mcp і транспорт http, а не sse.
  • 429 — перевищено ліміт 60 запитів на хвилину на ключ. Зачекайте й повторіть.

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

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

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

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