MCP-сервер Prokso в 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: коннектор с заголовком

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

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

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

В Claude Desktop откройте меню Claude → Settings (меню приложения, а не настройки аккаунта), вкладку Developer и нажмите Edit Config. Откроется файл конфигурации:

Добавьте сервер 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