Anleitung

Claude Desktop verbinden

Lass Claude Desktop nur einen lokalen LightNow Proxy starten. In LightNow entscheidest du, welche MCP-Server Claude sieht, hältst Secrets aus der Desktop-Konfiguration heraus und analysierst Tool-Nutzung zentral.

Claude Desktop SetupClaude Desktop startet einen LightNow Proxy; LightNow verwaltet die Serverliste

AI-ClientClaude Desktopliest JSON mcpServers aus der Claude App Config

stdio

LightNow Local Proxylightnow-proxyhaelt direkte Upstream-Server aus der Desktop-Datei heraus

LightNow

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

Claude Desktop nutzt bereits MCP-Server?

Importiere sie vor dem Sync. Local Proxy macht aus der MCP-Serverliste in Claude Desktop einen einzigen LightNow-Eintrag. Server, die du weiter nutzen willst, sollten zuerst in ein Runtime Profile wandern.

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

Claude Desktop synchronisieren

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

4

Claude Desktop neu starten

Starte Claude Desktop neu, damit die MCP-Serverliste frisch geladen wird.

Empfohlen fuer macOS

brew tap lightnow-ai/tap
brew install lightnow-cli lightnow-proxy
lightnow login
lightnow import-config --client claude-desktop
lightnow sync --client claude-desktop --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 import-config --client claude-desktop
lightnow sync --client claude-desktop --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 import-config --client claude-desktop
lightnow sync --client claude-desktop --local-proxy

Runtime Profile

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

Config-Dateien

Diese Dateien berührt LightNow für Claude Desktop:

Claude-Desktop-Config

~/Library/Application Support/Claude/claude_desktop_config.json

Local-Proxy-Config

~/.lightnow/lightnow-proxy/claude-desktop.yaml

Was geschrieben wird

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

claude_desktop_config.json

{
  "mcpServers": {
    "LightNow": {
      "command": "lightnow-proxy",
      "args": [
        "--config",
        "~/.lightnow/lightnow-proxy/claude-desktop.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. Claude Desktop bekommt dadurch nicht die Commands, URLs oder Secret-Werte aller Server im Profil.

Vorhandene Claude-Desktop-Konfiguration

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 Claude-Desktop-Einstellungen bleiben erhalten.

Vorhandene Claude-Desktop-Einträge importieren

lightnow import-config --client claude-desktop
lightnow sync --client claude-desktop --local-proxy

Vor dem Import ansehen

Mit lightnow import-config --client claude-desktop --dry-run siehst du vor der Änderung, was LightNow gefunden hat. mapped und custom können importiert werden; ambiguous und blocked brauchen zuerst eine Entscheidung.

Team-Rollout

LightNow-managed Client Policy verwenden

lightnow context --tenant acme
lightnow sync --client claude-desktop --from-settings
lightnow config-status --client claude-desktop --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

Bestehende MCP-Konfiguration importieren

Übernimm nützliche Claude-Desktop-MCP-Einträge in ein Runtime Profile, bevor LightNow die lokale Datei ersetzt.

Local Proxy debuggen

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

Claude Code verbinden

Nutze den Claude-Code-Guide, wenn du ~/.claude.json statt der Desktop-App konfigurierst.