Uso de servidores MCP

El Protocolo de contexto de modelo (MCP) es un estándar abierto que permite GitHub Copilot usar herramientas y servicios fuera del IDE. En Visual Studio, MCP permite a GitHub Copilot agentes usar herramientas externas mediante la conexión de clientes MCP a servidores MCP que exponen funcionalidades importantes, como el acceso a archivos, la administración de repositorios o la creación de pr. Al estandarizar cómo se detectan e invocan las herramientas, MCP elimina la necesidad de integraciones personalizadas y facilita la ampliación de los asistentes de inteligencia artificial simplemente mediante la adición de nuevos servidores MCP.

La compatibilidad con MCP mejora el modo de agente de Copilot de GitHub al permitirle conectar cualquier servidor compatible con MCP al flujo de trabajo de codificación agente. La compatibilidad con MCP en Visual Studio funciona de la siguiente manera:

• Los clientes de MCP, como Visual Studio, se conectan a servidores MCP y solicitan acciones en nombre del modelo de IA.
• Los servidores MCP proporcionan una o varias herramientas que exponen funcionalidades específicas a través de una interfaz bien definida.
• El protocolo define el formato de mensaje para la comunicación entre clientes y servidores, incluida la detección de herramientas, la invocación y el control de respuestas.

Por ejemplo, con el servidor MCP de GitHub habilitado, puede hacer que Copilot cree y gestione solicitudes de incorporación de cambios o avisarle si hay solicitudes de incorporación de cambios que se deben revisar. Con el servidor MCP de Azure DevOps habilitado, Copilot puede crear y administrar elementos de trabajo.

Este artículo le guía a través de la configuración de servidores MCP y el uso de herramientas con el modo de agente en Visual Studio.

Prerrequisitos

Visual Studio 2026 O Visual Studio 2022 , versión 17.14 (con la versión de mantenimiento más reciente recomendada para las características de MCP más up-to-date)

Búsqueda de servidores MCP

El repositorio oficial del servidor MCP es un excelente punto de partida para los servidores de referencia, oficiales y colaboradores de la comunidad que muestran la versatilidad de MCP. Puede explorar servidores para diversas funcionalidades, como operaciones del sistema de archivos, interacciones de base de datos y servicios web.

MCP es un estándar relativamente nuevo y el ecosistema está evolucionando rápidamente. A medida que más desarrolladores adoptan MCP, puede esperar ver un número creciente de servidores y herramientas disponibles para la integración con los proyectos.

Agregar un servidor MCP

Tiene varias opciones para agregar un servidor MCP en Visual Studio.

Agregar un servidor MCP directamente desde la web

A partir de la versión de mantenimiento más reciente de la versión 17.14, puede agregar un servidor MCP instalandolo directamente desde la web. Seleccione el botón Install en un servidor MCP para instalarlo automáticamente y agregarlo a la instancia de Visual Studio.

Servidores MCP de ejemplo

Pruebe algunos servidores MCP populares en Visual Studio con un solo clic:

• : descubra e instale avisos personalizados e instrucciones para GitHub Copilot.
• : convierta varios formatos de archivo (PDF, Word, Excel, imágenes, audio) a Markdown.
• : consulte y analice los datos de las bases de datos duckDB localmente y en la nube.
• : operaciones y administración de bases de datos. Ejecute consultas, administre colecciones, canalizaciones de agregación y operaciones de documento.
• : acceda a modelos, conjuntos de datos y espacios en hugging Face Hub.

Agregar un servidor MCP desde el chat

Para agregar un servidor MCP desde la vista de chat:

1. Seleccione el botón verde más (+) del selector de herramientas en la ventana de chat.

   

2. Especifique el nombre del servidor y los detalles de conexión, como la dirección URL de los servidores HTTP o el comando y los argumentos de los servidores stdio.

   

Adición de un servidor MCP desde el registro del servidor MCP de GitHub

Puede instalar un servidor MCP directamente desde el registro del servidor MCP de GitHub a través de extensiones en Visual Studio.

1. En el menú Visual Studio, seleccione Extensions>MCP Registries... para abrir el MCP Administrador del servidor.

   

2. Seleccione el servidor que desee y, a continuación, seleccione Install para la instancia de Visual Studio.

   

Agregar un servidor MCP al .mcp.json archivo

Los pasos siguientes le guiarán a través de un ejemplo de configuración con el servidor MCP de GitHub:

1. Cree un nuevo archivo: <SOLUTIONDIR>\.mcp.json o %USERPROFILE%\.mcp.json. Use Visual Studio para editar este archivo para que se aplique automáticamente su esquema JSON.

2. Pegue el contenido siguiente en el .mcp.json archivo:

   {
     "servers": {
       "github": {
         "url": "https://api.githubcopilot.com/mcp/"
       }
     }
   }
   

3. Guarde el archivo.

4. En el archivo, seleccione Autenticación requerida en CodeLens que aparece para autenticarse en el servidor a través de una cuenta de GitHub. Seleccione Autenticar en el cuadro de diálogo emergente para autenticarse con su cuenta de GitHub.

   

   Si no ve CodeLens, asegúrese de que está habilitado en Herramientas>Opciones>Editor de texto>CodeLens.

5. En la parte inferior del panel de chat, selecciona Agent en la lista desplegable de modo.

   

6. Seleccione las herramientas que desea usar, por ejemplo, Enumerar problemas.

   

   Pruebe un mensaje de ejemplo: Enumere los problemas asignados a mí en GitHub.

7. Copilot solicita permiso para usar una herramienta que el servidor MCP puso a su disposición. Seleccione Permitir con el ámbito con el que desea continuar.

   

Administración de la configuración de servidores MCP

Visual Studio admite el uso de archivos mcp.json para almacenar información de configuración para los servidores MCP. mcp.json los archivos almacenan el nombre de cada servidor, el tipo de transporte (por ejemplo, stdio o SSE), el comando para iniciarlo, los argumentos y las variables de entorno opcionales necesarias para conectarse a ese servidor.

Si aún no tiene un mcp.json archivo, cree uno en cualquiera de las ubicaciones admitidas en función de los requisitos de repositorio, usuario o editor.

Para agregar un servidor MCP, busque la configuración JSON del servidor en línea. Por ejemplo, léelo en el repositorio de GitHub para servidores MCP. Después, péguelo en el mcp.json archivo.

Ubicaciones de archivos para la detección automática de la configuración de MCP

Visual Studio también comprueba si hay configuraciones de MCP configuradas por otros entornos de desarrollo. Lee las configuraciones del servidor MCP de los directorios siguientes, en el orden siguiente:

1. %USERPROFILE%\.mcp.json
   Actúa como una configuración global del servidor MCP para un usuario específico. Agregar un servidor MCP aquí hace que se cargue para todas las soluciones de Visual Studio.
2. <SOLUTIONDIR>\.vs\mcp.json
   Específico de Visual Studio y carga los servidores MCP especificados solo para un usuario específico, para la solución especificada.
3. <SOLUTIONDIR>\.mcp.json
   Funciona bien si busca una configuración de MCP en la que pueda realizar un seguimiento en el control de código fuente de un repositorio.
4. <SOLUTIONDIR>\.vscode\mcp.json
   Se limita al repositorio o solución y normalmente no se controla el origen.
5. <SOLUTIONDIR>\.cursor\mcp.json
   Se limita al repositorio o solución y normalmente no se controla el origen.

Algunas de estas ubicaciones requieren .mcp.json, mientras que otras requieren mcp.json.

Formato de configuración de MCP

Puede definir servidores remotos (URL y credenciales) y locales (invocación de línea de comandos).

Es habitual invocar herramientas a través de administradores de paquetes. Por ejemplo, use npx -y @azure/mcp@latest o docker run ... mcp/github. Visual Studio respeta el comando que especifique, por lo que puede anclar versiones o pasar indicadores según sea necesario.

El formato debe seguir la especificación MCP. Por ejemplo, debe incluir una matriz de objetos de servidor, cada uno con name, command o urly transport.

Edición de la configuración de MCP

Si tiene un archivo existente mcp.json y comprueba el archivo en el sistema de control de versiones, agregue la ubicación del archivo a elementos de solución en el Explorador de soluciones.

Al guardar el archivo con sintaxis válida, el agente de GitHub Copilot se reinicia y vuelve a cargar los servidores configurados.

Ciclo de vida de las herramientas

Tan pronto como Visual Studio detecta o agrega un servidor:

• Inicializa el servidor mediante un protocolo de enlace y consultando la lista de herramientas.
• Se suscribe al evento notifications/tools/list_changed de MCP.
• Cuando se activa ese evento, Visual Studio restablece las autorizaciones o permisos anteriores en las herramientas (para evitar ataques de rug-pull o salida fraudulenta), recupera la lista de herramientas, ajusta el número y actualiza la interfaz de usuario en tiempo real.
• Cuando Visual Studio habilita correctamente el servidor, el agente hace que las herramientas estén disponibles. Las herramientas están deshabilitadas de forma predeterminada y debe habilitarlas manualmente.
• Si quita un servidor, Visual Studio detiene inmediatamente su proceso y retira todas sus herramientas de la interfaz de usuario.
• Si edita una definición de servidor, Visual Studio finaliza y lo reinicia y, a continuación, vuelve a realizar consultas.

Administración de aprobaciones de herramientas

Al invocar una herramienta, Copilot solicita confirmación para ejecutar la herramienta. El motivo es que las herramientas se pueden ejecutar localmente en la máquina y realizar acciones que modifiquen archivos o datos.

Administración de la autorización

Visual Studio ahora admite la autenticación para servidores remotos mediante cualquier proveedor de OAuth, de acuerdo con la especificación de autorización de MCP. Esta compatibilidad se suma a la integración con la cadena de claves de Visual Studio.

Para administrar la autenticación de un servidor MCP:

1. En el .mcp.json archivo, seleccione Administrar autenticación para ese servidor en CodeLens.

2. Proporcione credenciales para el proveedor de OAuth necesario para ese servidor en el cuadro de diálogo emergente del explorador.

Instrucciones y plantillas de instrucciones de MCP

Los servidores MCP pueden proporcionar plantillas de solicitud reutilizables que le ayudarán a interactuar de forma más eficaz con los modelos de lenguaje. Estas solicitudes se adaptan a tareas específicas y pueden incluir argumentos personalizables.

Utilice mensajes de MCP

Para hacer referencia a indicaciones desde un servidor MCP:

1. Seleccione + Agregar referencia en el chat.
2. Seleccione Indicaciones>indicaciones del MCP.
3. Elija una instrucción y seleccione Insertar instrucción.

Algunos avisos incluyen argumentos que puede personalizar antes de insertarlos en el chat. Estos avisos se denominan plantillas de aviso.

Ejemplo: El servidor MCP de GitHub proporciona mensajes para analizar las solicitudes de incorporación de cambios, generar mensajes de confirmación y revisar los cambios de código.

Recursos y plantillas de recursos de MCP

Los recursos de MCP proporcionan contexto a los modelos de lenguaje, como archivos, esquemas de base de datos o datos específicos de la aplicación. Cada recurso tiene un URI único al que puede hacer referencia en el chat.

Uso de recursos de MCP

Haga referencia a los recursos de MCP en el chat de Copilot mediante un hashtag (#) seguido del URI del recurso.

Para recursos con argumentos (plantillas de recursos):

1. Seleccione + Agregar referencia en el chat.
2. Seleccione Recursos de MCP.
3. Elija el recurso, rellene los argumentos necesarios y seleccione Agregar recurso.

Ejemplo: El servidor MCP de Azure DevOps expone recursos de elementos de trabajo, información de sprint y datos de capacidad de equipo para tareas de planeación de proyectos.

Ejemplo: El servidor MCP figma proporciona acceso a los recursos de componentes de diseño, las guías de estilo y las especificaciones de diseño.

Muestreo de MCP

Mediante el muestreo, los servidores MCP pueden realizar llamadas LLM por usted, lo que permite operaciones más complejas y de varios pasos. Visual Studio admite automáticamente el muestreo si el servidor MCP lo proporciona.

Cuando Copilot necesita realizar una llamada de muestreo, verá un cuadro de diálogo de confirmación. Revise los detalles y apruebe antes de que continúe la acción, asegurándose de mantener el control sobre las operaciones automatizadas.

Ejemplo: El servidor MCP de Playwright usa el muestreo para generar escenarios de prueba basados en la estructura DOM y los flujos de usuario de la aplicación.

Preguntas más frecuentes

Como administrador, ¿cómo puedo controlar el uso de servidores MCP en modo de agente para los usuarios de Visual Studio?

La configuración de directiva de GitHub en el panel de GitHub Copilot para administradores controla el modo de agente y el uso de MCP en Visual Studio. Si el administrador desactiva esta configuración, los usuarios de esa suscripción no pueden usar el modo de agente ni conectarse a servidores MCP en Visual Studio.

Para obtener más información, consulte Administración de directivas y características para GitHub Copilot en su empresa.

Contenido relacionado

• Modo de agente de GitHub Copilot
• Solución de chat de GitHub Copilot para Visual Studio
• Controles de administración para GitHub Copilot
• GitHub Copilot Gratis