MCP Prokso w VS Code: Copilot i mcp.json

1. Czego potrzebujesz

VS Code z GitHub Copilot i czatem w trybie agenta. Dokumentacja VS Code nie podaje minimalnej wersji: jeśli w palecie nie ma poleceń MCP:, zaktualizuj edytor.
Klucz API Prokso. Utwórz go w panelu: „Ustawienia” → „API”. Pełny klucz jest pokazywany tylko raz — skopiuj go od razu.
Folder projektu otwarty w VS Code.

Co potrafi serwer i co zwraca każde narzędzie — na stronie Serwer MCP Prokso.

2. Plik .vscode/mcp.json

Utwórz w katalogu głównym projektu plik .vscode/mcp.json (otwiera go też polecenie MCP: Open Workspace Folder MCP Configuration) i wklej:

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

servers — lista serwerów; type: "http" oznacza zdalny serwer pod adresem url.
inputs — pole, które VS Code pokaże przy pierwszym uruchomieniu serwera. Z password: true wpisywany tekst jest ukryty, a wartość edytor trzyma w bezpiecznym magazynie.
${input:prokso-key} w nagłówku Authorization wstawia wpisany klucz.

Ten sam blok możesz dodać do pliku osobistego poleceniem MCP: Open User Configuration — wtedy serwer będzie dostępny we wszystkich projektach.

3. Jak sprawdzić

Uruchom MCP: List Servers, wybierz prokso i włącz serwer. VS Code poprosi o klucz — wklej go. Jeśli edytor pyta, czy ufasz serwerowi, potwierdź.
W czacie w trybie agenta otwórz wybór narzędzi (Configure Tools): w grupie prokso powinno być pięć narzędzi — get_account, get_prices, list_plans, get_plan, get_proxy_lines.
Napisz w czacie: „Przez prokso pokaż moje saldo”. Rozwiń wywołanie narzędzia w rozmowie: powinno tam być get_account z odpowiedzią bez błędu.

4. Przykładowe polecenia

„Ile transferu zostało w moich planach?”
„Daj 5 linii SOCKS5 ze stałymi IP w Polsce dla planu 12”.
„Pokaż login, host i porty planu 12”.
„Wygeneruj 10 linii HTTP z nowym adresem przy każdym żądaniu w formacie host:port:login:hasło i zapisz je w proxies.txt”.

Narzędzia tylko odczytują dane: agent nie kupi transferu i nie zmieni planu. Porty i parametry geo w liniach działają jak w przewodniku po bramce; dokładne geo (stan, miasto, operator) liczy transfer podwójnie, a dostępności konkretnego miasta nie gwarantujemy.

5. Jeśli nie działa

401 w dzienniku serwera — klucz jest błędny lub unieważniony. VS Code zapamiętał wpisaną wartość, więc zmień id w inputs i w ${input:…} (na przykład na prokso-key-2) i uruchom serwer ponownie — edytor znów zapyta o klucz.
429 — ponad 60 żądań na minutę z jednego klucza. Odczekaj tyle sekund, ile podaje nagłówek Retry-After.
Serwer się nie uruchamia albo dziennik wspomina o SSE. VS Code najpierw próbuje HTTP i dopiero potem przechodzi na SSE. Nasz serwer działa bez SSE, więc taka próba oznacza, że pierwsze żądanie POST nie przeszło: sprawdź adres i klucz. Dziennik otwiera się z MCP: List Servers → prokso → Show Output.

Sprawdź klucz bez edytora — w odpowiedzi powinna być lista pięciu narzędzi:

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

Inne kody błędów są na stronie serwera MCP, te same działania z kodu — w dokumentacji API.

6. Bezpieczeństwo klucza

Klucz daje dostęp do linii proxy twojego konta, dlatego:

nie wpisuj klucza wprost do mcp.json — folder .vscode często trafia do gita; pole inputs właśnie usuwa klucz z pliku;
dla każdego edytora czy komputera utwórz osobny klucz (do 5 na konto), aby unieważnić jeden bez ruszania pozostałych;
jeśli klucz mógł trafić w obce ręce, unieważnij go w „Ustawienia” → „API” i utwórz nowy.

Konfiguracja proxy w programach i przeglądarkach jest w dziale „Instrukcje”, sprawdzenie samego proxy — krok po kroku.

MCP w Windsurf →Jak korzystać z Prokso