Kontakt
(Poradnik)

Jak przetestować serwer MCPw ChatGPT i Claude

Aktualizacja · 3 min czytania

Serwer, który działa lokalnie, nie zawsze działa w ChatGPT i Claude. Obie aplikacje łączą się z nim ze swojej chmury, logują użytkownika przez OAuth i same wybierają narzędzia. Oto kolejność testów, której używamy przy każdym serwerze, i błędy, które wychodzą w niej najczęściej.

Kolejność testów

  • MCP Inspector na twoim komputerze: protokół, narzędzia, logowanie.
  • Publiczny adres HTTPS przez tunel, bo ChatGPT i claude.ai nie połączą się z localhost.
  • Claude i ChatGPT: czy model wybiera właściwe narzędzia i dobrze rozumie odpowiedzi.
  • Przed zgłoszeniem do katalogów: konto testowe, każde narzędzie w nowej rozmowie, komunikaty błędów.

MCP Inspector

Inspector to oficjalne narzędzie do testowania serwerów MCP. Uruchamiasz go poleceniem „npx @modelcontextprotocol/inspector” i otwierasz w przeglądarce adres, który wypisze, razem z tokenem. Zdalny serwer podajesz z flagami „--server-url https://twoja-domena/mcp --transport http”.

  • Narzędzia, zasoby i prompty: wywołujesz je ręcznie i widzisz dokładnie, co dostaje model, razem z adnotacjami.
  • Logowanie: gdy serwer odpowie 401, Inspector sam przechodzi przepływ OAuth, z rejestracją klienta przez DCR albo CIMD.
  • Interfejs: zakładka Apps wyświetla widoki MCP Apps w piaskownicy.
  • Podgląd surowych wiadomości JSON-RPC, nagłówków HTTP i logów serwera.
  • Tryb „--cli” do skryptów i CI, np. sprawdzenie listy narzędzi po każdym wdrożeniu.

Publiczny adres

ChatGPT i claude.ai łączą się z serwerem ze swojej chmury, więc potrzebny jest publiczny adres HTTPS. Do testów lokalnego serwera wystarczy tunel, np. Cloudflare Tunnel albo ngrok. Konektory Claude łączą się tylko przez IPv4.

Jeśli serwer sprawdza nagłówek Host (robi to np. createMcpExpressApp z SDK dla TypeScriptu), dodaj adres tunelu do dozwolonych hostów. Inaczej dostaniesz błąd 403 „Invalid Host”. ChatGPT ma też Secure MCP Tunnel do podłączenia serwera, który nie jest publiczny.

Claude

  • claude.ai: Customize > Connectors > Add custom connector. Na darmowym planie możesz dodać jeden własny konektor, na Pro i Max więcej.
  • W planach Team i Enterprise konektor dodaje właściciel organizacji, w ustawieniach organizacji.
  • Nazwę i adres konektora można zmienić, ustawień logowania już nie. Żeby je zmienić, usuń konektor i dodaj go ponownie.
  • Claude Code: „claude mcp add --transport http nazwa adres”, a potem polecenie /mcp pokazuje status i pozwala się zalogować.
  • Limity w claude.ai i aplikacji desktopowej: odpowiedź narzędzia do około 150 000 znaków i 240 sekund na jedno wywołanie. Claude Code domyślnie przyjmuje do 25 000 tokenów (zmienna MAX_MCP_OUTPUT_TOKENS).

ChatGPT

  • Na chatgpt.com/plugins wybierz +, potem Add custom MCP server. Podaj adres razem z /mcp, ustaw logowanie i utwórz plugin. W nowej rozmowie wpisz @ i wybierz go z listy.
  • Własne serwery dodaje się w wersji webowej. Pełny dostęp, także do narzędzi zmieniających dane, mają plany Business, Enterprise i Edu (w Business tylko administratorzy i właściciele). Na Pro działają tylko narzędzia do odczytu.
  • Po każdej zmianie wdróż serwer, kliknij Refresh na stronie pluginu i testuj w nowej rozmowie, bo stara pamięta poprzednią listę narzędzi.

Interfejs w rozmowie

ChatGPT i Claude obsługują otwarty standard MCP Apps, więc ten sam widok (karta produktu, koszyk, formularz) zadziała w obu. Testuj dwie rzeczy osobno: widok, który widzi użytkownik, i tekstową odpowiedź, którą czyta model. Widok powinien działać bez błędów w konsoli i odtwarzać swój stan po ponownym otwarciu rozmowy.

Najczęstsze błędy

  • Odpowiedź 401 bez nagłówka WWW-Authenticate wskazującego metadane zasobu (/.well-known/oauth-protected-resource). Bez niego logowanie się nie zacznie.
  • Brak PKCE z metodą S256. Wymagają go ChatGPT i Claude.
  • Przekierowanie na inny host gubi nagłówek Authorization i kończy się błędem 401.
  • Firewall albo CDN blokuje adresy Anthropic. Widzisz wtedy błędy 403, których twoja aplikacja nie wysłała.
  • Endpointy OAuth odpowiadają dłużej niż 10 sekund i połączenie wygasa.
  • Zbyt ścisłe sprawdzanie nagłówka Origin odrzuca zapytania Claude.
  • Narzędzia bez tytułu i adnotacji readOnlyHint albo destructiveHint. Katalog Claude ich nie przyjmie. Pełną listę wymagań opisujemy w checkliście zgłoszenia.
FAQ
Czy do testów w Claude potrzebuję płatnego planu?
Nie. Na darmowym planie możesz dodać jeden własny konektor. Do zgłoszenia w katalogu potrzebny jest już płatny plan.
Serwer działa w Inspectorze, ale nie w claude.ai. Dlaczego?
Najczęściej dlatego, że Inspector łączy się z twojego komputera, a claude.ai z chmury Anthropic. Sprawdź, czy adres jest publiczny i dostępny przez IPv4, czy firewall nie blokuje ruchu i czy serwer akceptuje host tunelu.
Czy testy można zautomatyzować?
Tak. Inspector w trybie „--cli” wywołuje metody takie jak tools/list i tools/call i zwraca JSON, więc nadaje się do CI. To, jak model wybiera narzędzia, i tak trzeba sprawdzić w prawdziwych rozmowach.
Poradniki

Potrzebujesz pomocy z serwerem MCP?

Serwery MCP

ZRÓBMYCOŚ, COZOSTAJE→W GŁOWIE

Napisz do nas