ChatGPT

Prérequis

Utilisez une configuration d'application OpenAI prenant en charge un serveur MCP distant et le point de terminaison Streamable HTTP hébergé. Runtimes et prérequis :

• Interface concrète : Client Web et de bureau ChatGPT (OpenAI Apps / Actions).
• Point de terminaison : https://xmemo.dev/mcp.
• Transport : Streamable HTTP (streamable-http).
• Mode d'authentification : OAuth avec les portées memory:read et memory:write.
• Compte : Compte XMemo valide sur https://xmemo.dev.

Installation / configuration

Dans le client ChatGPT ou le tableau de bord de la plateforme OpenAI, enregistrez l'URL MCP hébergée et les métadonnées OAuth pour la connexion distante :

• Configurez l'URL MCP hébergée dans le tableau de bord de l'application : https://xmemo.dev/mcp.
• Demandez memory:read et memory:write lors du consentement.
• N'ajoutez pas de jeton porteur à la liste des applications.

Définir l'identifiant

Aucune clé — complétez OAuth dans le navigateur. ChatGPT reçoit l'identifiant via l'autorisation OAuth ; ne définissez pas XMEMO_KEY et n'ajoutez pas d'en-tête Authorization :

No XMEMO_KEY
Complete browser OAuth in ChatGPT

Générer / confirmer XMEMO_AGENT_INSTANCE_ID

La liste OAuth ChatGPT révisée ne comporte aucun en-tête d'identité côté client. N'inventez pas et ne collez pas XMEMO_AGENT_INSTANCE_ID dans la configuration de l'application ; confirmez que l'attribution est gérée par l'autorisation OAuth pour ce chemin client.

Conserver le bloc de configuration existant

Utilisez le bloc de configuration révisé de ChatGPT. Conservez son URL hébergée, son mode OAuth et les portées demandées ; modifiez uniquement les valeurs locales requises par le client dans le tableau de bord :

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

Redémarrer le client

Enregistrez la configuration de l'application, fermez toute connexion MCP obsolète et rouvrez l'application ou la conversation ChatGPT afin qu'elle charge les métadonnées OAuth actuelles.

Tester avec un véritable appel de rappel

Rendez le premier appel MCP en lecture seule. Il s'agit d'une véritable invocation de rappel, pas d'un espace réservé de vérification de santé, et il n'écrit pas dans la mémoire.

recall({ query: "connection check", limit: 1 })

Réponse attendue (forme littérale)

Un appel réussi renvoie la forme de texte classé public ci-dessous ; la référence et le contenu sont de véritables valeurs issues de l'espace mémoire autorisé.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Première tâche utile : Cycle de vie de mémoire synthétique

Exécutez la tâche complète de mémoire synthétique au sein de ChatGPT :

• 1. Enregistrer un fait synthétique : Demandez à ChatGPT d'appeler remember avec le contenu "Demo project timestamps use UTC." et le chemin "projects/demo-onboarding/conventions".
• 2. Transition sans état : Ouvrez un tout nouveau fil de discussion dans ChatGPT pour vous assurer qu'aucun souvenir de conversation n'est transmis.
• 3. Rappel avec attribution de source : Demandez à ChatGPT de rappeler "demo project timestamp format". Confirmez Reference et Location renvoyés.
• 4. Corriger la mémoire : Demandez à ChatGPT d'appeler update_memory avec l'ID actif, en mettant à jour la convention avec le formatage ISO 8601.
• 5. Nettoyage optionnel : Demandez à ChatGPT d'appeler forget avec l'ID de mémoire lorsque les tests se terminent.

Capacités et outils de profil

ChatGPT a accès aux outils qualifiés par profil définis dans le contrat de documentation MCP pour le profil chatgpt-public :

• Outils de mémoire principaux : remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Outils de projet et de contexte : get_mcp_identity, get_project_summary, project, todo, update_state, record_event, restore_memory, analyze_memory_text, memory_overview.
• Espaces de travail interactifs : open_project_workspace, open_todo_board, open_ledger, ledger.

Limites et frontières

Frontières opérationnelles et contraintes pour l'intégration de ChatGPT :

• Limite de l'espace de travail : L'accès à la mémoire est strictement confiné à l'espace de travail de l'utilisateur autorisé.
• Support de Skill : ChatGPT exécute les appels d'outils à distance et n'exécute pas de skills Node.js locales autonomes.
• Session OAuth : Les sessions OAuth inactives peuvent expirer périodiquement, nécessitant une réautorisation en un clic dans le navigateur.

Erreurs courantes

Les échecs OAuth spécifiques à ChatGPT correspondent aux réponses réelles du point de terminaison de jeton :

• invalid_grant — Le code d'autorisation est invalide ou expiré, ou a déjà été utilisé : reconnectez ChatGPT et autorisez à nouveau.
• invalid_target — La ressource OAuth ne correspond pas à ce serveur MCP : redémarrez la connexion en utilisant https://xmemo.dev/mcp comme ressource.
• 403 insufficient_scope — L'autorisation n'inclut pas memory:read ou memory:write : approuvez la portée demandée et reconnectez-vous.

Mise à jour et suppression

Procédures de maintenance pour ChatGPT :

• Mise à jour : Mettez à jour le client ChatGPT ou réauthentifiez-vous pour actualiser les définitions d'outils.
• Suppression : Supprimez la connexion XMemo dans ChatGPT Settings -> Connected Accounts / MCP.