$
Zaloguj sięRejestracja

Serwer MCP Prokso w Cline

Cline — agent dla VS Code i innych edytorów, ma też wersję konsolową — działa ze zdalnymi serwerami MCP. Dla Prokso ważne są dwie rzeczy: typ streamableHttp i nagłówek z kluczem API.

1. Czego potrzebujesz

  • Rozszerzenie Cline w edytorze lub Cline CLI. Dokumentacja Cline nie podaje minimalnej wersji — zaktualizuj rozszerzenie, jeśli nie widzisz ustawień MCP.
  • Klucz API Prokso. Utwórz go w panelu: „Ustawienia” → „API”. Pełny klucz jest pokazywany tylko raz.

Co potrafi serwer — na stronie Serwer MCP Prokso.

2. Plik cline_mcp_settings.json

W rozszerzeniu kliknij ikonę MCP Servers na górnym pasku Cline, otwórz kartę Configure i na dole — Configure MCP Servers. Otworzy się plik cline_mcp_settings.json; w Cline CLI to ~/.cline/data/settings/cline_mcp_settings.json (inną ścieżkę ustawia zmienna CLINE_MCP_SETTINGS_PATH). Dodaj wpis w mcpServers:

{
  "mcpServers": {
    "prokso": {
      "type": "streamableHttp",
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  • "type": "streamableHttp" — obowiązkowo. Bez tej linii Cline wybiera przestarzały transport SSE, a nasz serwer działa bez SSE.
  • headers — tu przekazuje się klucz. Karta Remote Servers w panelu przyjmuje tylko nazwę, adres i transport, pole nagłówków nie jest tam opisane, dlatego serwer Prokso dodawaj przez JSON.
  • autoApprove — narzędzia, które agent wywołuje bez potwierdzenia. Nasze narzędzia tylko odczytują dane, ale get_plan i get_proxy_lines zwracają dane dostępu do proxy, więc zdecyduj sam.

3. Jak sprawdzić

  1. Zapisz plik: prokso pojawi się na liście serwerów Cline.
  2. Rozwiń serwer — powinno być pięć narzędzi: get_account, get_prices, list_plans, get_plan, get_proxy_lines.
  3. Poproś agenta: „Przez prokso pokaż moje saldo” — i zatwierdź wywołanie get_account. Jeśli serwer nie odpowiada, uruchom go ponownie w ustawieniach MCP.

4. Przykładowe polecenia

  • „Ile transferu zostało w moich planach?”
  • „Daj 5 linii SOCKS5 ze stałymi IP w Polsce dla planu 12”.
  • „Weź 10 linii z nowym adresem przy każdym żądaniu dla planu 12 i dodaj je do zmiennej PROXIES w .env”.
  • „Porównaj pozostały transfer we wszystkich planach i powiedz, w którym jest go najmniej”.

Narzędzia tylko odczytują dane — zakup w panelu lub przez REST API. Porty i 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. Skopiuj nowy klucz i sprawdź, czy stoi po Bearer i jednej spacji.
  • Błędy o SSE lub 405 — we wpisie brakuje "type": "streamableHttp" i Cline łączy się z serwerem złym transportem.
  • 429 — ponad 60 żądań na minutę z jednego klucza. Odczekaj tyle sekund, ile podaje nagłówek Retry-After.
  • Długie żądania są przerywane — w ustawieniach MCP Cline można zwiększyć limit czasu żądania.

Sprawdź klucz bez agenta — w odpowiedzi powinno być 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"}'

Pozostałe kody — na stronie serwera MCP.

6. Bezpieczeństwo klucza

  • Plik cline_mcp_settings.json leży w ustawieniach Cline, a nie w projekcie. Nie kopiuj go do repozytorium i nie udostępniaj: klucz jest w nim otwartym tekstem.
  • Utwórz dla Cline osobny klucz (do 5 na konto), aby w razie potrzeby unieważnić tylko jego.
  • Jeśli klucz mógł trafić w obce ręce, unieważnij go w „Ustawienia” → „API”.

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

Jak korzystać z Prokso