Rozwiązywanie problemów z rejestracją

Jeśli podczas rejestrowania lub konfigurowania połączonej aplikacji wystąpią problemy, zapoznaj się z poniższą tabelą zawierającą typowe komunikaty o błędach, przyczyny i czynności, które możesz wykonać, aby rozwiązać problem.

Problem	Komunikat o błędzie	Przyczyna	Rozwiązanie problemu / instrukcje rozwiązywania problemów
Nieokreślony błąd „Narzędzi do pobierania”	„Nie udało się pobrać szczegółów serwera MCP. Spróbuj ponownie”. (lub przycisk Pobierz narzędzia nie działa i nie wyświetla się komunikat o konkretnym błędzie).	Połączona konsola nie mogła zrealizować żądania wysłanego do punktu końcowego MCP z powodu nieprawidłowego adresu URL, serwera offline lub błędu sieci.	Potwierdź te informacje: Sprawdź, czy adres URL punktu końcowego MCP jest prawidłowy i używa https://. Sprawdź, czy serwer MCP działa. Sprawdź, czy serwer MCP jest dostępny z publicznego internetu (Google nie może uzyskać dostępu do adresu localhost ani prywatnych adresów intranetowych).
Serwer MCP jest nieosiągalny	„Serwer MCP jest nieosiągalny”	Backend Google nie mógł nawiązać połączenia z Twoim punktem końcowym MCP.	Oto najczęstsze przyczyny i sposoby ich rozwiązania: Ograniczenia zapory sieciowej: upewnij się, że zapora sieciowa lub WAF nie blokuje wychodzących zakresów adresów IP Google. Reguły bramy interfejsów API: sprawdź, czy brama interfejsów API akceptuje żądania POST i nie odrzuca żądań clientInfo Google podczas uzgadniania połączenia MCP initialize. Niezgodność subdomeny: jeśli używasz dedykowanej subdomeny (np. gemini.mcp.company.com), upewnij się, że jej metadane /.well-known/oauth-protected-resource pasują do tej subdomeny, a nie wskazują inną domenę podstawową (mcp.company.com).
Nieobsługiwany transport MCP (HTTP 405)	„Serwer MCP odrzucił żądanie (HTTP 405 – metoda niedozwolona). Upewnij się, że adres URL wskazuje punkt końcowy HTTP Streamable, który akceptuje żądania POST, a nie starszy punkt końcowy SSE.	Adres URL punktu końcowego wskazuje starszy punkt końcowy HTTP+SSE, który akceptuje tylko żądania GET lub odrzuca żądania JSON-RPC POST.	Zaktualizuj serwer MCP i adres URL punktu końcowego, aby używać transportu HTTP Streamable MCP, który akceptuje żądania POST dla initialize i tools/list.
Brak pliku zasobu chronionego przez OAuth	„Plik /.well-known/oauth-protected-resource nie istnieje na serwerze MCP”	Google podjęło próbę wykrycia metadanych zasobów chronionych przez OAuth 2.0 (RFC 9728), która się nie powiodła.	Jeśli serwer MCP NIE wymaga uwierzytelniania: ten błąd zwykle występuje, gdy adres URL punktu końcowego MCP zawiera literówkę lub brakujący segment ścieżki (np. https://mcp.example.com zamiast https://mcp.example.com/mcp) i zwraca błąd HTTP 404 lub 500, co powoduje, że klient wraca do wykrywania OAuth. Sprawdź, czy dokładna ścieżka punktu końcowego MCP zwraca HTTP 200 OK w przypadku nieuwierzytelnionych żądań POST initialize i tools/list, a następnie w sekcji Dane logowania wybierz Nie w odpowiedzi na pytanie Czy serwer wymaga autoryzacji?. Jeśli serwer MCP wymaga uwierzytelniania: umieść na serwerze MCP prawidłowy plik JSON /.well-known/oauth-protected-resource, który w tablicy authorization_servers będzie zawierać informacje o zaufanych serwerach autoryzacji.
Brakujące lub nieprawidłowe metadane serwera autoryzacji OAuth	„Plik /.well-known/oauth-authorization-server nie istnieje na serwerze OAuth” lub „zawiera nieprawidłowy lub niekompletny kod JSON”	Twój serwer OAuth nie udostępnia prawidłowego dokumentu metadanych RFC 8414 pod adresem /.well-known/oauth-authorization-server.	Umieść prawidłowy dokument opisujący RFC 8414 w /.well-known/oauth-authorization-server (lub /.well-known/openid-configuration) zawierający authorization_endpoint i token_endpoint. Możesz też w sekcji Dane logowania ręcznie wpisać adresy URL niestandardowego punktu końcowego autoryzacji i niestandardowego punktu końcowego tokena.
Niepowodzenie weryfikacji domeny	Certyfikat domeny wyświetla komunikat „Nie udało się zweryfikować” lub „Weryfikacja nie powiodła się” z informacją w dymku (np. HTTP 404, przekierowanie niedozwolone lub niezgodność tokena).	Nie udało nam się zweryfikować Twojego tokena wyzwania na stronie https://<domain>/.well-known/google-connected-apps.	Nie znaleziono pliku (HTTP 404): upewnij się, że pobrane treści google-connected-apps.json są opublikowane pod adresem https://<domain>/.well-known/google-connected-apps (bez rozszerzenia .json w ścieżce adresu URL). Przekierowania są niedozwolone: dane weryfikacyjne należy przesyłać bezpośrednio za pomocą HTTP 200 OK. Nie przekierowuj /.well-known/google-connected-apps na inny adres URL. Niezgodność tokena: sprawdź, czy odpowiedź JSON zawiera "verification_tokens": ["<YOUR_TOKEN>"] z dokładnym tokenem wygenerowanym dla Twojego konta dewelopera.
Błąd dynamicznej rejestracji klientów (DCR) lub CIMD	„Nie udało się przeprowadzić dynamicznej rejestracji klienta (RFC 7591)”, „Serwer OAuth nie obsługuje dynamicznej rejestracji klientów (RFC 7591)” lub „Nie udało się zarejestrować dokumentu metadanych identyfikatora klienta (CIMD)”	Automatyczna rejestracja klienta OAuth nie powiodła się lub nie jest obsługiwana przez dostawcę OAuth albo identyfikatory URI przekierowania Google zostały odrzucone.	Upewnij się, że serwer OAuth zezwala na wszystkie 6 adresów URL przekierowania Google powiązanych z aplikacją, które są widoczne w sekcji Dane uwierzytelniające serwera (https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain> itd.). Pamiętaj, że wiele serwerów OAuth 2.1 odrzuca identyfikatory URI przekierowania z symbolami wieloznacznymi (*). Jeśli Twój dostawca OAuth nie obsługuje CIMD ani RFC 7591 DCR, w sekcji Dane logowania wybierz Zarejestrowane wstępnie (w przypadku protokołu OAuth delegowanego przez użytkownika) lub Między maszynami (dane logowania klienta OAuth) i podaj statyczny identyfikator klienta i tajny klucz klienta.
Wyskakujące okienko logowania OAuth jest zablokowane lub puste	„Wyskakujące okienko uwierzytelniania zostało zablokowane przez przeglądarkę” lub okno logowania OAuth nie wyświetla się prawidłowo podczas synchronizacji lub testowania narzędzia.	Blokowanie wyskakujących okienek w przeglądarce lub rygorystyczne nagłówki X-Frame-Options / Content-Security-Policy na stronie logowania uniemożliwiły wyświetlenie wyskakującego okienka.	Zezwól na wyskakujące okienka konsoli w przeglądarce i spróbuj ponownie. W sekcji Dane logowania w obszarze Uwierzytelnij się za pomocą danych logowania dewelopera przełącz opcję Uwierzytelnij przez wyskakujące okienko na Uwierzytelnij przez przekierowanie (metoda alternatywna), aby proces uwierzytelniania otwierał się na pełnym ekranie w tej samej karcie.
Brak instrukcji serwera MCP	Komunikat ostrzegawczy: „Serwer MCP nie ma instrukcji. Zalecamy dodanie instrukcji do schematu serwera.	Serwer MCP nie zwrócił pola instructions w odpowiedzi initialize.	Podczas inicjowania serwera MCP (parametr instructions w definicji serwera) wyraźnie określ instrukcje systemowe. W przypadku bezstanowych lub niestandardowych implementacji HTTP upewnij się, że pole instructions jest uwzględnione w ładunku odpowiedzi JSON-RPC dla metody initialize, a następnie wybierz Ponownie zsynchronizuj narzędzia.
Przekroczony limit rozmiaru zasobu interfejsu lub nieobsługiwany typ MIME	Karta błędu Problemy z pobieraniem: „Łączny rozmiar zasobów nie może przekraczać 100 MB” lub „Nieobsługiwany typ MIME „<type>” zasobu „<uri>””.	Serwer MCP zwrócił zasoby interfejsu, których łączny rozmiar przekracza limit lub które używają nieobsługiwanego typu MIME.	Zmniejsz łączny rozmiar wszystkich zasobów interfejsu manifestu zwracanych przez serwer, aby nie przekraczał limitu. Upewnij się, że wszystkie zasoby interfejsu korzystają z jednego z obsługiwanych typów MIME: text/html, text/html;profile=mcp-app, text/javascript lub text/css.
Przesyłanie ikony zatrzymało się lub wystąpił „Nieoczekiwany błąd”	Podczas przesyłania ikony aplikacji w sekcji Szczegóły aplikacji proces zatrzymuje się na wskaźniku postępu lub pojawia się komunikat „Wystąpił nieoczekiwany błąd. Spróbuj ponownie” (często z kodem 4E696748).	Zwykle jest to spowodowane nieaktualną sesją przeglądarki, konfliktami rozszerzeń przeglądarki lub stanem uwierzytelniania zapisanym w pamięci podręcznej.	Wykonaj te czynności w podanej kolejności: Użyj nowego profilu przeglądarki: otwórz nowe okno, używając czystego profilu przeglądarki. Użyj trybu incognito lub prywatnego: zaloguj się w Google Connected Console w oknie przeglądania prywatnego i prześlij ikonę. Wyczyść pamięć podręczną: przed ponowną próbą wyczyść pamięć podręczną przeglądarki i usuń pliki cookie. Sprawdź, czy ikona jest prawidłowym plikiem PNG lub JPEG o wymiarach 512 × 512 pikseli i rozmiarze poniżej 1 MB.