# Claude (claude.ai) Connectez Claude sur claude.ai en tant que connecteur personnalisé au point de terminaison MCP hébergé en Streamable HTTP, avec OAuth et les portées memory:read et memory:write. - Canonical: https://docs.xmemo.dev/fr/docs/mcp/claude - Locale: fr-FR - Content-Locale: fr-FR - Canonical-Content-Digest: de1a3fce819ac5cc3e4ef555fb6ba57c0ae2af9af5e91367ad4efac64a274ea3 - Edition-Digest: 3e3559a1376148d5d7db183b3d6932a176ee26131623f648460a614dc4db2540 - Source-Revision: sha256:ef049dd959bada93a714e560eece53ae72cd3ce2d2ed84bbab43191b9ae93474 ## Prérequis Utilisez Claude avec la prise en charge des connecteurs personnalisés et un compte XMemo valide. Informations de connexion : - Interface : Claude sur le web (claude.ai), connecté via un connecteur personnalisé. - URL de connexion : https://xmemo.dev/mcp. - Transport : Streamable HTTP (streamable-http). - Mode d'authentification : code d'autorisation OAuth 2.0 avec PKCE et Dynamic Client Registration (enregistrement dynamique des clients). - Portées : memory:read et memory:write. - Compte : compte XMemo valide sur https://xmemo.dev. ## Ajouter XMemo comme connecteur personnalisé Ajoutez le serveur MCP hébergé dans Claude. L'URL de connexion est le seul paramètre du serveur : - 1. Dans Claude, ouvrez Customize > Connectors et choisissez Add custom connector. Lien direct : https://claude.ai/customize/connectors?modal=add-custom-connector. - 2. Nom : XMemo. - 3. URL du serveur MCP distant : https://xmemo.dev/mcp. - 4. Ajoutez le connecteur, puis cliquez sur Connect pour lancer OAuth. ## Approuver l'accès avec OAuth Claude s'enregistre comme client OAuth via Dynamic Client Registration et ouvre la page d'autorisation XMemo dans votre navigateur. Connectez-vous et approuvez memory:read et memory:write lors du consentement. Claude reçoit ses identifiants de cette autorisation OAuth. ## N'ajoutez pas de jeton bearer Le connecteur personnalisé n'a besoin d'aucune clé API. Ne saisissez pas de clé API XMemo, de XMEMO_KEY ni de jeton bearer dans le connecteur ; l'autorisation OAuth fournit les identifiants et leurs portées. ## Activer XMemo dans une conversation Revenez dans Claude et activez XMemo pour la conversation. Claude découvre alors les outils XMemo avec leurs titres et leurs annotations de sécurité. ## Tester avec un véritable appel recall Le premier appel doit être en lecture seule. Il s'agit d'une véritable invocation de recall, pas d'un espace réservé de contrôle d'état, et elle n'écrit pas en mémoire. ```text recall({ query: "connection check", limit: 1 }) ``` ## Réponse attendue (forme littérale) Un appel réussi renvoie la forme de texte classé publique ci-dessous ; la référence et le contenu sont des valeurs réelles de l'espace mémoire autorisé. ```text ### XMemo Memory Results: 1. Reference: | Location: > ``` ## Outils disponibles dans Claude Sur le profil claude-public, Claude voit 27 outils. Ils sont regroupés ci-dessous par annotation de sécurité : les outils de lecture ne modifient jamais les données, les outils d'écriture ajoutent, terminent ou restaurent des enregistrements, et les outils destructifs peuvent écraser, modifier ou supprimer des enregistrements existants. Les outils qui ont une page de référence dédiée sont liés ; les autres ne sont décrits que sur cette page. ## Outils de lecture En lecture seule et idempotents ; ces outils ne modifient pas les données stockées : - get_mcp_identity (Check XMemo connection) : renvoie l'identité authentifiée du connecteur et les portées mémoire accordées. - [search_memory](/docs/tools/search) (Search XMemo memories) : recherche des enregistrements de mémoire visibles, à portée définie ou d'équipe. - [recall](/docs/tools/recall) (Recall XMemo memory) : récupère les mémoires visibles les plus pertinentes. - [recall_context](/docs/tools/recall-context) (Build XMemo context) : construit un paquet de contexte borné à partir des mémoires visibles. - memory_overview (Show XMemo memory overview) : résume les mémoires visibles et l'activité récente. - memory_stats (Show XMemo memory statistics) : renvoie des statistiques agrégées sur les mémoires visibles. - memory_activity (Show XMemo memory activity) : affiche une chronologie sûre des modifications de votre propre mémoire sans exposer les journaux d'audit bruts. - analyze_memory_text (Analyze XMemo memory text) : compte un mot ou une phrase exacte dans les mémoires visibles. - explain_memory (Explain XMemo memory) : explique pourquoi une mémoire visible existe ou pourquoi elle a correspondu à une requête. - list_memory_todos (List XMemo memory TODOs) : liste les TODO et actions basés sur la mémoire ; c'est ainsi que Claude lit les TODO. - list_ledger_transactions (List XMemo Ledger transactions) : liste les enregistrements Ledger visibles. - get_monthly_ledger_summary (Summarize XMemo Ledger by month) : résume par mois les enregistrements Ledger visibles. - read_memory (Read Memory) : lit une page bornée d'une mémoire exacte, ou d'un Document autorisé via sa référence de document, telle que renvoyée par recall ou par la recherche. - get_project_context (Get project context) : lit le contexte autorisé d'un projet que vous possédez ou auquel vous avez accès. ## Outils d'écriture Ces outils ajoutent, terminent ou restaurent des enregistrements et ne sont pas marqués comme destructifs : - add_expense (Record an XMemo Ledger transaction) : crée un enregistrement Ledger structuré. - complete_memory_todo (Complete XMemo memory TODO) : marque comme terminé un TODO ou une action existante basée sur la mémoire. - create_memory_todo (Create XMemo memory TODO) : crée un TODO ou une action basée sur la mémoire. - [remember](/docs/tools/remember) (Remember in XMemo) : crée ou déduplique une mémoire à portée définie. - restore_memory (Restore XMemo memory) : restaure un enregistrement supprimé par forget dans son mode par défaut de suppression réversible. - record_event (Record a milestone) : ajoute un événement de jalon ou de passation ; il ne modifie ni ne supprime jamais d'enregistrements existants. - create_pending_decision (Save a pending decision) : enregistre une décision non résolue avec son contexte et ses options pour un examen ultérieur. - resolve_decision (Resolve a pending decision) : enregistre le résultat choisi pour une décision en attente précise et la clôt en conservant son historique. ## Outils destructifs Ces outils sont marqués comme destructifs car ils peuvent écraser, modifier ou supprimer des enregistrements existants : - [forget](/docs/tools/forget) (Forget XMemo memory, TODO, or Ledger transaction) : supprime une mémoire, un TODO ou un enregistrement Ledger sélectionné ; voir Suppression et récupération ci-dessous. - update_memory (Update XMemo memory) : écrase des champs d'une mémoire sélectionnée par sa référence exacte. - update_state (Save working state) : enregistre ou remplace un point de contrôle nommé de l'état de travail afin qu'une conversation ultérieure puisse le reprendre. - [todo](/docs/tools/todos) (Manage XMemo TODOs) : crée, met à jour ou termine vos propres TODO ; voir TODO dans Claude ci-dessous. - project (Manage XMemo project) : crée un projet, ou modifie les mémoires, décisions, liens de documents et de conversations, ou paramètres d'un projet autorisé. ## Suppression et récupération Une suppression via forget est récupérable, sauf si vous demandez explicitement une suppression définitive : - Par défaut : forget effectue une suppression réversible (soft delete). - Annulation : restore_memory restaure un enregistrement supprimé de façon réversible. - Définitive : forget avec mode='hard' est définitif et irrécupérable. Il exige votre confirmation explicite, et un enregistrement supprimé définitivement ne peut pas être restauré. ## TODO dans Claude Dans Claude, l'outil todo ne fait que créer, mettre à jour ou terminer des TODO. Claude lit les TODO avec list_memory_todos. La page de référence de todo décrit le répartiteur complet ; dans Claude, utilisez-le uniquement pour ces trois actions. ## Claude Desktop Dans Claude Desktop, commencez par le même connecteur personnalisé et le même flux OAuth. La configuration locale avec une clé API reste une alternative : - Recommandé : ajoutez XMemo comme connecteur personnalisé avec https://xmemo.dev/mcp et terminez OAuth. Aucune clé API n'est nécessaire. - Alternative : configurez le proxy stdio propriétaire xmemo-mcp ou mcp-remote dans claude_desktop_config.json avec une clé API XMemo. Consultez la [vue d'ensemble MCP](/docs/mcp/overview) pour la configuration du proxy stdio. ## Claude Code Claude Code utilise une configuration distincte. Consultez [Claude Code](/docs/mcp/claude-code) pour le Skill autonome et la configuration MCP directe. ## Erreurs courantes Les échecs OAuth correspondent aux réponses réelles du point de terminaison de jeton : - invalid_grant — Le code d'autorisation est invalide, expiré ou déjà utilisé : reconnectez XMemo dans Claude et autorisez à nouveau. - invalid_target — La ressource OAuth ne correspond pas à ce serveur MCP : supprimez le connecteur et ajoutez-le à nouveau avec https://xmemo.dev/mcp. - 403 insufficient_scope — L'autorisation n'inclut pas memory:read ou memory:write : approuvez les deux portées et reconnectez-vous. ## Mise à jour et suppression Procédures de maintenance du connecteur Claude : - Reconnexion : si Claude affiche un message d'autorisation ou de reconnexion pour XMemo, reconnectez le connecteur et terminez OAuth à nouveau. - Suppression : supprimez le connecteur personnalisé XMemo dans les paramètres des connecteurs de Claude.