Import et synchronisation

L’outil en ligne de commande onlymcp connecte une machine à ton compte, inscrit OnlyMCP dans les clients qui ont un fichier de configuration et fait entrer et sortir ton contenu. Il tourne via npx, il n’y a rien d’autre à installer avant.

Prérequis : Node.js 22 ou plus récent.

Connecter cette machine

npx onlymcp login

La commande ouvre ton navigateur sur une page où le code est déjà rempli, et affiche aussi le code, l’adresse et un code QR au cas où aucun navigateur ne s’ouvre. Connecte-toi et confirme : cette machine est désormais l’un de tes appareils et figure dans ta liste d’appareils, où tu peux la révoquer à tout moment. Juste après, login écrit les fichiers stub décrits plus bas.

Le jeton est gardé dans le trousseau de ton système d’exploitation, pas dans un fichier, et l’outil en ligne de commande comme le paquet local ne le lisent que là. Sur une machine sans trousseau, comme certains serveurs sans bureau, prends plutôt la voie distante avec un jeton, voir clients pris en charge. npx onlymcp status indique si cette machine est connectée. npx onlymcp logout met fin à la session de cette machine sur le serveur, qui ne la compte alors plus comme appareil, et retire la connexion et le cache de cette machine.

Inscrire OnlyMCP dans un client

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

Ces commandes inscrivent le paquet local onlymcp dans le client : le client le lance sur cette machine via stdio, et il se connecte avec le login ci-dessus, pas avec un jeton. --all écrit chaque fichier de configuration de ces clients qui existe déjà sur cette machine, et --print montre seulement ce qui serait écrit. Une configuration existante est lue et complétée, jamais remplacée. Pour tous les autres clients, clients pris en charge donne la commande ou la configuration à coller.

Importer ce que tu as déjà

npx onlymcp import --dry-run
npx onlymcp import

Par défaut, l’import lit les skills dans ~/.claude/skills et les agents dans ~/.claude/agents. --skills <dir> et --agents <dir> indiquent d’autres dossiers, et un cache de plugins fonctionne aussi comme dossier de skills. La mémoire n’est importée que si tu nommes un dossier avec --memory <dir> : il n’y a pas de valeur par défaut, car une valeur par défaut pointée sur les notes de quelqu’un serait la pire chose que cette commande puisse faire. --dry-run montre ce qui serait envoyé, puis s’arrête.

L’import ne lit jamais les fichiers comme .env ni les clés privées. Il retient tout autre fichier dont le contenu ressemble à un identifiant et l’affiche avec la ligne qui a déclenché l’alerte, puis demande avant d’envoyer quoi que ce soit ; un fichier retenu n’est envoyé que si tu le libères à ce moment-là. --yes envoie sans demander, pour les exécutions sans surveillance, et laisse les fichiers retenus de côté ; sans --yes et sans terminal, l’import refuse.

--prune retire en plus de ton compte ce que la source n’a plus. Il liste tout ce qu’il supprimerait, puis demande une seule fois. Il ne touche que tes propres entrées non archivées, jamais les entrées d’une équipe, et seulement les types de contenu que cette exécution a lus : sans --memory, ta mémoire n’est pas touchée. Aucun --yes ne le contourne, et sans terminal il ne supprime rien.

Garder les clients à jour

npx onlymcp sync

Certains clients trouvent les skills et les agents en parcourant un dossier. sync y écrit un petit fichier stub pour chaque skill et chaque agent, avec sa propre description, pour que le client puisse le proposer au bon moment ; login fait de même juste après la connexion. Les stubs vont dans skills/<name>/SKILL.md et agents/<name>.md à l’intérieur de ~/.claude et de ~/.codex, chacun seulement s’il existe déjà, et dans chaque dossier listé dans la variable ONLYMCP_STUB_DIRS, séparés par des deux-points. S’il n’y en a aucun, ils vont dans ~/.claude/onlymcp/plugin.

Le texte d’un skill ou d’un agent reste dans OnlyMCP et est chargé quand le client le demande, mais les fichiers annexes d’un skill sont copiés en entier, pour qu’un skill qui renvoie à l’un de ses fichiers fonctionne tel quel. Un dossier de skill ou un fichier d’agent à toi qui s’y trouve déjà n’est jamais écrasé, et sync le signale à la place. sync ajoute et met à jour, il ne supprime rien : le stub d’un skill ou d’un agent retiré d’OnlyMCP reste sur le disque jusqu’à ce que tu le supprimes toi-même. --memory <dir> écrit en plus ta mémoire sous forme de fichiers dans le dossier que tu nommes, et y remplace un fichier qui a le même chemin.

L’import et la synchronisation s’exécutent dans la ligne de commande, le tableau de bord ne les lance pas. La page des appareils indique pour chaque appareil quand il a importé et synchronisé pour la dernière fois, et combien de fichiers chaque exécution a concernés.

Tout récupérer

npx onlymcp export --zip onlymcp-export.zip

L’export contient la mémoire, les skills, les agents et les connexions, y compris tout ce qui a été archivé après un changement d’offre. Les connexions y figurent sans leurs identifiants : aucun jeton et aucune autorisation OAuth ne se trouvent dans l’archive. Aucun quota ne le bloque : un compte plein cesse de grandir, mais il ne t’empêche jamais de récupérer ton contenu. La seule limite est de 3 exports par heure. --out <dir> décompresse plutôt l’archive dans un dossier, et --scope et --types en limitent le contenu.