MCP Prokso в VS Code: Copilot и mcp.json

1. Что нужно

VS Code с GitHub Copilot и чатом в режиме агента. Документация VS Code не называет минимальной версии: если команд MCP: в палитре нет, обновите редактор.
Ключ API Prokso. Создайте его в кабинете: «Настройки» → «API». Ключ показывается полностью только один раз — скопируйте его сразу.
Открытая в VS Code папка проекта.

Что умеет сервер и что возвращает каждый инструмент — на странице MCP-сервер Prokso.

2. Файл .vscode/mcp.json

Создайте в корне проекта файл .vscode/mcp.json (его открывает и команда MCP: Open Workspace Folder MCP Configuration) и вставьте:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "prokso-key",
      "description": "Ключ API Prokso",
      "password": true
    }
  ],
  "servers": {
    "prokso": {
      "type": "http",
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:prokso-key}"
      }
    }
  }
}

servers — список серверов; type: "http" означает удалённый сервер по адресу url.
inputs — поле, которое VS Code покажет при первом запуске сервера. С password: true ввод скрыт, а значение редактор хранит в защищённом хранилище.
${input:prokso-key} в заголовке Authorization подставляет введённый ключ.

Тот же блок можно добавить в личный файл командой MCP: Open User Configuration — тогда сервер будет доступен во всех проектах.

3. Как проверить

Выполните MCP: List Servers, выберите prokso и запустите сервер. VS Code попросит ключ — вставьте его. Если редактор спрашивает, доверяете ли вы серверу, подтвердите.
В чате в режиме агента откройте выбор инструментов (Configure Tools): в группе prokso должно быть пять инструментов — get_account, get_prices, list_plans, get_plan, get_proxy_lines.
Напишите в чате: «Через prokso покажи мой баланс». Разверните вызов инструмента в разговоре: там должен быть get_account с ответом без ошибки.

4. Примеры запросов

«Сколько трафика осталось на моих планах?»
«Дай 5 строк SOCKS5 с фиксированными IP в Польше для плана 12».
«Покажи логин, хост и порты плана 12».
«Сгенерируй 10 строк HTTP с новым адресом на каждый запрос в формате хост:порт:логин:пароль и запиши их в proxies.txt».

Инструменты только читают данные: агент не купит трафик и не изменит план. Порты и параметры гео в строках — как в справочнике шлюза; точное гео (штат, город, оператор) считает трафик вдвое, а наличие конкретного города мы не гарантируем.

5. Если не работает

401 в журнале сервера — ключ неверный или отозван. VS Code запомнил введённое значение, поэтому измените id в inputs и в ${input:…} (например, на prokso-key-2) и перезапустите сервер — редактор спросит ключ снова.
429 — больше 60 запросов в минуту с одним ключом. Подождите столько секунд, сколько указано в заголовке Retry-After.
Сервер не стартует или в журнале упоминается SSE. VS Code сначала пробует HTTP и только потом переходит на SSE. Наш сервер работает без SSE, так что такая попытка значит, что первый POST-запрос не прошёл: проверьте адрес и ключ. Журнал открывается из MCP: List Servers → prokso → Show Output.

Проверьте ключ без редактора — в ответе должен быть список из пяти инструментов:

curl -X POST https://prokso.com/api/v1/mcp -H "Authorization: Bearer КЛЮЧ" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Другие коды ошибок — на странице MCP-сервера, те же действия из кода — в документации API.

6. Безопасность ключа

Ключ даёт доступ к строкам прокси вашего аккаунта, поэтому:

не вписывайте ключ прямо в mcp.json — папка .vscode часто попадает в git; поле inputs как раз убирает ключ из файла;
для каждого редактора или компьютера создайте отдельный ключ (до 5 на аккаунт), чтобы отозвать один, не трогая остальные;
если ключ мог попасть в чужие руки, отзовите его в «Настройки» → «API» и создайте новый.

Настройка прокси в программах и браузерах — в разделе «Инструкции», проверка самого прокси — по шагам.

MCP в Windsurf →Как пользоваться Prokso