Serwer MCP Prokso w Claude Desktop i claude.ai

1. Czego potrzebujesz i który sposób wybrać

• Klucz API Prokso: panel, „Ustawienia” → „API” → „Utwórz klucz”. Sprawdź go przez curl według instrukcji na stronie „Serwer MCP Prokso”.
• Sposób 1 — konektor z nagłówkiem żądania. Działa i w Claude Desktop, i w claude.ai. Sekcja Request headers w oknie dodawania konektora to funkcja beta, dostępna dla ograniczonej liczby organizacji. Jeśli jej nie widzisz, przejdź do sposobu 2.
• Sposób 2 — most mcp-remote. Tylko w aplikacji Claude Desktop. Potrzebny jest Node.js 18 lub nowszy: most działa na twoim komputerze i przekazuje żądania do serwera Prokso z twoim nagłówkiem.

Instrukcja jest zgodna z pomocą Claude o konektorach i z README pakietu mcp-remote według stanu na listopad 2026. Nazwy menu podajemy po angielsku, jak w interfejsie Claude.

2. Sposób 1: konektor z nagłówkiem

1. Otwórz Customize → Connectors i kliknij Add custom connector.
2. W polu adresu serwera wpisz https://prokso.com/api/v1/mcp.
3. W wyborze uwierzytelniania wybierz No sign-in: klucz będzie wysyłany w nagłówku, OAuth nie jest potrzebny.
4. Otwórz Request headers, wybierz nazwę authorization i wpisz wartość Bearer TWÓJ_KLUCZ — dokładnie tak, ze słowem Bearer i spacją: Claude wysyła wartość bez zmian. Oznacz nagłówek jako wymagany (Required).
5. Kliknij Add.

Nagłówka nie można zmienić po zapisaniu: aby użyć nowego klucza, usuń konektor i dodaj go ponownie. W planach Team i Enterprise konektor dodaje właściciel organizacji, a nagłówek jest wtedy wspólny dla wszystkich członków — wszyscy będą widzieć plany jednego konta Prokso. Do osobistego klucza lepiej pasuje sposób 2 lub Claude Code.

3. Sposób 2: most mcp-remote w Claude Desktop

W Claude Desktop otwórz menu Claude → Settings (menu aplikacji, a nie ustawienia konta), kartę Developer i kliknij Edit Config. Otworzy się plik konfiguracji:

Dodaj serwer Prokso (jeśli w pliku są już inne serwery, dopisz blok prokso wewnątrz mcpServers):

{
  "mcpServers": {
    "prokso": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://prokso.com/api/v1/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer TWÓJ_KLUCZ"
      }
    }
  }
}

Klucz trafia do zmiennej AUTH_HEADER, a w argumencie po dwukropku nie ma spacji. Tak zaleca README mcp-remote: Claude Desktop w Windows niepoprawnie przekazuje spacje wewnątrz args. Opcja --transport http-only mówi mostowi, by nie próbował przestarzałego SSE. Zapisz plik, całkowicie zamknij Claude Desktop i uruchom ponownie.

4. Sprawdzenie

W polu wiadomości kliknij przycisk + („Add files, connectors, and more”), najedź na Connectors i otwórz Manage connectors. Wybierz prokso — powinno być pięć narzędzi: get_account, get_prices, list_plans, get_plan, get_proxy_lines. Tam też włączysz lub wyłączysz konektor dla pojedynczej rozmowy.

Pierwsze prośby:

• „Ile transferu zostało w moich planach Prokso?”
• „Daj 5 ciągów SOCKS5 ze stałymi IP w Polsce dla planu 12.”
• „Pokaż host i porty mojego planu i wyjaśnij, do czego służy każdy port.”

Przed wywołaniem narzędzia Claude prosi o zgodę. „Always allow” wybieraj tylko wtedy, gdy masz pewność co do konfiguracji.

5. Jeśli nie działa

• Brak sekcji Request headers — twoja organizacja nie ma jeszcze dostępu do bety. Użyj sposobu 2 lub Claude Code.
• Konektor prosi o logowanie lub pokazuje błąd uwierzytelniania — wybrano logowanie przez OAuth albo nagłówek nie ma Bearer. Usuń konektor i dodaj go ponownie z No sign-in.
• Serwer ze sposobu 2 się nie pojawia — sprawdź składnię JSON, Node.js 18+ (node --version) i logi: w macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log, w Windows — folder %APPDATA%\Claude\logs.
• W logu 401 — klucz jest błędny lub unieważniony; 429 — przekroczono limit 60 żądań na minutę.

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

6. Bezpieczeństwo klucza

W sposobie 2 klucz leży w claude_desktop_config.json otwartym tekstem: nie przesyłaj tego pliku i nie synchronizuj go w miejsca publiczne. W sposobie 1 Claude przechowuje wartość nagłówka i więcej jej nie pokazuje. Utwórz dla Claude osobny klucz i w razie wątpliwości unieważnij go w „Ustawienia” → „API”. Agent nie może kupować transferu przez MCP — do tego służy panel i REST API; konfiguracja proxy w programach jest w dziale „Instrukcje”, porty — w przewodniku po bramce.

MCP w Cursor →Jak korzystać z Prokso