MCP Prokso w Windsurf: mcp_config.json

1. Czego potrzebujesz

Windsurf z panelem Cascade.
Klucz API Prokso. Utwórz go w panelu: „Ustawienia” → „API”. Pełny klucz jest pokazywany tylko raz.
Dostęp do folderu domowego, w którym leży plik ustawień MCP.

Ścieżki i nazwy pól poniżej pochodzą z dokumentacji Windsurf na dzień 02.11.2026. Angielska wersja tej strony przekierowuje już do dokumentacji Devin Desktop, więc w nowszych wersjach pozycje menu mogą nazywać się inaczej. Co potrafi sam serwer — na stronie Serwer MCP Prokso.

2. Plik mcp_config.json

Otwórz ustawienia MCP: ikona MCPs w prawym górnym rogu panelu Cascade albo Windsurf Settings → Cascade → MCP Servers. Własny serwer dodaje się ręcznie w surowym pliku ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "prokso": {
      "serverUrl": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PROKSO_API_KEY}"
      }
    }
  }
}

Zdalny serwer ustawia się polem serverUrl (Windsurf przyjmuje też url) zamiast command. Zapis ${env:PROKSO_API_KEY} Windsurf zastępuje wartością zmiennej środowiskowej: podstawianie działa w polach serverUrl, url i headers. Ustaw zmienną i uruchom edytor ponownie:

# macOS, Linux
export PROKSO_API_KEY=TWÓJ_KLUCZ

# Windows
setx PROKSO_API_KEY TWÓJ_KLUCZ

W macOS i Linuksie zmienną widzą programy uruchomione z tego samego terminala, więc otwórz Windsurf stamtąd. Klucz można też wpisać wprost, "Bearer TWÓJ_KLUCZ": plik leży w folderze domowym, a nie w projekcie, ale wtedy klucz odczyta każdy, kto otworzy plik.

3. Jak sprawdzić

Zapisz plik i odśwież listę serwerów w panelu MCP przyciskiem odświeżania.
Na liście pojawi się prokso z pięcioma narzędziami: get_account, get_prices, list_plans, get_plan, get_proxy_lines. Cascade widzi jednocześnie do 100 narzędzi, więc jeśli serwerów jest dużo, wyłącz zbędne.
Napisz w Cascade: „Przez prokso pokaż moje saldo”. Agent powinien wywołać get_account i pokazać e-mail i saldo.

4. Przykładowe polecenia

„Ile transferu zostało w moich planach?”
„Daj 5 linii SOCKS5 ze stałymi IP w Polsce dla planu 12”.
„Jakie są teraz ceny za GB?”
„Daj 3 linie HTTP z Niemiec dla planu 12 w formacie z protokołem i dodaj je do konfiguracji mojego scrapera”.

Narzędzia tylko odczytują dane i zwracają linie: nie wydają pieniędzy, zakup odbywa się w panelu lub przez REST API. Porty i parametry geo — jak w przewodniku po bramce; dokładne geo liczy transfer podwójnie.

5. Jeśli nie działa

401 — klucz jest błędny lub unieważniony albo zmienna nie dotarła do edytora i w nagłówku poszedł pusty Bearer. Sprawdź zmienną w środowisku, z którego uruchomiono Windsurf.
429 — ponad 60 żądań na minutę z jednego klucza. Odczekaj tyle sekund, ile podaje nagłówek Retry-After.
Serwer się nie pojawia — sprawdź JSON (zbędny lub brakujący przecinek psuje cały plik) i adres: /api/v1/mcp bez ukośnika na końcu.

Czy klucz działa, widać też bez edytora — odpowiedź zawiera pięć 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"}'

Kody błędów serwera są opisane na stronie serwera MCP.

6. Bezpieczeństwo klucza

Klucz daje dostęp do linii proxy konta — trzymaj go w zmiennej środowiskowej i nie kopiuj mcp_config.json z kluczem do repozytorium.
Dla Windsurf utwórz osobny klucz (do 5 na konto): wtedy można go unieważnić bez psucia innych integracji.
Jeśli klucz mógł trafić w obce ręce, unieważnij go w „Ustawienia” → „API”.

Jak skonfigurować proxy w samych programach — w dziale „Instrukcje”; jeśli linie od agenta nie działają — sprawdzenie krok po kroku.

MCP w Zed →Jak korzystać z Prokso