Prokso MCP w Claude Code: konfiguracja

1. Czego potrzebujesz

Claude Code — konsolowy agent firmy Anthropic. Zdalne serwery przez HTTP podłącza z transportem --transport http; instrukcja jest zgodna z jego dokumentacją MCP według stanu na listopad 2026.
Klucz API Prokso: panel, „Ustawienia” → „API” → „Utwórz klucz”. Klucz jest pokazywany w całości tylko raz — skopiuj go od razu.
Sprawdź klucz przed konfiguracją — polecenie curl jest na stronie „Serwer MCP Prokso”.

2. Podłączenie jednym poleceniem

Uruchom w terminalu, wstawiając swój klucz:

claude mcp add --transport http prokso https://prokso.com/api/v1/mcp \
  --header "Authorization: Bearer TWÓJ_KLUCZ"

Najpierw idą opcje, potem nazwa serwera prokso i adres. Bez opcji --scope serwer trafia do zakresu local: jest dostępny tylko dla ciebie i tylko w bieżącym projekcie, a wpis jest zapisany w pliku ~/.claude.json. Aby serwer był we wszystkich twoich projektach, dodaj --scope user:

claude mcp add --transport http --scope user prokso https://prokso.com/api/v1/mcp \
  --header "Authorization: Bearer TWÓJ_KLUCZ"

W obu wariantach klucz jest zapisywany w ~/.claude.json otwartym tekstem. Nie przesyłaj tego pliku i nie dodawaj go do repozytorium.

3. Wspólny plik .mcp.json dla zespołu

Zakres project trzyma serwer w pliku .mcp.json w katalogu głównym projektu, widocznym dla wszystkich pracujących z repozytorium. Nie wpisuj klucza do tego pliku — Claude Code podstawia zmienne środowiskowe w polach url i headers:

{
  "mcpServers": {
    "prokso": {
      "type": "http",
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${PROKSO_API_KEY}"
      }
    }
  }
}

Każdy członek zespołu ustawia swój klucz w zmiennej przed uruchomieniem Claude Code, na przykład w ~/.zshrc:

export PROKSO_API_KEY="TWÓJ_KLUCZ"

Dla serwerów z .mcp.json Claude Code przy pierwszym uruchomieniu prosi o zgodę. Dopóki jej nie dasz, claude mcp list pokazuje serwer jako oczekujący na zatwierdzenie. Zapisane decyzje zresetujesz poleceniem claude mcp reset-project-choices.

4. Sprawdzenie i pierwsze prośby

Sprawdź stan serwera:

claude mcp list
claude mcp get prokso

Przy prokso powinno być ✔ Connected. W sesji Claude Code to samo pokazuje polecenie /mcp: w wierszu serwera — znacznik, a w szczegółach — pięć narzędzi get_account, get_prices, list_plans, get_plan i get_proxy_lines.

Pierwsze prośby na próbę:

„Ile transferu zostało w moich planach Prokso?”
„Daj 5 ciągów SOCKS5 ze stałymi IP w Polsce dla planu 12.”
„Zapisz 10 ciągów proxy z Niemiec do pliku proxies.txt w formacie host:port:login:hasło.”

Przed wywołaniem narzędzia Claude Code prosi o zgodę. Porty i parametry geo w ciągach działają jak w przewodniku po bramce.

5. Jeśli nie działa

Status ! Needs authentication lub błąd 401 — serwer nie dostał poprawnego klucza. Serwer Prokso nie ma logowania przez OAuth, więc przycisk logowania tu nie pomoże: sprawdź nagłówek poleceniem claude mcp get prokso.
Klucz ze zmiennej się nie podstawił — zmienna nie jest ustawiona w terminalu, z którego uruchomiono Claude Code. Sprawdź echo $PROKSO_API_KEY i uruchom Claude Code ponownie.
✘ Failed to connect — sprawdź adres: musi być https://prokso.com/api/v1/mcp i transport http, a nie sse.
429 — przekroczono limit 60 żądań na minutę na klucz. Odczekaj i powtórz.

Pozostałe błędy są opisane na stronie serwera MCP, problemy z samymi proxy — w sprawdzeniu krok po kroku.

6. Bezpieczeństwo klucza

Klucz daje dostęp do loginów i haseł twoich planów. Dla Claude Code utwórz osobny klucz: jeśli coś pójdzie nie tak, unieważnij tylko jego w „Ustawienia” → „API”. Nie commituj klucza w .mcp.json — używaj zmiennej PROKSO_API_KEY. Agent nie kupi transferu przez MCP; do automatyzacji z pieniędzmi jest REST API, a instrukcje dla programów są w dziale „Instrukcje”.

MCP w Claude Desktop →Jak korzystać z Prokso