CommencerGuides pratiquesMigration

Guide

Migration

Passez d'une configuration héritée ou de client direct à une configuration moderne tout en préservant les limites de périmètre, d'identité et de suppression.

Passer d'un client à jeton direct à OAuth

Lorsqu'un client prend en charge OAuth, la transition supprime le jeton porteur stocké de la configuration locale. La mémoire, le périmètre et l'attribution restent inchangés par le changement — seul le chemin des identifiants est déplacé.

  • Vérifiez que le client apparaît comme compatible OAuth avant de supprimer XMEMO_KEY.
  • Reconnectez-vous et approuvez memory:read et memory:write.
  • Exécutez un rappel inoffensif avant toute écriture.
  • Supprimez le jeton de l'ancien fichier de configuration et de l'environnement.

Avant : configuration par jeton direct

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:XMEMO_KEY}" }
    }
  }
}

Après : configuration OAuth

L'URL du serveur hébergé est tout ce qui reste ; l'autorisation fournit les périmètres.

{
  "servers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Vérifier la migration

Lisez avant d'écrire, afin qu'un identifiant défaillant se manifeste sans modifier la mémoire stockée.

await client.recallContext('current task and recent decisions', {
  preferWorking: true,
});

Source : Démarrage rapide hébergé