Anleitung

Gemini CLI verbinden

Lass Gemini CLI nur einen lokalen LightNow Proxy starten. In LightNow entscheidest du, welche MCP-Server Gemini sieht, hältst Secrets aus lokaler Config heraus und analysierst Tool-Nutzung zentral.

Gemini CLI SetupGemini CLI startet einen LightNow Proxy; LightNow verwaltet die Serverliste

AI-ClientGemini CLIliest JSON mcpServers aus ~/.gemini/settings.json

stdio

LightNow Local Proxylightnow-proxystellt das Runtime Profile als einen Gemini MCP-Server bereit

LightNow

LightNowConfig + AnalyseProfil, Workspace, Policy, Events und Tool-Nutzung

Runtime Profile zuerst vorbereiten

Gemini CLI importiert bestehende MCP-Einträge heute nicht automatisch. Lege die Server, die Gemini nutzen soll, zuerst in einem Runtime Profile in LightNow an.

Schnelles Setup

1

LightNow installieren

Installiere CLI und Local Proxy auf diesem Rechner.

2

Anmelden

Melde dich an, damit LightNow deinen Account und Workspace-Kontext nutzen kann.

3

Runtime Profile vorbereiten

Füge die MCP-Server, die Gemini nutzen soll, zuerst zum Runtime Profile in LightNow hinzu.

4

Gemini CLI synchronisieren

Ersetze direkte MCP-Einträge durch einen LightNow-Proxy-Eintrag.

5

Gemini CLI neu starten

Starte eine neue Gemini-CLI-Session, damit die MCP-Serverliste frisch geladen wird.

Empfohlen fuer macOS

brew tap lightnow-ai/tap
brew install lightnow-cli lightnow-proxy
lightnow login
lightnow sync --client gemini-cli --local-proxy

Windows oder Linux

Windows

py -m pip install --user pipx
py -m pipx ensurepath
py -m pipx install lightnow-cli
py -m pipx install lightnow-proxy
lightnow login
lightnow sync --client gemini-cli --local-proxy

Linux

python3 -m pip install --user pipx
python3 -m pipx ensurepath
python3 -m pipx install lightnow-cli
python3 -m pipx install lightnow-proxy
lightnow login
lightnow sync --client gemini-cli --local-proxy

Runtime Profile

Ohne --profile <name> verwendet LightNow das Runtime Profile default.

Config-Dateien

Diese Dateien berührt LightNow für Gemini CLI:

Gemini-Settings

~/.gemini/settings.json

Local-Proxy-Config

~/.lightnow/lightnow-proxy/gemini-cli.yaml

Was geschrieben wird

Gemini CLI liest MCP-Server aus JSON. Nach dem Sync enthält diese Datei einen einzigen Top-Level-Eintrag mcpServers.LightNow:

~/.gemini/settings.json

{
  "mcpServers": {
    "LightNow": {
      "command": "lightnow-proxy",
      "args": [
        "--config",
        "~/.lightnow/lightnow-proxy/gemini-cli.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

Wenn LightNow den vollständigen Pfad zu lightnow-proxy auflösen kann, schreibt es diesen Pfad. Die Proxy-YAML enthält Clientname, stdio-Transport, Runtime Profile, Workspace-Kontext, Policy-Einstellungen, Telemetriepräferenz und Secret-Resolution-Modus. Gemini CLI bekommt dadurch nicht die Commands, URLs oder Secret-Werte aller Server im Profil.

Vorhandene Gemini-Einstellungen

Wenn Local Proxy direkte MCP-Einträge ersetzt, entfernt LightNow die Top-Level-JSON-Bereiche mcpServers und servers und fügt danach LightNow hinzu. Andere Gemini-Einstellungen wie selectedAuthType und theme bleiben erhalten.

Wenn Gemini bereits direkte MCP-Einträge hat, lege die nützlichen Server zuerst in einem Runtime Profile in LightNow an. Danach reicht Gemini ein lokaler LightNow-Eintrag; Commands, URLs, Header und Secrets bleiben hinter dem Proxy.

Team-Rollout

LightNow-managed Client Policy verwenden

lightnow context --tenant acme
lightnow sync --client gemini-cli --from-settings
lightnow config-status --client gemini-cli --json

Mit --from-settings wählt LightNow Profil, Telemetrieeinstellung, managed clients und den Umgang mit unmanaged entries. Nutze den Policy-Sync, wenn das Organisationsprofil bereit ist und das Pilot-Setup sauber funktioniert.

Weitere Anleitungen

Integrationen und Runtime Profiles

Bereite das Runtime Profile vor, das Gemini CLI über den Local Proxy nutzt.

Local Proxy debuggen

Nutze config-status, Proxy-Health-JSON und redacted Protocol Capture, wenn Gemini CLI keine Tools sieht.

MCP client support

Vergleiche Client Targets, Default-Pfade, Local-Proxy-Support und Import-Support.