$
Zaloguj sięRejestracja

Serwer MCP Prokso w Zed

Zed obsługuje zdalne serwery MCP: w ustawieniach podaje się adres i nagłówki, więc klucz API Prokso jest przekazywany tak samo jak w REST API — w nagłówku Authorization.

1. Czego potrzebujesz

  • Zed z panelem agenta (Agent Panel). Dokumentacja Zed nie podaje minimalnej wersji dla zdalnych serwerów, więc zaktualizuj edytor do świeżej wersji.
  • Klucz API Prokso. Utwórz go w panelu: „Ustawienia” → „API”. Pełny klucz jest pokazywany tylko raz.

Lista narzędzi i to, co zwracają — na stronie Serwer MCP Prokso.

2. Blok context_servers

Otwórz Settings → AI → MCP Servers albo wykonaj akcję zed: open settings file i dodaj:

{
  "context_servers": {
    "prokso": {
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ"
      }
    }
  }
}

Jeśli w pliku są już inne ustawienia, wklej tylko blok context_servers do środka istniejących nawiasów klamrowych. Nazwa prokso jest dowolna: tak serwer jest podpisany na liście i w regułach uprawnień.

Nagłówek Authorization jest obowiązkowy. Bez niego Zed zaproponuje logowanie przez OAuth, a nasz serwer nie ma OAuth — logowanie tylko kluczem. Dokumentacja Zed nie opisuje podstawiania zmiennych środowiskowych w nagłówkach, dlatego klucz wpisuje się jako tekst.

3. Jak sprawdzić

  1. Otwórz Settings → AI → MCP Servers: obok prokso powinien świecić zielony wskaźnik z podpowiedzią „Server is active”. Inny kolor oznacza problem — podpowiedź powie jaki.
  2. W panelu agenta napisz: „Przez prokso pokaż moje saldo”. Wspomnienie serwera z nazwy skłania agenta do użycia jego narzędzi: get_account, get_prices, list_plans, get_plan, get_proxy_lines.
  3. Domyślnie Zed pyta o zgodę przed każdym wywołaniem narzędzia (agent.tool_permissions.default z wartością "confirm"). Pojedyncze narzędzia można zezwolić regułami w rodzaju mcp:prokso:list_plans.

4. Przykładowe polecenia

  • „Ile transferu zostało w moich planach?”
  • „Daj 5 linii SOCKS5 ze stałymi IP w Polsce dla planu 12”.
  • „Pokaż host i porty planu 12 i napisz przykład połączenia dla requests w Pythonie”.
  • „Daj 20 linii z nowym adresem przy każdym żądaniu z USA, stan Teksas, dla planu 12”.

Ostatnie polecenie używa dokładnego geo: taki transfer liczy się podwójnie, a dostępności adresów w konkretnym stanie czy mieście nie gwarantujemy. Wszystkie porty i parametry — w przewodniku po bramce. Narzędzia tylko odczytują dane — zakup w panelu lub przez REST API.

5. Jeśli nie działa

  • Zed otwiera logowanie w przeglądarce — nagłówek nie został zastosowany. Sprawdź zagnieżdżenie: headers musi być wewnątrz prokso, obok url.
  • 401 — klucz jest błędny lub unieważniony; sprawdź, czy po Bearer jest dokładnie jedna spacja.
  • 429 — ponad 60 żądań na minutę z jednego klucza. Odczekaj tyle sekund, ile podaje nagłówek Retry-After.

Sprawdź serwer bez edytora — 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"}'

Inne błędy serwera — na stronie serwera MCP.

6. Bezpieczeństwo klucza

  • Klucz leży w pliku ustawień otwartym tekstem. Plik jest osobisty, ale jeśli trzymasz ustawienia w gicie (dotfiles), klucz tam trafi — wydziel blok albo wyklucz plik.
  • Utwórz dla Zed osobny klucz (do 5 na konto), aby unieważnić tylko jego.
  • Jeśli klucz mógł trafić w obce ręce, unieważnij go w „Ustawienia” → „API” i utwórz nowy.

Konfiguracja proxy w programach — w dziale „Instrukcje”, diagnostyka linii — krok po kroku.

MCP w Cline →Jak korzystać z Prokso