Prokso MCP в Claude Code: подключение

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