MCP-Client-Support

Diese Referenz zeigt den exakten --client-Wert und was die CLI heute schreiben kann. Local Proxy bedeutet, dass der Client einen verwalteten LightNow-Eintrag erhält. Bridge bedeutet, dass LightNow aus einem Runtime Profile eine native Kompatibilitätsdatei rendert. Das ist kein Managed- Local-Proxy-Support.

Support-Matrix

Client	CLI-Target	Standard-Config	Local Proxy	Importquelle
Codex	codex	~/.codex/config.toml	stdio und lokales HTTP	ja
Google Antigravity	antigravity	~/.gemini/config/mcp_config.json	stdio	ja
Claude Code	claude-code	~/.claude.json	stdio	ja
Claude Desktop	claude-desktop	~/Library/Application Support/Claude/claude_desktop_config.json	stdio	ja
Cursor	cursor	~/.cursor/mcp.json	stdio	ja
Gemini CLI	gemini-cli	~/.gemini/settings.json	stdio	nein
VS Code	vscode	benutzerspezifische Code-mcp.json	stdio	ja
Windsurf / Devin Desktop	windsurf	~/.codeium/windsurf/mcp_config.json	Bridge	nein
Continue	continue	~/.continue/config.yaml	Bridge	nein
LibreChat	librechat	./librechat.yaml	Bridge	nein
MCP Inspector	mcp-inspector	./lightnow-mcp-inspector.sh	Bridge-Helper	nein

Die VS-Code-Standarddatei liegt unter ~/Library/Application Support/Code/User/mcp.json auf macOS, %APPDATA%/Code/User/mcp.json unter Windows und ~/.config/Code/User/mcp.json unter Linux. Mit --config-path lässt sich jeder Standardpfad überschreiben.

Workflow auswählen

Nutze die Modi bewusst:

Modus	Command-Form	Ergebnis
Managed Local Proxy	lightnow sync --client <client> --local-proxy	Ein LightNow-Eintrag plus client-spezifische Proxy-Config
Organisations-Policy	lightnow sync --client <client> --from-settings	LightNow Config wählt Profil, Modus und Policy für nicht verwaltete Einträge
Direct Sync	lightnow sync --client <client>	Client-native Einträge pro Server
Runner-Modus	lightnow sync --client <client> --runner	Ein lightnow run-Wrapper pro Profilserver
Import	lightnow import-config --client <client>	Unterstützte bestehende Einträge werden in ein Runtime Profile übernommen

Kombiniere --runner, --local-proxy und --from-settings nicht miteinander. Prüfe Dateiänderungen mit lightnow sync ... --dry-run, wenn du einen Schreibpfad noch nicht getestet hast.

Local-Proxy-Vertrag

Local Proxy über stdio unterstützt Codex, Antigravity, Claude Code, Claude Desktop, Cursor, Gemini CLI und VS Code. Codex ist aktuell das einzige Client-Target, das zusätzlich einen clientseitigen lokalen HTTP-Eintrag unterstützt:

Codex mit einem bereits laufenden lokalen Proxy verbinden

lightnow sync --client codex --profile default --local-proxy --local-proxy-transport http --local-proxy-url http://127.0.0.1:8080/mcp

Jeder Local-Proxy-Sync schreibt:

1. die Ziel-Config des AI-Clients mit einem LightNow-Eintrag und
2. ~/.lightnow/lightnow-proxy/<client>.yaml, sofern --local-proxy-config-path den Pfad nicht überschreibt.

Für das default-Profil pflegt die CLI zusätzlich ~/.lightnow/lightnow-proxy/default.yaml, sofern kein expliziter Proxy-Pfad angegeben wurde. Die client-spezifische YAML enthält Profil, Client-Transport, Registry API, Organisationskontext und Policy-Posture. Die Upstreams werden zur Laufzeit aus LightNow aufgelöst.

Import-Vertrag

lightnow import-config akzeptiert Antigravity, Claude Code, Claude Desktop, Codex, Cursor und VS Code als Quellen. Gemini CLI, Bridge-Targets und MCP Inspector werden nicht als Importquellen akzeptiert.

Prüfen, zusammenführen oder ersetzen

lightnow import-config --client codex --profile default --dry-run
lightnow import-config --client codex --profile default
lightnow import-config --client vscode --profile platform --tenant acme --replace

• --dry-run parst und prüft, ohne den Import anzuwenden.
• Standardmäßig werden unterstützte Einträge mit dem Zielprofil zusammengeführt.
• --replace ersetzt die vollständige Serverliste des Zielprofils.
• --config-path wählt eine abweichende Quelldatei.

Der Import macht die Client-Datei nicht zur dauerhaften Source of Truth. Sobald das Profil bereit ist, synchronisiere den Client wieder in den vorgesehenen verwalteten oder kompatiblen Modus.

Direct Sync, Runner und Bridge-Pfade

Direct Sync fordert einen client-nativen Export von LightNow an und aktualisiert die ausgewählte Datei. Dabei können abhängig vom Secret-Modus Serverdetails und Secret-Werte materialisiert werden. Für normale verwaltete Nutzung ist Local Proxy deshalb vorzuziehen.

Der Runner-Modus schreibt Wrapper in dieser Form:

lightnow run --profile <profile> --server <alias>

Der Runner-Modus benötigt Registry-verknüpfte Profilserver mit Versionen. Kann das ausgewählte Profil nicht gerendert werden, schlägt der Sync fehl, statt ein Teilergebnis zu schreiben. Windsurf, Continue und LibreChat verwenden ihre nativen JSON- oder YAML-Ausgaben als Bridge-Pfade. MCP Inspector nutzt einen generierten Shell-Helper für gezielte Prüfungen.

Config-Posture-Zustände

lightnow config-status --client <client> prüft Client-Datei und erwartete Proxy-Config, ohne Secrets auszugeben.

Zustand	Bedeutung	Nächster Schritt
managed	Ein gültiger LightNow-Proxy-Eintrag ohne umgehende Einträge	Keine Config-Aktion erforderlich
mixed	LightNow Proxy und nicht verwaltete MCP-Einträge existieren gemeinsam	Policy bestätigen oder erneut synchronisieren
legacy_runner	Alte lightnow run-Wrapper sind vorhanden	Mit Local Proxy neu synchronisieren
unmanaged	Direkte MCP-Einträge ohne LightNow Proxy	Nützliche Einträge importieren, danach synchronisieren
empty	Keine MCP-Einträge gefunden	Vorgesehenes Profil synchronisieren
invalid	Client-Datei konnte nicht geparst werden	Datei vor dem Sync reparieren oder wiederherstellen

lightnow config-status --client codex
lightnow config-status --client codex --json

Mit dem Client-Task fortfahren

Sicherer AblaufMCP-Clients verbinden

Installiere, erhalte nützliche Config, synchronisiere einen Pilot und prüfe die Runtime.

EntscheidungshilfeMCP-Client-Workflow auswählen

Wähle für ein reales Deployment zwischen verwaltetem, policy-gesteuertem und kompatiblem Modus.