Résoudre les problèmes d’installation et de connexion de WinDbg MCP

Utilisez cet article lorsque Visual Studio Code avec GitHub Copilot ou GitHub Copilot CLI ne peut pas inscrire le serveur MCP (Model Context Protocol) WinDbg, ne peut pas se connecter à une session MCP WinDbg ou les contrôles de sécurité MCP WinDbg bloquent une opération. L’enregistrement ajoute le serveur MCP WinDbg à la configuration du client IA, tandis que la connexion associe le client à une session WinDbg spécifique.

Pour obtenir des instructions d’installation, consultez Installer et activer WinDbg MCP. Pour obtenir des conseils de sécurité et de confidentialité faisant autorité, consultez les considérations relatives à la sécurité et à la confidentialité de WinDbg MCP.

Commencez par le symptôme que vous observez, identifiez la cause probable et effectuez les étapes de résolution.

Liste de contrôle pour la résolution des problèmes

Pour les problèmes d’enregistrement du serveur MCP :

  1. Ouvrez WinDbg. Vous n’avez pas besoin de charger ou d’attacher à une cible de débogage pour utiliser Activer le serveur ou installer MCP.
  2. Ouvrez les paramètres du service MCP et vérifiez que vous avez sélectionné Activer le serveur.
  3. Vérifiez que vous avez sélectionné Visual Studio Code ou GitHub Copilot CLI en tant que client.

Pour les problèmes de connexion ou de session :

  1. Démarrez le service MCP dans la fenêtre WinDbg prévue.
  2. Si vous analysez une cible, chargez-la ou attachez-la à la cible de débogage en fonction des besoins.

La liste des serveurs MCP n’inclut pas WinDbg

La liste des serveurs MCP du client IA pris en charge n’inclut pas WinDbg.

Cause

Installer MCP n’a pas inscrit WinDbg auprès du client, ou le client n’a pas rechargé sa configuration de serveur MCP.

Résolution

  1. Redémarrez le client IA, puis vérifiez sa liste de serveurs MCP.
  2. Dans WinDbg, ouvrez les paramètres du service MCP et sélectionnez le client pris en charge approprié.
  3. Sélectionnez à nouveau Installer MCP .
  4. Effectuez toute confirmation que le client affiche.
  5. Redémarrez le client, puis vérifiez à nouveau sa liste de serveurs MCP.

Si WinDbg est toujours manquant car Installer MCP échoue, enregistrez WinDbg manuellement.

Enregistrer manuellement un client pris en charge

Utilisez cette solution de secours uniquement lorsque Installer MCP n'enregistre pas WinDbg dans Visual Studio Code ou GitHub Copilot CLI.

  1. Dans WinDbg, ouvrez les paramètres du service MCP.
  2. Sélectionnez Personnalisé pour afficher la configuration du proxy. La sélection de Custom à cette étape fournit uniquement la commande proxy pour la configuration du client pris en charge.
  3. Sélectionnez Copier dans le Presse-papiers et notez le command chemin d’accès que WinDbg copie dans le Presse-papiers.

Configurez le client pris en charge :

  1. Dans votre espace de travail, ajoutez le serveur WinDbg à .vscode/mcp.json. Remplacez la valeur d’exemple command par le chemin d’accès depuis le Presse-papiers :

    {
  "servers": {
    "WinDbg": {
      "type": "stdio",
      "command": "C:\\path\\to\\DbgX.Mcp.Proxy.exe",
      "args": []
    }
  }
}

  2. Redémarrez Visual Studio Code.

Une fois le client redémarré, consultez Vérifier la connexion MCP WinDbg.

GitHub Copilot ne trouve pas la session WinDbg prévue

Visual Studio Code avec GitHub Copilot et GitHub Copilot CLI ne trouve pas la session WinDbg qui contient la cible de débogage prévue.

Cause

Le service MCP n’est pas en cours d’exécution dans la fenêtre WinDbg prévue, ou plusieurs sessions WinDbg sont disponibles et le proxy ne peut pas sélectionner automatiquement une session.

Résolution

  1. Dans la fenêtre WinDbg prévue, sélectionnez le service MCP.
  2. Demandez au client IA d’utiliser list_sessions.
  3. Identifiez l’ID de processus de la session WinDbg prévue.
  4. Demandez au client IA d’utiliser connect_session avec cet ID de processus.
  5. Vérifiez que le type cible et l’état d’exécution que le client signale correspondent à ceux de la fenêtre WinDbg prévue.

Pour obtenir des conseils supplémentaires sur la sélection de session, consultez Gérer les sessions WinDbg.

La session WinDbg n’est pas disponible, car un autre client est connecté

La session WinDbg prévue apparaît indisponible lorsque le client IA répertorie les sessions ou tente de se connecter.

Cause

Un autre client IA a une connexion active à la session WinDbg. Un seul client MCP actif peut se connecter à une session WinDbg à la fois.

Résolution

  1. Dans le client IA connecté, demandez au client d’utiliser disconnect_session.
  2. Vérifiez que le client signale qu’il s’est déconnecté de la session WinDbg.
  3. Dans le client IA prévu, demandez au client d’utiliser list_sessions.
  4. Demandez au client concerné d’utiliser connect_session avec l’ID de processus de la session WinDbg.
  5. Vérifiez que le client signale une connexion à la session prévue.

Accès refusé lorsque WinDbg est exécuté en tant qu’administrateur

La connexion échoue avec un message d’accès refusé lorsque WinDbg est en cours d’exécution en tant qu’administrateur.

Cause

La session WinDbg avec élévation de privilèges empêche le client IA pris en charge de se connecter via le proxy.

Résolution

  1. Fermez la session WinDbg avec élévation de privilèges.
  2. Démarrez WinDbg sans sélectionner Exécuter en tant qu’administrateur.
  3. Démarrez le service MCP.
  4. Chargez ou connectez-vous à la cible de débogage si nécessaire.
  5. Ouvrez le client IA pris en charge et suivez les étapes décrites dans Vérifier la connexion MCP WinDbg.

La protection contre l’injection de prompt bloque une opération

Le client IA signale que la protection contre l’injection de prompt a bloqué une opération ou classé une sortie du débogueur comme non sécurisée.

Cause

La protection contre l’injection d’invite croisée (XPIA) WinDbg a identifié la sortie du débogueur comme potentiellement dangereuse et a bloqué la sortie.

Résolution

  1. Suivez les informations d’erreur que le client IA signale.
  2. Examinez directement la sortie pertinente dans WinDbg.
  3. Traitez la sortie comme non fiable et n’envoyez pas la sortie bloquée au client IA.
  4. Passez en revue la protection contre l’injection inter-invite avant de décider comment continuer.

La classification d’injection de prompt ne peut pas s’exécuter, car le client d’IA ne prend pas en charge ou n’autorise pas l’échantillonnage MCP

Le client IA signale que la classification de l’injection de prompt ne peut pas s’exécuter et que l’opération protégée échoue sans retourner de sortie.

Cause

Le client IA ne prend pas en charge l’échantillonnage MCP, ou sa configuration ou la stratégie organisationnelle ne permet pas l’échantillonnage MCP. La protection WinDbg XPIA nécessite l’échantillonnage MCP pour demander une classification au service de modèle configuré du client.

Résolution

  1. Vérifiez que le client IA prend en charge l’échantillonnage MCP.
  2. Vérifiez que la configuration du client et votre stratégie organisationnelle autorisent l’échantillonnage MCP.
  3. Une fois l’échantillonnage effectué, réexécutez l’opération.
  4. Si la classification ne peut toujours pas s’exécuter, passez en revue la protection contre l’injection inter-invites et contactez l’administrateur qui gère la stratégie du client IA.

Vérifier la connexion MCP WinDbg et signaler des problèmes non résolus

  • Dernière mise à jour :