Protocolo de contexto de modelo (MCP)

Conéctese Copilot a herramientas externas y datos a través de servidores de Model Context Protocol (MCP).

En este artículo

Información general del Protocolo de contexto de modelo (MCP)

El Protocolo de contexto de modelo (MCP) es un estándar abierto que define cómo las aplicaciones comparten contexto con modelos de lenguaje grandes (LLM). MCP proporciona una manera estandarizada de conectar modelos de inteligencia artificial a diferentes orígenes de datos y herramientas, lo que les permite trabajar de manera conjunta de forma más eficaz.

Puede usar MCP para ampliar las funcionalidades de GitHub Copilot mediante la integración con una amplia gama de herramientas y servicios existentes. MCP funciona en todos los principales entornos Copilot , tanto si trabajas en un IDE, como si usas GitHub Copilot CLI, trabajas en GitHub Copilot app o delegas tareas a un agente en GitHub.com. También puede usar MCP para crear nuevas herramientas y servicios que funcionan con Copilot, lo que le permite personalizar y mejorar su experiencia.

Por ejemplo, puede conectar un rastreador de problemas para que Copilot pueda buscar un error mientras trabaja en una corrección, sin pedirle que copie el problema en el chat.

Para más información sobre MCP, consulta la documentación oficial de MCP. Para obtener una lista seleccionada de servidores MCP de asociados y la comunidad, consulte el GitHub Registro de MCP.

Las empresas y las organizaciones pueden optar por habilitar o deshabilitar el uso de MCP para los miembros de su organización o empresa mediante la directiva Servidores MCP en Copilot. Esta directiva está deshabilitada de forma predeterminada. Consulta Administración de directivas y características para GitHub Copilot en su empresa y Administración de directivas y características para GitHub Copilot en su organización. La directiva MCP solo se aplica a los usuarios que tienen una suscripción Copilot Business o Copilot Enterprise de una organización o empresa que configura la directiva. Copilot Free, Copilot Pro, Copilot Pro+o Copilot Maxno tienen su acceso MCP regido por esta directiva.

MCP complementa el contexto que se proporciona a través de mensajes, archivos e instrucciones. Agrega conexiones a herramientas y datos, en lugar de reemplazar instrucciones sobre cómo debe funcionar el agente. Para obtener instrucciones sobre cómo crear prompts y administrar el contexto, consulte Indicaciones y contexto para GitHub Copilot.

Conecte un servicio una vez mediante servidores MCP (conectores) verificados por GitHub y, a continuación, use la conexión entre superficies admitidas Copilot sin repetir la instalación ni iniciar sesión por separado en cada una de ellas. Estas conexiones también funcionan en Copilot sesiones que se ejecutan en un espacio aislado en la nube, pero no en sesiones que se ejecutan en GitHub Actions. Consulte conectores de Copilot.

Dónde puede usar MCP

La configuración de MCP depende de dónde uses Copilot:

  • El GitHub Copilot app: puede usar servidores MCP configurados para su repositorio o en su configuración local de Copilot. También puede descubrir e instalar servidores MCP adicionales desde la pestaña Personalizar.
  • Copilot CLI: GitHub Copilot CLI admite servidores MCP locales y remotos. El GitHub servidor MCP está integrado y disponible sin configuración adicional.
  • Copilot cloud agent (incluyendo automations) y Copilot code review: GitHub.com admite servidores MCP configurados en el nivel de repositorio. La configuración se aplica a Copilot cloud agent, automations y Copilot code review. El servidor GitHub MCP y el servidor Playwright MCP están configurados de forma predeterminada.
  • IDE: los servidores MCP se admiten en Visual Studio Code, Visual Studio, IDEs de JetBrains, Xcode y Eclipse. Las opciones de conexión y autenticación dependen del IDE. Consulte Extensión del chat de Copilot de GitHub con servidores de Protocolo de contexto de modelo (MCP).

Chat en GitHub.com tiene herramientas preconfiguradas, como herramientas para crear ramas y buscar código. Esto es distinto de la configuración de MCP del repositorio para Copilot cloud agent y Copilot code review. Consulte GitHub Copilot en GitHub.com y GitHub Mobile.

MCP para Copilot cloud agent

Las secciones siguientes describen los valores predeterminados y la configuración de MCP para Copilot cloud agent, incluido automations. La configuración de MCP de nivel de repositorio también se aplica a Copilot code review, como se indica a continuación. Para otras superficies, use las guías de configuración en Pasos siguientes.

Servidores MCP predeterminados

Copilot cloud agent comienza con dos servidores MCP configurados:

  • GitHub proporciona acceso a los datos del repositorio, como incidencias y solicitudes de extracción. De forma predeterminada, usa un token con ámbito especial con acceso de solo lectura al repositorio actual. El acceso fuera de ese repositorio requiere configurar explícitamente las credenciales con acceso más amplio.
  • Playwright proporciona herramientas para leer, interactuar con y tomar capturas de pantalla de páginas web. De forma predeterminada, solo puede acceder a los recursos web en el propio entorno del agente a través de localhost o 127.0.0.1.

Estos valores predeterminados son específicos del entorno de nube. Por ejemplo, Copilot CLI incluye el servidor MCP GitHub sin configuración adicional, pero configuras otros servidores por separado.

Servidores MCP personales

Los servidores MCP personales se conectan Copilot a herramientas y datos para tu propio flujo de trabajo. Configure un servidor una vez para que esté disponible en todas las sesiones en la nube que inicie. Estos servidores solo están disponibles para usted y no afectan a otros usuarios que trabajan en el mismo repositorio.

Antes de configurar un servidor MCP personal, compruebe si el servicio que necesita está cubierto por servidores MCP verificados por GitHub (conectores). Los servidores MCP verificados por GitHub están disponibles tanto en sesiones en la nube como en sesiones locales, y GitHub se encarga de la configuración y la autenticación del servidor MCP por ti. Por el contrario, los servidores MCP personales solo admiten la autenticación basada en claves y solo están disponibles en espacios aislados en la nube. Consulte conectores de Copilot.

Use servidores MCP personales para las conexiones que desee entre repositorios o que requieran sus propias credenciales. Para proporcionar una configuración compartida para los colaboradores que trabajan en un repositorio determinado, use la configuración de nivel de repositorio en su lugar.

  1. Vaya a la Copilot página principal en github.com/copilot.
  2. En el menú de la izquierda, haga clic en el menú Personalizar .
  3. Compruebe si el servicio que necesita está cubierto por un GitHubservidor MCP verificado.
  4. Si un GitHubservidor MCP comprobado no cubre sus necesidades y desea configurar su propio servidor MCP, seleccione el menú desplegable Agregar y, a continuación, haga clic en Servidor MCP.
  5. Escriba el nombre del servidor, el tipo de transporte, la dirección URL o el comando de inicio y otra configuración necesaria.
  6. Si se requiere autenticación, cree secretos en Personal MCP server secrets con nombres con el prefijo COPILOT_MCP_, como COPILOT_MCP_API_KEY, y haga referencia a ellos en la configuración del servidor.
  7. Haga clic en Agregar servidor.

De forma predeterminada, los secretos personales del servidor MCP están disponibles en sesiones en el ámbito de su cuenta personal. También puede permitir su uso en organizaciones seleccionadas para que utilicen allí sus servidores autenticados.

Limitations

  • Los servidores MCP personales están disponibles en cada sesión en la nube. Actualmente no puede elegir qué servidores habilitar para una sesión individual.
  • Los servidores MCP de HTTP y SSE personalizados no admiten parámetros de consulta en sus direcciones URL. Pase estos valores como encabezados de solicitud en su lugar.
  • Si un servidor no está disponible, compruebe su configuración y confirme que existen secretos necesarios y que están disponibles para la cuenta u organización donde se ejecuta la sesión.
  • Puede usar hasta 50 servidores MCP en total en configuraciones personales y de nivel de repositorio.

Configuración de nivel de repositorio

Los servidores MCP de nivel de repositorio conectan Copilot a los agentes de IA con herramientas y datos para trabajar en un repositorio específico. Los administradores del repositorio configuran estos servidores en la configuración del repositorio en GitHub.comy la configuración está disponible para cualquier persona con acceso de escritura al repositorio. Esta configuración se aplica tanto a Copilot in the cloud (incluido automations) como a Copilot code review. Puede deshabilitar por separado el uso de la herramienta MCP para revisar el código.

Use la configuración a nivel de repositorio cuando los colaboradores necesiten las mismas herramientas, como un rastreador de incidencias compartido o un servicio de documentación. En el caso de los servidores que requieren autenticación, use una cuenta de servicio para Copilot en lugar de credenciales personales. Los servidores de nivel de repositorio no pueden hacer referencia a secretos personales del servidor MCP.

Puede usar servidores personales y de nivel de repositorio juntos. Si ambas configuraciones definen un servidor con el mismo nombre, la configuración de nivel de repositorio tiene prioridad.

Esta configuración de repositorio es distinta de los archivos de configuración de MCP del proyecto usados por Copilot CLI. Utilice la guía de configuración de Surface en lugar de asumir que la misma ubicación de la configuración se aplica en todas partes.

Automations puede usar herramientas de estos servidores MCP, pero solo las herramientas que seleccionas para cada automation. Consulte automatizaciones de Copilot.

Advertencia

Cuando delegas trabajo en Copilot, ya sea @mentioning o asignándole una incidencia o una solicitud de incorporación de cambios, Copilot usa herramientas de MCP configuradas de forma autónoma y no solicita aprobación antes de llamarlas. Para estos flujos de trabajo, revise cada servidor y permita solo las herramientas y el acceso necesarios para sus tareas.

Al configurar servidores MCP para su uso por Copilot cloud agent y Copilot code review, tenga en cuenta lo siguiente:

  • Copilot cloud agent y Copilot code review solo admiten herramientas de MCP. Actualmente no admiten recursos ni avisos proporcionados por el servidor MCP.
  • En el caso de los servidores MCP configurados en la configuración del repositorio o perfiles de agente personalizados, Copilot cloud agent y Copilot code review actualmente no admiten servidores remotos que usen OAuth para la autenticación y autorización.

Copilot code review además, se requieren herramientas para declarar annotations.readOnlyHint: true. Las herramientas con esta anotación falta o se establecen en false se excluyen.

Para conocer los procedimientos de configuración, autenticación y validación, consulte Configuración de servidores MCP para el repositorio.

Servidores MCP para agentes personalizados

Para Copilot cloud agent, un perfil de agente puede definir servidores MCP para ese agente personalizado, en lugar de ponerlos a disposición de todos los agentes que trabajan en el repositorio. Los agentes personalizados que se ejecutan directamente en los IDE no usan la mcp-servers propiedad profile.

Para Copilot cloud agent, las configuraciones de servidor predeterminadas se procesan primero, luego las configuraciones de agente personalizadas y, a continuación, las opciones del repositorio. Las configuraciones posteriores pueden invalidar la configuración anterior. Este orden no describe la precedencia del archivo de proyecto en Copilot CLI.

Para ver el formato de perfil, las propiedades admitidas y las reglas de procesamiento, consulte Configuración de agentes personalizados.

Prácticas recomendadas

  • Revise los servidores de terceros antes de habilitarlos. Compruebe sus herramientas, requisitos de autenticación y acceso a los datos en función de los requisitos de su organización.
  • Habilite solo las herramientas que una tarea necesita. En la configuración del repositorio, use el campo tools para incluir herramientas específicas en la lista de permitidas, preferiblemente herramientas de solo lectura, en lugar de habilitar todas las herramientas. En automations, elija las herramientas específicas que necesita.
  • Mantenga las credenciales limitadas a los recursos necesarios. No amplíe el acceso del token predeterminado para Copilot cloud agent, a menos que la tarea lo necesite.
  • Valide la configuración antes de confiar en ella. Confirme qué servidores y herramientas están disponibles en su sesión de agente. Para obtener instrucciones de configuración para su entorno, consulte Pasos siguientes.

Acerca del GitHub servidor MCP

El GitHub servidor MCP es un servidor de Protocolo de contexto de modelo (MCP) proporcionado y mantenido por GitHub.

GitHub El servidor MCP se puede usar para:

  • Automatice y optimice las tareas relacionadas con el código.
  • Conecte herramientas de terceros (como Cursor, Windsurf o integraciones futuras) para aprovechar GitHublas funcionalidades de contexto e inteligencia artificial.
  • Habilitar los flujos de trabajo basados en la nube que funcionan desde cualquier dispositivo, sin configuración local.
  • Invoque GitHub herramientas, como Copilot cloud agent (requiere GitHub Copilot suscripción) y code scanning (requiere GitHub Advanced Security suscripción) para ayudar con la generación de código y el análisis de seguridad.

Para obtener información sobre cómo usar el GitHub servidor MCP, consulte Uso del servidor MCP de GitHub en el IDE.

Para averiguar si el editor admite el GitHub servidor MCP y qué métodos de conexión y autenticación están disponibles, consulte Compatibilidad con la aplicación host en el github/github-mcp-server repositorio.

Acceso remoto

Puede acceder remotamente al GitHub servidor MCP a través de Copilot Chat en Visual Studio Code sin ninguna configuración local. El servidor remoto tiene acceso a conjuntos de herramientas adicionales solo disponibles en el servidor MCP remoto GitHub . Para obtener una lista de estas herramientas, consulte Conjuntos de herramientas adicionales en el github/github-mcp-server repositorio.

El GitHub servidor MCP también se puede ejecutar localmente en cualquier editor compatible con MCP, si es necesario.

Personalización del conjunto de herramientas

Importante

Revise siempre el repositorio del GitHub servidor MCP en github/github-mcp-server para ver los conjuntos de herramientas más recientes y las instrucciones de configuración autoritativas.

El GitHub servidor MCP admite la habilitación o deshabilitación de grupos específicos de funcionalidades a través de conjuntos de herramientas. Los conjuntos de herramientas permiten controlar qué GitHub funcionalidades de API están disponibles para las herramientas de inteligencia artificial.

Habilitar solo los conjuntos de herramientas que necesita mejora el rendimiento y la seguridad del asistente de INTELIGENCIA ARTIFICIAL. Menos herramientas significan una mejor precisión de selección de herramientas y menos errores. Al deshabilitar los conjuntos de herramientas sin usar también se liberan tokens en la ventana de contexto de la inteligencia artificial.

Los conjuntos de herramientas no solo incluyen herramientas, sino también recursos de MCP relevantes y avisos cuando corresponda.

Para obtener información sobre cómo configurar conjuntos de herramientas para el GitHub servidor MCP, consulte Configuración de conjuntos de herramientas para el servidor MCP de GitHub.

Security

Para todos los repositorios públicos y los repositorios privados cubiertos por GitHub Advanced Security, las interacciones con el servidor MCP GitHub están protegidas por la protección de subida, lo que impide la inclusión de secretos en las respuestas generadas por IA y evita que estas se incluyan en las acciones tomadas en su nombre. También puede escanear proactivamente su código en busca de secretos expuestos desde dentro de su agente de codificación de IA. Para obtener más información, vea Examen de secretos con el servidor MCP de GitHub.

Acerca del GitHub Registro MCP

El GitHub Registro MCP es una lista seleccionada de servidores MCP de asociados y de la comunidad. Puedes usar el registro para detectar nuevos servidores MCP y buscar los que satisfagan tus necesidades específicas.

Nota:

El GitHub Registro MCP está actualmente en versión preliminar pública y está sujeto a cambios.

Buscador de agentes

El buscador de agentes es un servicio de detección que ayuda a GitHub Copilot encontrar las funcionalidades adecuadas (como servidores MCP, herramientas, agentes y aptitudes) para una tarea en tiempo de ejecución, en lugar de requerir que todas las funcionalidades se configuren de antemano. Al igual que un registro MCP, busca en un catálogo de funcionalidades y devuelve resultados ordenados por relevancia que GitHub Copilot puede utilizar según sea necesario. El buscador de agentes implementa la especificación open Agentic Resource Discovery (ARD).

Para la Copilot CLI configuración, consulte Uso del buscador de agentes. GitHub Copilot app proporciona una af habilidad integrada. Consulte Habilidades integradas para la aplicación GitHub Copilot. Para examinar el catálogo, consulte GitHub Agent Finder.

Pasos siguientes