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