Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Im Entwicklermodus für Gemini-Apps testen, Fehler beheben und bewerten

Im Entwicklermodus von Gemini-Apps können Sie Ihren MCP-Server (Model Context Protocol) interaktiv testen, Schema- oder Laufzeitfehler diagnostizieren und die Toolqualität bewerten, bevor Sie Ihre verbundene App zur Überprüfung in der Google Connected Console einreichen.

In diesem Leitfaden werden die folgenden Aufgaben behandelt:

Entwicklermodus für Gemini-Apps in Gemini aktivieren, eine benutzerdefinierte MCP-App erstellen und die erste Toolerkennung prüfen.
Fehlerhafte Toolaufrufe debuggen, aktualisierte Schemas synchronisieren und die Authentifizierung testen.
Nutzerumgebungskontext simulieren und Clientauthentifizierung konfigurieren

Eine Einführung in das Layout des Arbeitsbereichs und die Tabs des Prüfers finden Sie in der Übersicht über den Entwicklermodus für Gemini-Apps.

Entwicklermodus für Gemini-Apps aktivieren

Wenn Sie Ihren MCP-Server in der Google Connected Console einrichten, ist Ihre registrierte App bereits verfügbar, wenn Sie den Gemini-Apps-Entwicklermodus aktivieren. Sie können Schritt 2 dann überspringen. Wenn Sie einen bereitgestellten HTTPS-MCP-Serverendpunkt direkt in Gemini testen möchten, bevor Sie ihn in der Konsole registrieren, führen Sie beide Schritte aus, um den Entwicklermodus für Gemini-Apps zu aktivieren und Ihren Server als benutzerdefinierte MCP-App zu verbinden.

Schritt 1: Entwicklermodus für Gemini-Apps aktivieren

Öffnen Sie Gemini in Ihrem Webbrowser.
Klicken Sie auf Einstellungen > Gemini-Apps-Entwicklermodus oder rufen Sie direkt gemini.google.com/devmode auf.

(Optional) Schritt 2: Benutzerdefinierte MCP-Anwendung erstellen und testen

So verbinden Sie Ihren MCP-Server als benutzerdefinierte App im Entwicklermodus von Gemini-Apps:

Klicken Sie im Dialogfeld Anwendung auswählen auf + Neu erstellen.
Geben Sie im Dialogfeld Mit einem MCP-Server verbinden den öffentlichen HTTPS-Endpunkt Ihres Servers unter MCP-Server-URL ein. Die URL muss mit https:// beginnen, z. B. https://your-app-link.com/mcp.
Wenn Ihr Server vorregistrierte OAuth-Anmeldedaten erfordert, klicken Sie auf Zusätzliche Einstellungen > Mehr anzeigen, um Ihre OAuth-Client-ID und Ihren Clientschlüssel einzugeben. Klicken Sie dann auf Weiter.
Prüfen Sie im Bestätigungsdialogfeld für Sicherheit und Datenschutz, wie Gemini mit Ihrem benutzerdefinierten MCP-Server interagiert:
- Toolausführung: Gemini führt die Tools Ihres MCP-Servers aus, um verfügbare Funktionen auszulösen und auszuführen, damit Ihre Anfragen bearbeitet werden können.
- Datenabruf und ‑weitergabe: Gemini ruft Ressourcen, Schemas und Kontexte ab, die von den Endpunkten Ihres MCP-Servers bereitgestellt werden, und verwaltet diese. Gemini kann Informationen, auf die es Zugriff hat, gemäß Ihren Google-Kontoeinstellungen oder bei der Interaktion mit anderen verbundenen Apps weitergeben.
- Vertrauen und Trennung: Du solltest nur dann fortfahren, wenn du dem MCP-Server vertraust. Lies dir vorher die Datenschutzerklärung durch. Sie können die Verbindung zum Server jederzeit auf der Seite „Verbundene Apps“ trennen oder die Verknüpfung in Ihren Google-Kontoverbindungen löschen.
Wählen Sie Ich verstehe und akzeptiere die Sicherheits- und Datenschutzrisiken, die mit der Verbindung dieser benutzerdefinierten App einhergehen. aus und klicken Sie dann auf Verbinden.
Geben Sie im Dialogfeld Benutzerdefinierte App speichern einen Anzeigenamen für Ihre benutzerdefinierte App ein, prüfen Sie, ob die Tools Ihres Servers in der Liste Verfügbare Aktionen angezeigt werden, und klicken Sie auf Verbinden.
Wählen Sie in der Seitenleiste des Entwicklermodus für Gemini-Apps den Tab Tool-Schemas aus, um Informationen zu jedem Tool in Ihrer verbundenen App zu sehen, einschließlich Parameterdefinitionen, Sicherheits-Badges (Schreibgeschützt, Destruktiv, Authentifizierung erforderlich), Rohschema und Antwortstruktur.
Geben Sie im linken Chatbereich Prompts in natürlicher Sprache oder @mention-Prompts ein (z. B. @MyApp show my profile) und beobachten Sie den Tab Ereignisprotokoll, um zu sehen, wie Ihr Tool funktioniert.

Toolaufrufe debuggen

Wenn ein Toolaufruf fehlschlägt oder unerwartete Argumente erzeugt, können Sie die Diagnosetelemetrie prüfen, Ihren Backend-MCP-Server aktualisieren und das Schema im laufenden Betrieb neu laden, ohne den Unterhaltungsverlauf zu löschen.

So debuggen Sie einen fehlgeschlagenen Toolaufruf:

Wählen Sie im rechten Bereich den Tab Ereignisprotokoll aus.
Klicken Sie in der Liste Telemetrie auf das fehlgeschlagene Ereignis, um die Details zu maximieren und die Tool call-Anfragenutzlast und die Tool result-Antwort zu prüfen:
- Verbindungs- und Netzwerkfehler: Prüfen Sie die Fehlermeldungen und die Latenz, um festzustellen, ob Ihr Endpunkt erreichbar ist.
- Authentifizierungsfehler: Wenn das Ereignis 401 oder 403 zurückgibt, prüfen Sie den Status Ihres OAuth-Tokens oder die Clientanmeldedaten auf dem Tab Authentifizierung.
- Fehler bei der Schemavalidierung: Wenn der Server einen MCP-Fehler „Ungültige Parameter“ (-32602) zurückgibt, vergleichen Sie die vom Modell generierten JSON-Argumente in Tool call mit den Parametertypen, erforderlichen Attributen und Formatanweisungen auf dem Tab Tool-Schemas.
- Serverlaufzeitausnahmen: Prüfen Sie den JSON-RPC-Fehlercode und die Fehlermeldung in Tool result, um Backend-Ausnahmen zu diagnostizieren.
Aktualisieren Sie Ihre MCP-Serverimplementierung oder verfeinern Sie die Beschreibungen der Tools und Parameter, um das Problem zu beheben. Anleitungen zum Schreiben klarer Toolschemas und Fehlerantworten finden Sie unter Integrationsstandards für MCP-verbundene Anwendungen.
Klicken Sie auf dem Tab Tool-Schemas auf Schema synchronisieren. Gemini ruft tools/list noch einmal von Ihrem MCP-Server ab und aktualisiert die aktiven Tooldefinitionen, während der aktuelle Chat-Thread beibehalten wird.
Wiederholen Sie Ihre Abfrage. Prüfen Sie auf dem Tab Ereignisprotokoll, ob der wiederholte Toolaufruf 200 OK zurückgibt und die erwartete Antwort in der Chatvorschau rendert.

Umgebungskontext und Authentifizierung simulieren

Sie können direkt im Prüfbereich testen, wie Ihre MCP-Tools auf verschiedene Nutzerstandorte, Zeitzonen, Sprachen und Authentifizierungsmethoden reagieren.

Umgebungskontext überschreiben

So simulieren Sie den Nutzerkontext für Tools, die von Datum, Uhrzeit oder Sprache abhängig sind:

Wählen Sie im rechten Bereich den Tab Umgebung aus.
Wählen Sie unter Datum und Uhrzeit ein Simuliertes Datum und eine Simulierte Uhrzeit aus, um relative Zeitangaben wie „morgen früh“ oder „diesen Samstagnachmittag“ zu testen.
Wählen Sie unter Einstellungen eine Sprache aus, um die Sprache des Nutzers zu simulieren (z. B. en-US).
Führen Sie im Chatbereich einen Testprompt aus, um Ihr Tool mit dem simulierten Kontext zu bewerten.
Wenn Sie die Standardeinstellungen der Umgebung wiederherstellen möchten, klicken Sie auf Zurücksetzen.

Clientauthentifizierung konfigurieren

So konfigurieren oder wechseln Sie die Authentifizierungsmethode, die während Ihrer Gemini-Apps-Entwicklermodus-Sitzung verwendet wird:

Wählen Sie im rechten Bereich den Tab Authentifizierung aus.
Wählen Sie unter Konfiguration der Clientauthentifizierung einen der folgenden Authentifizierungsmodi aus:
- Dynamische Clientregistrierung: Verwendet einen OAuth-Ablauf, um Anmeldedaten automatisch mit Ihrem Autorisierungsserver auszuhandeln. Weitere Informationen finden Sie im Implementierungsleitfaden für OAuth 2.1. Geben Sie gegebenenfalls Ihren Endpunkt unter Benutzerdefinierten App-Link hinzufügen ein.
- Manuelle Clientregistrierung: Hier können Sie eine vorregistrierte Client-ID und einen Clientschlüssel manuell angeben. Maximieren Sie Erweiterte Einstellungen, um zusätzliche Ablaufüberschreibungen zu konfigurieren.
Klicken Sie auf Speichern und warten Sie, bis die Meldung Gespeichert angezeigt wird. Führen Sie dann einen Test-Prompt aus, um zu prüfen, ob die authentifizierten Tools erfolgreich sind.