Bestehende MCP-Config importieren

Nutze den Import, wenn ein unterstützter AI-Client bereits MCP-Server enthält, die Teil eines LightNow Runtime Profiles werden sollen. Der Import ändert das Zielprofil; er schreibt die Client-Datei nicht um.

Unterstützte Quellen

Die aktuelle CLI importiert codex, claude-code, claude-desktop, cursor, vscode und antigravity. Nutze --config-path, wenn die Datei nicht am Default-Pfad des Clients liegt.

Codex-Import als Vorschau

lightnow login
lightnow import-config --client codex --profile default --dry-run

Was die Vorschau macht

Die Vorschau schreibt nicht, ist aber nicht offline

Die CLI liest die Quell-Config und sendet ihren Inhalt zur Klassifizierung an den authentifizierten Registry-API-Import-Endpunkt. --dry-run verhindert Profiländerungen und bearbeitet die Quelldatei nie. Prüfe die Quelle vor dem Senden, wenn sie Werte enthält, die den Rechner nicht verlassen sollen.

Die CLI zeigt eine redigierte Zusammenfassung und gibt nicht die Quell-Config aus. Einträge werden beispielsweise als mapped, custom, importable oder blocked klassifiziert. Kläre blockierte oder mehrdeutige Ergebnisse vor dem Anwenden.

Mit Merge anwenden

Merge ist der Default und der sicherste Modus. Akzeptierte importierte Einträge werden dem Runtime Profile hinzugefügt; bestehende Profilmitgliedschaften bleiben erhalten.

In das Default Runtime Profile mergen

lightnow import-config --client codex --profile default

Der Command nutzt den aktiven persönlichen oder Organisationskontext. Setze --tenant <id-oder-slug> nur, wenn das Profil dieser Organisation gehört und dein Account Zugriff darauf hat.

Profilmitgliedschaft ersetzen

Replace ändert die gesamte Serverliste

Mit --replace wird das akzeptierte Importergebnis zur Servermitgliedschaft des Zielprofils. Bestehende Profilserver, die nicht im akzeptierten Import vorkommen, werden entfernt. Sieh dir denselben Command zuerst als Vorschau an.

Replace ansehen und anwenden

lightnow import-config --client codex --profile default --replace --dry-run
lightnow import-config --client codex --profile default --replace

Nutze Replace nur, wenn die lokale Quelldatei absichtlich die vollständige Source of Truth für dieses Runtime Profile ist.

Migration abschließen

Wenn das Profil alle benötigten Server enthält, ersetze die direkten Client-Einträge durch einen LightNow-Proxy-Eintrag:

Codex verbinden und prüfen

lightnow sync --client codex --profile default --local-proxy
lightnow config-status --client codex --json
lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health --json

Der Sync listet direkte Einträge vor dem Entfernen auf, fragt nach Bestätigung und behält ~/.codex/config.toml.lightnow.bak. Starte Codex danach neu.

Fertig, wenn

1

Jeder wichtige Quelleintrag ist geklärt

Er ist gemappt oder als custom importiert, oder du hast ihn bewusst ausgeschlossen.

2

Das Runtime Profile ist korrekt

Bestehende Mitgliedschaften wurden mit Merge bewahrt oder absichtlich ersetzt.

3

Der Client ist managed

config-status meldet managed und Proxy Health erklärt verbleibende Upstream-Fehler.

Häufige Fehler

PfadConfig-Datei nicht gefunden

Übergib die genaue Quelldatei mit --config-path.

QuelleImport-Client nicht unterstützt

Nutze eines der sechs oben aufgeführten Importziele.

SessionAuthentifizierung abgelaufen

Führe lightnow login aus und wiederhole die Vorschau.

MappingEintrag ist blocked

Lass ihn aus Replace heraus, bis Identität und Runtime-Anforderungen geklärt sind.

Verwandte Guides

• Quickstart
• Codex verbinden
• MCP-Client-Support