Skip to main content
Gemini CLI kann den entfernten MCP-Endpunkt Ihres Novaplan AI Workspaces per OAuth anbinden. Sie benötigen eine Novaplan-OAuth-Anwendung mit Client ID und gegebenenfalls Client Secret. Die Voraussetzungen stehen im MCP-Überblick.

​
Einstellungen hinterlegen

Bearbeiten Sie ~/.gemini/settings.json und ersetzen Sie die Platzhalter:
Der lokale Servername novaplan kann frei gewählt werden; verwenden Sie ihn dann auch in den CLI-Befehlen. httpUrl wählt Streamable HTTP. Mit url würde Gemini CLI dagegen SSE verwenden, was für den Novaplan-Endpunkt /mcp nicht passt. Passen Sie die Scopes an die benötigten Werkzeuge und Berechtigungen Ihrer OAuth-Anwendung an. Setzen Sie NOVAPLAN_CLIENT_SECRET in Ihrer geschützten lokalen Umgebung, bevor Sie Gemini CLI starten. Gemini ersetzt $NOVAPLAN_CLIENT_SECRET beim Lesen der Einstellungen durch dessen Wert; das eigentliche Secret gehört nicht in eine geteilte oder eingecheckte Datei. Gemini CLI kann die Autorisierungs- und Token-Endpunkte über die Metadaten von Novaplan AI erkennen. Alternativ können Sie zuerst gemini mcp add --scope user --transport http novaplan NOVAPLAN_WORKSPACE_URL/mcp ausführen und danach den oauth-Block in ~/.gemini/settings.json ergänzen. Ohne --scope user legt der CLI-Befehl den Eintrag standardmäßig im Projekt ab.

​
Anmelden und prüfen

Registrieren Sie in der Novaplan-OAuth-Anwendung die Redirect-URI http://localhost:7777/oauth/callback, die im Beispiel ausdrücklich mit redirectUri festgelegt ist. Ohne diese Einstellung wählt Gemini CLI einen zufälligen lokalen Port. Öffnen Sie Gemini CLI und führen Sie /mcp auth novaplan aus. Ein Browserfenster führt Sie zur persönlichen Novaplan-Anmeldung. Mit gemini mcp list prüfen Sie anschließend die konfigurierte Verbindung. Das OAuth-Verfahren benötigt einen lokalen Browser. In einer Umgebung ohne Browser oder bei einer entfernten SSH-Sitzung muss die Anmeldung gesondert ermöglicht werden. Bewahren Sie ein Client Secret außerhalb eines gemeinsam genutzten oder eingecheckten Konfigurationsfiles auf.
Aktuelle Gemini-CLI-Versionen prüfen bei bekanntem OAuth-Issuer den Parameter iss in der Rückleitung. Wenn die Anmeldung mit Missing issuer parameter in response scheitert, wenden Sie sich an Novaplan Support. Deaktivieren Sie die Issuer-Prüfung nicht. Die Kompatibilität muss mit dem bereitgestellten Enterprise-OAuth-Server getestet werden.