Как подключить MCP-сервер PapaProxy.net в Claude Code

Что понадобится

• Claude Code, установленный и с выполненным входом. Проверить можно командой claude --version. Команды ниже одинаковы для macOS, Linux и Windows, отличаются только переносы строк в терминале.
• Аккаунт PapaProxy.net. Доступ к API и MCP-серверу входит в аккаунт бесплатно, вы платите только за заказанные прокси.
• Node.js, Python и локальные пакеты не нужны. Сервер работает по адресу https://papaproxy.net/account_new/api/v1/mcp по протоколу Streamable HTTP, который Claude Code поддерживает как --transport http.

Шаг 1. Создайте ключ API с нужными правами

В личном кабинете откройте Настройки → API-ключи, назовите ключ (например, «Claude Code») и выберите права. Полный ключ показывается один раз, сразу после создания. Права проверяются на нашей стороне, поэтому ограничивают Claude независимо от правил разрешений и режима работы.

Начните без wallet:spend. Claude всё равно сможет рассчитать любой заказ и показать цену. Право на оплату добавьте или выпустите второй ключ, когда действительно захотите, чтобы Claude покупал. Полный список прав — на странице для разработчиков.

Шаг 2. Добавьте сервер в Claude Code

Claude Code хранит MCP-серверы в одной из трёх областей. От области зависит, где сервер загружается и получит ли его ваша команда.

Способ 1: одна команда

Для личной настройки добавьте сервер в область user, чтобы он был доступен во всех проектах. Замените fb_YOUR_API_KEY своим ключом, а слово Bearer и пробел перед ключом оставьте.

claude mcp add --transport http --scope user papaproxy-net \
  https://papaproxy.net/account_new/api/v1/mcp \
  --header "Authorization: Bearer fb_YOUR_API_KEY"

claude mcp add --transport http --scope user papaproxy-net https://papaproxy.net/account_new/api/v1/mcp --header "Authorization: Bearer fb_YOUR_API_KEY"

При успехе Claude Code выводит строку Added .... Без --scope user сервер будет работать только в текущем проекте. Ключ сохраняется открытым текстом в ~/.claude.json; если это нежелательно, используйте способ 2.

Способ 2: .mcp.json с ключом в переменной окружения

Подходит, чтобы поделиться настройкой с командой через Git. Claude Code подставляет ${VAR} в url и headers: в файле в репозитории указано только имя переменной, а каждый разработчик хранит свой ключ вне репозитория.

{
  "mcpServers": {
    "papaproxy-net": {
      "type": "http",
      "url": "https://papaproxy.net/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${PAPAPROXY_API_KEY}"
      }
    }
  }
}

export PAPAPROXY_API_KEY="fb_..."

Перед запуском claude откройте новый терминал или выполните source ~/.zshrc, чтобы переменная была видна. В Windows задайте её в «Свойствах системы» → «Переменные среды». При первом запуске claude в проекте он попросит одобрить серверы из .mcp.json; пока вы этого не сделаете, у сервера будет статус Pending approval.

Шаг 3. Проверьте подключение

Выполните команду в терминале. Статус должен быть ✔ Connected; если там ✘ Failed to connect, в той же строке будут HTTP-статус и текст ошибки от нашего сервера.

claude mcp get papaproxy-net

Внутри сессии команда /mcp показывает сервер и число его инструментов. Затем отправьте запрос, который ничего не стоит:

Через MCP-сервер papaproxy-net покажи страны, где есть серверные прокси, и рассчитай цену 100 IP в США на месяц. Ничего не покупай.

Claude должен вызвать list_countries и quote_composite и ответить ценой в долларах. Расчёт цены бесплатный, ничего не резервирует и не списывает. Если вызов завершился ошибкой, загляните в раздел «Решение проблем».

Разрешения: что Claude может запускать без подтверждения

Claude Code спрашивает разрешение перед вызовом инструмента MCP, если его не разрешает правило. В правилах инструмент называется mcp__papaproxy-net__<инструмент>. Правила проверяются в фиксированном порядке: сначала deny, затем ask, затем allow. Поэтому правило ask оставляет платный инструмент с подтверждением, даже если его разрешает более широкое правило. Добавьте правила командой /permissions в сессии или в файл .claude/settings.json (этот проект) либо ~/.claude/settings.json (все проекты):

{
  "permissions": {
    "allow": [
      "mcp__papaproxy-net__list_countries",
      "mcp__papaproxy-net__quote_composite",
      "mcp__papaproxy-net__list_services",
      "mcp__papaproxy-net__get_service",
      "mcp__papaproxy-net__list_proxy_ips",
      "mcp__papaproxy-net__get_whitelist",
      "mcp__papaproxy-net__get_usage_overview",
      "mcp__papaproxy-net__get_diagnostics",
      "mcp__papaproxy-net__get_recommendations",
      "mcp__papaproxy-net__wallet_balance"
    ],
    "ask": [
      "mcp__papaproxy-net__order_composite",
      "mcp__papaproxy-net__order_dedicated",
      "mcp__papaproxy-net__add_ips",
      "mcp__papaproxy-net__renew_service",
      "mcp__papaproxy-net__purchase_addon",
      "mcp__papaproxy-net__refresh_ips",
      "mcp__papaproxy-net__rotate_proxy_credentials",
      "mcp__papaproxy-net__remove_whitelist_ip",
      "mcp__papaproxy-net__cancel_service",
      "mcp__papaproxy-net__disable_addon"
    ]
  }
}

В списке allow — инструменты только для чтения: ничего не меняется и не списывается. В списке ask — инструменты, которые списывают с баланса или меняют доступ; для cancel_service и disable_addon Claude дополнительно должен явно подтвердить действие. Настоящее ограничение всё равно — права ключа: ключ без wallet:spend ничего не оплатит, в каком бы режиме ни работал Claude Code, а ключ с этим правом платит только с баланса аккаунта.

Что делать с этим в Claude Code

Claude Code и так пишет и запускает ваши парсеры из терминала. С подключённым MCP-сервером в той же сессии можно управлять прокси, на которых они работают.

Большие списки прокси. list_proxy_ips возвращает весь список услуги одним ответом. Claude Code предупреждает, когда ответ инструмента больше 10 000 токенов, и по умолчанию обрезает его на 25 000 токенов — пакет из нескольких тысяч IP может до этого дойти. Для больших пакетов попросите Claude написать код, который скачивает список через REST API, а не читает его в чат, или поднимите лимит переменной MAX_MCP_OUTPUT_TOKENS.

Все 56 инструментов с нужными правами и REST-эндпоинтами описаны в справочнике API (на английском). Когда сценарий превращается в регулярную задачу, перенесите его на REST API: обычный код дешевле и проще тестировать, чем агента.

Решение проблем: MCP в Claude Code не работает

Начните с claude mcp list или claude mcp get papaproxy-net: они показывают статус сервера, предупреждения о настройке и ошибку, которую вернул наш сервер.

Если в статусе ошибка сервера, а не настройки, напишите в поддержку и укажите время неудачного вызова — мы проверим его на своей стороне.

Другие MCP-клиенты

Тот же адрес и заголовок работают и в других клиентах, отличаются только файл настроек и его формат. Есть пошаговые руководства для Cursor и n8n, а настройка для VS Code, Windsurf, Cline, Codex CLI, Gemini CLI и Claude Desktop — на странице для разработчиков.