Użyj trybu dewelopera aplikacji z Gemini, aby interaktywnie przetestować serwer Model Context Protocol (MCP), zdiagnozować błędy schematu lub błędy środowiska wykonawczego i ocenić jakość narzędzia przed przesłaniem połączonej aplikacji do sprawdzenia w Połączona konsola Google.
W tym przewodniku znajdziesz te informacje:
- Włącz tryb programisty aplikacji z Gemini w Gemini, utwórz niestandardową aplikację MCP i sprawdź początkowe wykrywanie narzędzi.
- Debuguj nieudane wywołania narzędzi, synchronizuj zaktualizowane schematy i testuj uwierzytelnianie.
- Zasymuluj kontekst środowiska użytkownika i skonfiguruj uwierzytelnianie klienta.
Wprowadzenie do układu obszaru roboczego i kart inspektora znajdziesz w omówieniu trybu dewelopera w aplikacjach z Gemini.
Włączanie trybu dewelopera aplikacji z Gemini
Jeśli przeprowadzasz onboarding serwera MCP w Połączonej konsoli Google, zarejestrowana aplikacja jest już dostępna po włączeniu trybu dewelopera aplikacji z Gemini i możesz pominąć krok 2. Jeśli chcesz przetestować wdrożony punkt końcowy serwera HTTPS MCP bezpośrednio w Gemini przed zarejestrowaniem go w konsoli, wykonaj oba kroki, aby włączyć tryb programisty aplikacji Gemini i połączyć serwer jako niestandardową aplikację MCP.
Krok 1. Włącz tryb programisty aplikacji z Gemini
- Otwórz Gemini w przeglądarce.
- Kliknij Ustawienia > Tryb dewelopera aplikacji z Gemini (lub wejdź bezpośrednio na gemini.google.com/devmode).
(Opcjonalnie) Krok 2. Utwórz i przetestuj niestandardową aplikację MCP
Aby połączyć serwer MCP jako aplikację niestandardową w trybie dewelopera aplikacji z Gemini:
- W oknie Wybierz aplikację kliknij + Utwórz nową.
- W oknie Połącz z serwerem MCP wpisz publiczny punkt końcowy HTTPS serwera w polu URL serwera MCP (upewnij się, że adres URL zaczyna się od
https://, np.https://your-app-link.com/mcp). - Jeśli Twój serwer wymaga wstępnie zarejestrowanych danych uwierzytelniających OAuth, kliknij Ustawienia dodatkowe > Pokaż więcej, aby wpisać Identyfikator klienta i Tajny klucz klienta OAuth, a następnie kliknij Dalej.
- W oknie potwierdzenia dotyczącym bezpieczeństwa i prywatności sprawdź, jak Gemini wchodzi w interakcje z Twoim niestandardowym serwerem MCP:
- Wykonywanie narzędzi: Gemini wykonuje narzędzia serwera MCP, aby aktywować i uruchamiać dostępne funkcje, które pozwolą Ci obsłużyć Twoje prośby.
- Pobieranie i udostępnianie danych: Gemini pobiera zasoby, schematy i kontekst udostępniane przez punkty końcowe serwera MCP i nimi zarządza. Może też udostępniać informacje, do których ma dostęp, na podstawie ustawień Twojego konta Google lub podczas interakcji z innymi połączonymi aplikacjami.
- Zaufanie i rozłączanie: zanim przejdziesz dalej, upewnij się, że ufasz serwerowi MCP, i zapoznaj się z jego polityką prywatności. W każdej chwili możesz odłączyć serwer na stronie Połączone aplikacje lub usunąć jego połączenie na stronie Połączenia na koncie Google.
- Wybierz Rozumiem i akceptuję ryzyko związane z bezpieczeństwem i prywatnością, które wiąże się z połączeniem tej aplikacji niestandardowej. Następnie kliknij Połącz.
- W oknie Zapisz aplikację niestandardową wpisz wyświetlaną nazwę aplikacji niestandardowej, sprawdź, czy narzędzia serwera są widoczne na liście Dostępne działania, i kliknij Połącz.
- W panelu bocznym trybu dewelopera aplikacji z Gemini wybierz kartę Schematy narzędzi, aby sprawdzić informacje o każdym narzędziu w połączonej aplikacji, w tym definicje parametrów, plakietki bezpieczeństwa (Tylko do odczytu, Destrukcyjne, Wymagane uwierzytelnianie), Nieprzetworzony schemat i Struktura odpowiedzi.
- W panelu czatu po lewej stronie wpisz prompty w języku naturalnym lub prompty
@mention(np.@MyApp show my profile) i obserwuj kartę Dziennik zdarzeń, aby zobaczyć, jak działa narzędzie.
Debugowanie wywołań narzędzi
Gdy wywołanie narzędzia nie powiedzie się lub wygeneruje nieoczekiwane argumenty, możesz sprawdzić dane telemetryczne, zaktualizować serwer MCP backendu i przeprowadzić gorące przeładowanie schematu bez czyszczenia historii rozmów.
Aby debugować nieudane wywołanie narzędzia, wykonaj te czynności:
- W panelu po prawej stronie wybierz kartę Dziennik zdarzeń.
- Kliknij nieudane zdarzenie na liście Dane telemetryczne, aby rozwinąć jego szczegóły i sprawdzić ładunek żądania
Tool calloraz odpowiedźTool result:- Błędy połączenia i sieci: sprawdź komunikaty o błędach i opóźnienie, aby upewnić się, że punkt końcowy jest osiągalny.
- Błędy uwierzytelniania: jeśli zdarzenie zwraca
401lub403, sprawdź stan tokena OAuth lub dane uwierzytelniające klienta na karcie Uwierzytelnianie. - Niezgodności w walidacji schematu: jeśli serwer zwraca błąd nieprawidłowych parametrów MCP (
-32602), porównaj wygenerowane przez model argumenty JSON wTool callz typami parametrów, wymaganymi właściwościami i instrukcjami formatowania na karcie Schematy narzędzi. - Wyjątki środowiska wykonawczego serwera: sprawdź kod błędu JSON-RPC i komunikat w
Tool result, aby zdiagnozować wyjątki backendu.
- Aby rozwiązać ten problem, zaktualizuj implementację serwera MCP lub popraw opisy narzędzi i parametrów. Wskazówki dotyczące tworzenia przejrzystych schematów narzędzi i odpowiedzi na błędy znajdziesz w artykule Standardy integracji aplikacji połączonych z MCP.
- Na karcie Schematy narzędzi kliknij Synchronizuj schemat. Gemini ponownie pobiera
tools/listz serwera MCP i aktualizuje definicje aktywnych narzędzi, zachowując bieżący wątek czatu. - Ponów zapytanie. Na karcie Dziennik zdarzeń sprawdź, czy odtworzone wywołanie narzędzia zwraca
200 OKi renderuje oczekiwaną odpowiedź w podglądzie czatu.
Symulowanie kontekstu środowiska i uwierzytelniania
W panelu inspektora możesz przetestować, jak narzędzia MCP reagują na różne lokalizacje użytkowników, strefy czasowe, ustawienia regionalne i metody uwierzytelniania.
Zastąp kontekst środowiska
Aby zasymulować kontekst użytkownika w przypadku narzędzi zależnych od daty, godziny lub lokalizacji:
- W panelu po prawej stronie wybierz kartę Environment (Środowisko).
- W sekcji Data i godzina wybierz Symulowana data i Symulowana godzina, aby przetestować wyrażenia dotyczące czasu względnego (np. „jutro rano” lub „w tę sobotę po południu”).
- W sekcji Ustawienia wybierz Język, aby zasymulować język użytkownika (np.
en-US). - Uruchom testowy prompt w panelu czatu, aby ocenić narzędzie w symulowanym kontekście.
- Aby przywrócić domyślne ustawienia środowiska, kliknij Resetuj.
Konfigurowanie uwierzytelniania klienta
Aby skonfigurować lub zmienić metodę uwierzytelniania używaną podczas sesji w trybie dewelopera w aplikacjach z Gemini:
- W panelu po prawej stronie wybierz kartę Authentication (Uwierzytelnianie).
- W sekcji Konfiguracja uwierzytelniania klienta wybierz jeden z tych trybów uwierzytelniania:
- Dynamiczna rejestracja klienta: używa przepływu OAuth do automatycznego negocjowania danych logowania z serwerem autoryzacji. Więcej informacji znajdziesz w przewodniku po implementacji protokołu OAuth 2.1. W razie potrzeby wpisz punkt końcowy w sekcji Dodaj link do aplikacji niestandardowej.
- Ręczna rejestracja klienta: umożliwia ręczne podanie wstępnie zarejestrowanego identyfikatora klienta i tajnego klucza klienta. Rozwiń Ustawienia zaawansowane, aby skonfigurować dodatkowe zastąpienia przepływu.
- Kliknij Zapisz i poczekaj, aż pojawi się komunikat Zapisano. Następnie uruchom testowy prompt, aby sprawdzić, czy uwierzytelnione narzędzia działają prawidłowo.