GitHub Copilot

Prérequis

Utilisez VS Code avec GitHub Copilot Chat et la prise en charge de MCP. Interface et prérequis :

• Interface concrète : VS Code avec l'extension GitHub Copilot Chat (chemin OAuth de l'éditeur).
• Fichier de configuration : %APPDATA%\Code\User\mcp.json (Windows), ~/Library/Application Support/Code/User/mcp.json (macOS) ou ~/.config/Code/User/mcp.json (Linux).
• Utilise la clé servers plutôt que mcpServers.
• Point de terminaison : https://xmemo.dev/mcp.
• Compte : Compte XMemo valide sur https://xmemo.dev.

Installation / configuration

Modifiez votre configuration utilisateur VS Code mcp.json sous la clé servers et ajoutez l'URL XMemo hébergée. N'utilisez pas la configuration Copilot CLI ici ; son chemin direct dispose de son propre itinéraire (/docs/mcp/copilot-cli) :

• Conservez l'entrée de l'éditeur uniquement avec l'URL.
• Le premier appel d'outil ouvre OAuth dans le navigateur.
• N'ajoutez pas d'en-tête Authorization à cette entrée VS Code.

Définir l'identifiant

Aucune clé — complétez OAuth dans le navigateur dans VS Code / GitHub Copilot Chat. Ne définissez pas XMEMO_KEY et ne collez pas de jeton porteur dans mcp.json :

No XMEMO_KEY
Complete browser OAuth in VS Code / GitHub Copilot Chat

Générer / confirmer XMEMO_AGENT_INSTANCE_ID

La liste OAuth VS Code révisée ne comporte aucun en-tête d'identité côté client. N'ajoutez pas XMEMO_AGENT_INSTANCE_ID à mcp.json ; confirmez que ce chemin OAuth utilise son attribution gérée par l'autorisation.

Conserver le bloc de configuration existant

Utilisez le bloc de configuration révisé de VS Code / GitHub Copilot. Conservez la clé servers et la forme OAuth avec URL uniquement ; n'y copiez pas la configuration du porteur Copilot CLI :

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

Redémarrer le client

Rechargez la fenêtre VS Code (Developer: Reload Window) ou redémarrez la connexion MCP après avoir enregistré mcp.json afin que Copilot lise la définition actuelle du serveur.

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 GitHub Copilot Chat :

• 1. Enregistrer un fait synthétique : Demandez à Copilot Chat de mémoriser la convention ("Demo project timestamps use UTC.") dans "projects/demo-onboarding/conventions".
• 2. Transition sans état : Ouvrez une nouvelle session de discussion dans GitHub Copilot ou rechargez la fenêtre VS Code.
• 3. Rappel avec attribution de source : Interrogez "demo project timestamp format". Confirmez Reference et Location renvoyés.
• 4. Corriger la mémoire : Mettez à jour la convention avec le formatage ISO 8601 à l'aide de update_memory.
• 5. Nettoyage optionnel : Effectuez une suppression réversible (soft-delete) de la convention via forget lorsque la vérification se termine.

Capacités et outils de profil

GitHub Copilot dans VS Code a accès aux outils qualifiés par profil définis dans le contrat de documentation MCP pour le profil generic-public :

• Outils de mémoire principaux : remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Outils d'espace de travail : get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger.

Limites et frontières

Frontières opérationnelles pour GitHub Copilot dans VS Code :

• Isolation de l'espace de travail : Les opérations sont strictement confinées à l'espace de travail de l'utilisateur autorisé.
• Séparation éditeur/CLI : La session OAuth de VS Code ne se propage pas aux outils de terminal externes.
• Pas de mélange d'en-têtes : N'ajoutez pas d'en-têtes Authorization à l'entrée servers dans mcp.json.

Erreurs courantes

VS Code / GitHub Copilot Chat utilise le chemin OAuth du navigateur et ne doit pas être débogué avec les paramètres de jeton Copilot CLI :

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

Mise à jour et suppression

Procédures de maintenance pour GitHub Copilot :

• Mise à jour : Rechargez la fenêtre VS Code après avoir mis à jour la configuration.
• Suppression : Supprimez le bloc xmemo de mcp.json et rechargez la fenêtre VS Code.