Import und Sync

Das Kommandozeilenwerkzeug onlymcp verbindet einen Rechner mit deinem Konto, trägt OnlyMCP in die Clients ein, die eine Konfigurationsdatei haben, und bringt deine Inhalte hinein und hinaus. Es läuft über npx, sonst ist vorher nichts zu installieren.

Voraussetzung: Node.js 22 oder neuer.

Diesen Rechner verbinden

npx onlymcp login

Der Befehl öffnet deinen Browser auf einer Seite, auf der der Code schon eingetragen ist, und gibt Code, Adresse und einen QR-Code zusätzlich im Terminal aus, falls sich kein Browser öffnet. Melde dich an und bestätige: der Rechner ist jetzt eines deiner Geräte und steht in deiner Geräteliste, wo du ihn jederzeit widerrufen kannst. Gleich danach schreibt login die Stub-Dateien, die weiter unten beschrieben sind.

Das Token liegt im Schlüsselbund deines Betriebssystems, nicht in einer Datei, und das Kommandozeilenwerkzeug wie das lokale Paket lesen es nur dort. Auf einem Rechner ohne Schlüsselbund, etwa auf manchem Server ohne Desktop, nimm stattdessen den Weg über die Adresse mit einem Token, siehe unterstützte Clients. npx onlymcp status zeigt, ob dieser Rechner angemeldet ist. npx onlymcp logout beendet die Sitzung dieses Rechners auf dem Server, der ihn dann nicht mehr als Gerät zählt, und entfernt die Anmeldung und den Cache von diesem Rechner.

OnlyMCP in einem Client eintragen

npx onlymcp install --client claude-code
npx onlymcp install --client codex
npx onlymcp install --client gemini-cli

Diese Befehle tragen das lokale Paket onlymcp im Client ein: der Client startet es auf diesem Rechner über stdio, und es meldet sich mit dem Login von oben an, nicht mit einem Token. --all schreibt jede Konfigurationsdatei dieser Clients, die auf diesem Rechner schon existiert, und --print zeigt nur, was geschrieben würde. Eine vorhandene Konfiguration wird gelesen und ergänzt, nie ersetzt. Für alle anderen Clients stehen unter unterstützte Clients der Befehl oder die Konfiguration zum Einfügen.

Importieren, was du schon hast

npx onlymcp import --dry-run
npx onlymcp import

Ohne weitere Angabe liest der Import Skills aus ~/.claude/skills und Agents aus ~/.claude/agents. --skills <dir> und --agents <dir> zeigen auf andere Ordner, und ein Plugin-Cache taugt ebenfalls als Skill-Ordner. Memory wird nur importiert, wenn du mit --memory <dir> einen Ordner nennst: dafür gibt es keine Vorgabe, denn eine Vorgabe, die auf die Notizen von jemandem zeigt, wäre das Schlimmste, was dieser Befehl tun könnte. --dry-run zeigt, was hochgeladen würde, und hört dann auf.

Dateien wie .env oder private Schlüssel liest der Import nie. Jede andere Datei, deren Inhalt nach einem Zugangsgeheimnis aussieht, hält er zurück und listet sie mit der Zeile auf, die angeschlagen hat, und er fragt, bevor etwas hochgeladen wird; eine zurückgehaltene Datei geht nur hoch, wenn du sie dort freigibst. --yes lädt ohne Rückfrage hoch, für Läufe ohne Aufsicht, und lässt zurückgehaltene Dateien liegen; ohne --yes und ohne Terminal verweigert der Import den Upload.

--prune entfernt zusätzlich aus deinem Konto, was die Quelle nicht mehr hat. Es listet alles auf, was es löschen würde, und fragt dann einmal nach. Es berührt nur deine eigenen Einträge, die nicht archiviert sind, nie Einträge eines Teams, und nur die Arten von Inhalten, die dieser Lauf gelesen hat: ohne --memory bleibt dein Memory unberührt. Ein --yes gibt es dafür nicht, und ohne Terminal löscht es nichts.

Clients aktuell halten

npx onlymcp sync

Manche Clients finden Skills und Agents, indem sie einen Ordner durchsuchen. sync legt dort für jeden Skill und jeden Agenten eine kleine Stub-Datei mit seiner eigenen Beschreibung ab, damit der Client ihn im richtigen Moment anbieten kann; login tut dasselbe gleich nach dem Verbinden. Die Stubs landen als skills/<name>/SKILL.md und agents/<name>.md in ~/.claude und in ~/.codex, jeweils nur, wenn der Ordner schon existiert, und in jedem Ordner, der in der Variablen ONLYMCP_STUB_DIRS steht, getrennt durch Doppelpunkte. Gibt es keinen davon, landen sie in ~/.claude/onlymcp/plugin.

Der Text eines Skills oder Agenten bleibt in OnlyMCP und wird geladen, wenn der Client ihn anfordert, die Begleitdateien eines Skills werden aber vollständig kopiert, damit ein Skill, der auf eine seiner Dateien verweist, unverändert funktioniert. Ein eigener Skill-Ordner oder eine eigene Agent-Datei, die schon dort liegt, wird nie überschrieben, und sync listet sie stattdessen auf. sync ergänzt und aktualisiert, es löscht nichts: der Stub eines Skills oder Agenten, den du in OnlyMCP entfernt hast, bleibt auf der Platte, bis du ihn selbst entfernst. --memory <dir> schreibt zusätzlich dein Memory als Dateien in den Ordner, den du nennst, und ersetzt dort eine Datei mit demselben Pfad.

Import und Sync laufen in der Kommandozeile, das Dashboard startet sie nicht. Die Geräteseite zeigt zu jedem Gerät, wann es zuletzt importiert und synchronisiert hat und wie viele Dateien der jeweilige Lauf umfasste.

Alles wieder mitnehmen

npx onlymcp export --zip onlymcp-export.zip

Der Export enthält Memory, Skills, Agents und Verbindungen, auch alles, was nach einem Stufenwechsel archiviert wurde. Verbindungen stehen ohne ihre Zugangsdaten darin: kein Token und keine OAuth-Anmeldung liegt im Archiv. Ein Kontingent sperrt ihn nie: ein volles Konto wächst nicht weiter, aber es hindert dich nie daran, deine Inhalte mitzunehmen. Die einzige Grenze sind 3 Exporte pro Stunde. --out <dir> entpackt das Archiv stattdessen in einen Ordner, und --scope und --types grenzen es ein.