Prokso MCP w Cursor: konfiguracja mcp.json

1. Czego potrzebujesz

Cursor z obsługą MCP. Działa z trzema transportami — stdio, SSE i Streamable HTTP; serwer Prokso używa Streamable HTTP. Instrukcja jest zgodna z dokumentacją Cursor o MCP według stanu na listopad 2026.
Klucz API Prokso: panel, „Ustawienia” → „API” → „Utwórz klucz”. Skopiuj klucz od razu — w całości jest pokazywany tylko raz.
Sprawdź klucz przez curl według instrukcji na stronie „Serwer MCP Prokso”.

2. Gdzie wpisać serwer

Cursor odczytuje serwery MCP z dwóch plików:

Plik	Gdzie działa
`.cursor/mcp.json`	Tylko w tym projekcie (plik w katalogu głównym projektu)
`~/.cursor/mcp.json`	We wszystkich projektach (plik w folderze domowym)

Utwórz potrzebny plik lub dopisz serwer do istniejącego:

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

Zapis ${env:PROKSO_API_KEY} Cursor zastępuje wartością zmiennej środowiskowej. Zmienne działają w polach url, headers, command, args i env. Ustaw zmienną, na przykład w ~/.zshrc:

export PROKSO_API_KEY="TWÓJ_KLUCZ"

Jeśli Cursor nie został uruchomiony z terminala, może nie widzieć zmiennych z ~/.zshrc. Wtedy uruchom Cursor z terminala, w którym zmienna jest ustawiona, albo wpisz klucz bezpośrednio do globalnego pliku ~/.cursor/mcp.json — leży poza projektem i nie trafi do repozytorium.

3. Jak włączyć i sprawdzić

Serwery włącza się i wyłącza w sekcji Customize na pasku bocznym Cursor. Gdy prokso jest włączony, na liście Available Tools powinno pojawić się pięć narzędzi: get_account, get_prices, list_plans, get_plan i get_proxy_lines. Wyłączony serwer się nie ładuje i nie pojawia w czacie.

Jeśli narzędzi nie ma, otwórz panel Output (Cmd+Shift+U w macOS) i wybierz MCP Logs: widać tam inicjalizację serwera, wywołania narzędzi i błędy.

4. Pierwsze prośby w czacie agenta

„Ile transferu zostało w moich planach Prokso?”
„Daj 5 ciągów SOCKS5 ze stałymi IP w Polsce dla planu 12.”
„Dodaj do config.py listę 10 proxy z Niemiec w formacie url.”
„Weź ciąg proxy z USA i dopisz do mojego skryptu żądanie do https://prokso.com/ip, aby sprawdzić IP.”

Agent Cursor sam wywołuje list_plans, aby znaleźć numer planu. Dokładne geo (miasto, stan, operator) liczy się podwójnie — porty i parametry opisuje przewodnik po bramce.

5. Jeśli nie działa

W MCP Logs 401 z Pass your API key in the header — zmienna PROKSO_API_KEY jest pusta dla Cursor. Sprawdź ją i uruchom Cursor ponownie.
401 z Invalid or revoked API key — klucz jest błędny lub unieważniony. Sprawdź, czy wartość nagłówka zawiera Bearer i spację.
Cursor proponuje logowanie przez OAuth — serwer Prokso go nie ma. Upewnij się, że nagłówek Authorization jest w headers właśnie tego serwera.
429 — przekroczono limit 60 żądań na minutę na klucz, odczekaj chwilę.
Serwer się nie pojawia — sprawdź składnię JSON (przecinek między serwerami, cudzysłowy) i czy plik leży dokładnie w .cursor/mcp.json.

Inne błędy — na stronie serwera MCP, problemy z proxy — w sprawdzeniu krok po kroku.

6. Bezpieczeństwo klucza

Projektowy .cursor/mcp.json często trafia do repozytorium razem z kodem, więc nie wpisuj do niego klucza wprost — tylko ${env:PROKSO_API_KEY}. Utwórz dla Cursor osobny klucz: jeśli zobaczy go ktoś obcy, unieważnij tylko jego w „Ustawienia” → „API”. Agent nie kupuje transferu przez MCP; automatyzacja z płatnościami idzie przez REST API, a konfiguracja proxy w innych programach jest w dziale „Instrukcje”.

MCP w VS Code →Jak korzystać z Prokso