Solucionar problemas de configuración y conexión de MCP de WinDbg

Utiliza este artículo cuando Visual Studio Code con GitHub Copilot o la CLI de GitHub Copilot no puedan registrar el servidor del Protocolo de contexto de modelo (MCP) de WinDbg, no puedan conectarse a una sesión MCP de WinDbg o los controles de seguridad del MCP de WinDbg bloqueen una operación. Registrar agrega el servidor MCP de WinDbg a la configuración del cliente de IA, mientras que conectar asocia el cliente a una sesión específica de WinDbg.

Para obtener instrucciones de configuración, consulta Instalar y habilitar el MCP de WinDbg. Para obtener instrucciones de privacidad y seguridad autoritativas, consulte Consideraciones de privacidad y seguridad de MCP de WinDbg.

Comience con el síntoma que observe, identifique la causa probable y complete los pasos de resolución.

Lista de comprobación para la solución de problemas

Para problemas de registro del servidor MCP:

  1. Abra WinDbg. No es necesario cargar ni asociar a un destino de depuración para usar Habilitar servidor o instalar MCP.
  2. Abra la configuración del servicio MCP y confirme que ha seleccionado Habilitar servidor.
  3. Confirme que seleccionó Visual Studio Code o GitHub Copilot CLI como cliente.

Para problemas de conexión o sesión:

  1. Inicie el servicio MCP en la ventana winDbg prevista.
  2. Si estás analizando un objetivo, carga o conéctate al objetivo de depuración según sea necesario.

La lista de servidores MCP no incluye WinDbg

La lista de servidores MCP del cliente de IA compatible no incluye WinDbg.

Causa

Install MCP no registró WinDbg con el cliente o el cliente no ha vuelto a cargar su configuración del servidor MCP.

Resolution

  1. Reinicie el cliente de IA y, a continuación, compruebe su lista de servidores MCP.
  2. En WinDbg, abra la configuración del servicio MCP y seleccione el cliente compatible correcto.
  3. Vuelva a seleccionar Instalar MCP .
  4. Completa cualquier confirmación que muestre el cliente.
  5. Reinicie el cliente y, a continuación, vuelva a comprobar su lista de servidores MCP.

Si WinDbg sigue sin aparecer porque falla la instalación de MCP, registra WinDbg manualmente.

Registrar manualmente un cliente compatible

Use esta alternativa solo cuando Install MCP no registre WinDbg con Visual Studio Code o GitHub Copilot CLI.

  1. En WinDbg, abra la configuración del servicio MCP.
  2. Seleccione Personalizado para mostrar la configuración del proxy. Al seleccionar Personalizado en este paso, solo se proporciona el comando proxy para la configuración de cliente compatible.
  3. Seleccione Copiar al portapapeles y anote la command ruta que WinDbg copia al portapapeles.

Configure el cliente compatible:

  1. En el área de trabajo, agregue el servidor WinDbg a .vscode/mcp.json. Sustituya el valor de ejemplo command por la ruta del portapapeles:

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

  2. Reinicie Visual Studio Code.

Una vez reiniciado el cliente, consulte Comprobación de la conexión mcP de WinDbg.

GitHub Copilot no puede encontrar la sesión de WinDbg prevista

Visual Studio Code con GitHub Copilot y GitHub Copilot CLI no encuentra la sesión de WinDbg que contiene el destino de depuración previsto.

Causa

El servicio MCP no se ejecuta en la ventana winDbg prevista o hay más de una sesión de WinDbg disponible y el proxy no puede seleccionar una sesión automáticamente.

Resolution

  1. En la ventana WinDbg prevista, seleccione Servicio MCP.
  2. Pida al cliente de IA que use list_sessions.
  3. Identifique el identificador de proceso de la sesión de WinDbg prevista.
  4. Pida al cliente de IA que use connect_session con ese identificador de proceso.
  5. Confirme que el tipo de destino y el estado de ejecución que notifica el cliente coinciden con los de la ventana winDbg prevista.

Para obtener más instrucciones de selección de sesión, consulte Administrar sesiones de WinDbg.

La sesión de WinDbg no está disponible porque otro cliente está conectado

La sesión de WinDbg prevista no está disponible cuando el cliente de IA muestra las sesiones o intenta conectarse.

Causa

Otro cliente de IA tiene una conexión activa a la sesión de WinDbg. Solo un cliente MCP activo puede conectarse a una sesión de WinDbg a la vez.

Resolution

  1. En el cliente de IA conectado, pida al cliente que use disconnect_session.
  2. Confirme que el cliente informa de que se desconectó de la sesión de WinDbg.
  3. En el cliente de IA previsto, pida al cliente que use list_sessions.
  4. Pida al cliente objetivo que use connect_session con el identificador de proceso de la sesión de WinDbg.
  5. Confirme que el cliente informa de una conexión a la sesión prevista.

Acceso denegado cuando WinDbg está con privilegios elevados

Se produce un error en la conexión con un mensaje de acceso denegado cuando WinDbg se ejecuta como administrador.

Causa

La sesión de WinDbg con privilegios elevados impide que el cliente de IA compatible se conecte a través del proxy.

Resolution

  1. Cierre la instancia de WinDbg con privilegios elevados.
  2. Inicie WinDbg sin seleccionar Ejecutar como administrador.
  3. Inicie el servicio MCP.
  4. Cargue o adjunte al destino de depuración según sea necesario.
  5. Abra el cliente de IA compatible y complete los pasos descritos en Comprobación de la conexión MCP de WinDbg.

La protección contra la inyección de instrucciones bloquea una operación

El cliente de IA informa de que la protección contra la inyección de prompts bloqueó una operación o clasificó la salida del depurador como no segura.

Causa

La protección contra ataques de inyección entre comandos (XPIA) de WinDbg identificó la salida del depurador como potencialmente insegura y la bloqueó.

Resolution

  1. Consulte la información del error que informa el cliente de IA.
  2. Revise la salida pertinente directamente en WinDbg.
  3. Trate la salida como que no es de confianza y no envíe la salida bloqueada al cliente de IA.
  4. Revise la protección contra la inyección entre prompts antes de decidir cómo continuar.

La clasificación de inyección de prompts no se puede ejecutar porque el cliente de IA no admite ni permite el muestreo de MCP

El cliente de IA informa de que la clasificación de inyección de prompts no se puede ejecutar y la operación protegida produce un error sin devolver la salida.

Causa

El cliente de IA no admite el muestreo de MCP o su configuración o directiva organizativa no permite el muestreo de MCP. La protección XPIA de WinDbg requiere el muestreo de MCP para solicitar la clasificación al servicio de modelos configurado del cliente.

Resolution

  1. Confirme que el cliente de IA admite el muestreo de MCP.
  2. Confirme que la configuración del cliente y la directiva de su organización permiten el muestreo de MCP.
  3. Después de que el muestreo esté disponible, vuelva a ejecutar la operación.
  4. Si la clasificación todavía no se puede ejecutar, revise Protección contra la inyección entre prompts y póngase en contacto con el administrador que administra la directiva del cliente de IA.

Compruebe la conexión MCP de WinDbg y notifique problemas sin resolver.

  • Se actualizó por última vez el