URL serwera, transport i przepływ OAuth dla Cursor, MCP Inspector i innych klientów MCP – ze wszystkimi adresami discovery dla programistów.
Oprócz Claude i ChatGPT zadziała każdy klient MCP, który obsługuje zdalne serwery przez HTTP i logowanie OAuth – na przykład IDE takie jak Cursor albo MCP Inspector do testów. Ten artykuł jest dla osób, które samodzielnie konfigurują taki klient lub budują własną integrację.
Najważniejsze dane
- URL serwera
- https://dock.at-harbor.com/mcp
- Transport
- Streamable HTTP, bezstanowy. Każde żądanie to POST z wiadomością JSON-RPC (lub paczką wiadomości), a odpowiedź wraca jako JSON. Nie ma ID sesji ani strumienia z serwera.
- Wersje protokołu
- 2025-11-25, 2025-06-18 i 2025-03-26
- Metody
- initialize, ping, tools/list i tools/call. Serwer nie oferuje zasobów (resources) ani promptów (prompts).
- Logowanie
- OAuth 2.1 z PKCE (S256). Bez tokenu serwer odpowiada kodem 401 i w nagłówku WWW-Authenticate wskazuje swoje metadane.
Konfiguracja klienta
- W swoim kliencie dodaj zdalny serwer MCP (często nazywany „Remote”, „HTTP” lub „Streamable HTTP”)
- Wpisz https://dock.at-harbor.com/mcp jako URL
- Zostaw puste client ID i secret – klient sam się rejestruje
- Rozpocznij łączenie; w przeglądarce otworzy się logowanie, a potem strona zgody LinkHarbor
- Wybierz workspace i uprawnienia i kliknij „Zezwól”
Nazwa tego ustawienia różni się w zależności od programu. W MCP Inspector wybierasz na przykład transport „Streamable HTTP”.
Przepływ OAuth w szczegółach
- Klient wywołuje serwer MCP bez tokenu i dostaje 401 ze wskazaniem na metadane zasobu
- Odczytuje metadane serwera autoryzacji (endpointy, obsługiwane metody, uprawnienia)
- Rejestruje się: przez Dynamic Client Registration albo dokumentem metadanych klienta pod adresem https
- Otwiera przeglądarkę z żądaniem autoryzacji, łącznie z PKCE i resource=https://dock.at-harbor.com/mcp
- Logujesz się i podejmujesz decyzję na stronie zgody
- Klient wymienia kod na token dostępu i token odświeżania
| Krok | Ważność |
|---|---|
| Żądanie logowania do Twojej decyzji | 10 minut |
| Kod autoryzacji | 60 sekund, jednorazowy |
| Token dostępu | 1 godzina |
| Token odświeżania | Odnawiany przy każdym użyciu; wygasa po 90 dniach bez użycia |
Jeśli klient nie żąda żadnych uprawnień, żądane są wszystkie; na stronie zgody nadal możesz je zawęzić. Jeśli token odświeżania, który został już zastąpiony, zostanie użyty ponownie, LinkHarbor ze względów bezpieczeństwa kończy całe połączenie.
Zasady dla adresów przekierowania
- Adresy https
- http tylko dla adresów loopback na Twoim własnym komputerze (dla klientów desktopowych i IDE)
- Własne schematy aplikacji w odwróconej notacji domenowej
- Najwyżej 10 adresów na klienta, bez fragmentów
Jeśli aplikacja prześle adres, który nie jest dla niej zarejestrowany, LinkHarbor przerywa: „Aplikacja przesłała adres powrotu, który nie jest dla niej zarejestrowany. Żądanie zostało zatrzymane.”
Adresy discovery dla programistów
| Dokument | Adres |
|---|---|
| Metadane zasobu (RFC 9728) | https://dock.at-harbor.com/.well-known/oauth-protected-resource/mcp |
| Serwer autoryzacji (RFC 8414) | https://dock.at-harbor.com/.well-known/oauth-authorization-server |
| Unieważnianie tokenów (RFC 7009) | https://dock.at-harbor.com/oauth/revoke |
| MCP Server Card | https://dock.at-harbor.com/.well-known/mcp/server-card.json |
| Instrukcje dla agentów | https://dock.at-harbor.com/auth.md |
Nieznane aplikacje
Aplikacje, których wszystkie adresy przekierowania są na claude.ai, claude.com, chatgpt.com lub openai.com, uchodzą za znane. Programy na Twoim komputerze, które wracają przez localhost – na przykład Claude Code, Codex i IDE – pokazują na stronie zgody wskazówkę „LinkHarbor nie zna tej aplikacji. Działa ona na Twoim komputerze. Kontynuuj tylko, jeśli przed chwilą sam(a) ją uruchomiłeś(-łaś)”, a na dole „Po wyborze wrócisz do aplikacji na swoim komputerze”. Pozostałe nieznane aplikacje webowe pokazują „LinkHarbor nie zna tej aplikacji. Kontynuuj tylko, jeśli sam(a) to rozpocząłeś(-ęłaś) i ufasz …”, gdzie w miejscu wielokropka stoi ich adres. Obie wskazówki są normalne, jeśli właśnie samodzielnie skonfigurowano klienta. Logo pojawia się tylko wtedy, gdy aplikacja je przesyła. Jeśli logowanie nie zostało rozpoczęte przez Ciebie, kliknij „Odrzuć”.
Może Ci się też przydać
Nic nie znaleziono?
Napisz, czego potrzebujesz, a nasz zespół pomocy technicznej pomoże Ci osobiście.