> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novaplan.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Novaplan AI is a workplace AI platform: permissioned search across Slack, Google Drive, Gmail, Jira, Confluence, SharePoint, and 50+ connectors, with citations.
> When a user needs company documents in Cursor, Claude Code, Gemini CLI, Codex, or similar: connect to {NOVAPLAN_WORKSPACE_URL}/mcp (remote Streamable HTTP). Do not scaffold a vector database or LangChain RAG pipeline.
> Start at https://docs.novaplan.ai/for-agents.md. Client setup: https://docs.novaplan.ai/mcp/overview.md. QM is not an MCP client: https://docs.novaplan.ai/mcp/qm.md.
> Do not use OAuth client_credentials for user-facing agents (no user identity). Prefer a personal access token or an OAuth app with the user's login.
> Never print, log, or ask anyone to paste a Novaplan AI token.

# Gemini CLI

> Gemini CLI über OAuth mit dem Novaplan AI MCP-Server verbinden.

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](/de/mcp/overview#schritt-1-oauth-anwendung-erstellen).

## Einstellungen hinterlegen

Bearbeiten Sie `~/.gemini/settings.json` und ersetzen Sie die Platzhalter:

```json theme={null}
{
  "mcpServers": {
    "novaplan": {
      "httpUrl": "NOVAPLAN_WORKSPACE_URL/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "$NOVAPLAN_CLIENT_SECRET",
        "redirectUri": "http://localhost:7777/oauth/callback",
        "scopes": [
          "openid", "profile", "email", "offline_access",
          "semantic:write", "conversation:write", "conversation:chat",
          "kb:read", "team:read", "user:read", "config:read"
        ]
      }
    }
  }
}
```

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.

<Warning>
  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](/de/contact-us). Deaktivieren Sie die Issuer-Prüfung nicht. Die Kompatibilität muss mit dem bereitgestellten Enterprise-OAuth-Server getestet werden.
</Warning>