Configuración de una lista de elementos permitidos para un servidor MCP en su empresa

Información sobre las listas de elementos permitidos

Puede definir una lista de permitidos y una lista de denegación para controlar qué servidores MCP pueden ejecutar los usuarios de su empresa en clientes y espacios aislados en la nube de Copilot. Estas listas se definen en el managed-settings.json de su empresa, que puede almacenar en GitHub. Para obtener más información, vea Uso del servidor MCP en su empresa.

allowedMcpServers y deniedMcpServers se aplican a los servidores MCP definidos en la configuración de usuario y la configuración del repositorio, pero no se aplican a los servidores MCP definidos en los perfiles de agente personalizados del repositorio. Sin embargo, puede impedir el uso de servidores MCP configurados en perfiles de agente personalizados asegurándose de que los dominios necesarios para iniciarlos no están permitidos por el firewall personalizado de nivel de repositorio o organización. Consulte Personalización o deshabilitación del firewall para GitHub Copilot.

Estos controles también se aplican a Copilot los conectores de los clientes que admiten la configuración administrada de MCP. Si define una lista de permitidos, los usuarios solo pueden usar conectores cuyas direcciones URL coincidan con una entrada de lista de permitidos. Consulte Permitir el uso de Copilot conectores.

Requisitos previos

• Para que los servidores MCP se ejecuten, los servidores MCP de la Copilot directiva deben estar habilitados para su empresa o para organizaciones en las que se deben permitir los servidores MCP.
• Si actualmente restringe los servidores MCP a un registro personalizado, recomendamos desactivar esta restricción para evitar conflictos con su nueva lista de elementos permitidos y mantener una única fuente fiable. Establezca la directiva Restringir el acceso de MCP a los servidores del Registro en Permitir todo y, opcionalmente, borre el valor de dirección URL del Registro de MCP.

Puede encontrar estos ajustes en la sección MCP de sus Copilot directivas. Consulte Administración de directivas y características para GitHub Copilot en su empresa.

Definición de una lista de permitidos o una lista de denegación

1. Cree un managed-settings.json archivo para su empresa. La mayoría de las empresas almacenan este archivo en un .github-private repositorio. También puede instalarlo directamente en las máquinas de los usuarios mediante la administración de dispositivos móviles. Consulte Elección de cómo implementar la configuración administrada por la empresa para los usuarios.

2. Edite el archivo para definir una lista de permitidos y una lista de denegación para los servidores MCP. Puede coincidir por nombre, dirección URL del servidor o comandos específicos. Para más información sobre la sintaxis, consulte allowedMcpServers y deniedMcpServers en "Configuración administrada de empresa".

   En el ejemplo siguiente se permiten servidores que coincidan con cualquiera de las tres entradas de la lista de permitidos. El servidor de sistema de archivos configurado para acceder al sistema de archivos raíz siempre está bloqueado, aunque también coincida con una entrada de la lista de permitidos.

   JSON

   {
     "allowedMcpServers": [
       { "serverUrl": "https://api.githubcopilot.com/*" },
       { "serverCommand": ["npx", "@playwright/mcp@latest"] },
       { "serverCommand": ["cmd", "/c", "uvx", "markitdown-mcp"] }
     ],
     "deniedMcpServers": [
       {
         "serverCommand": [
           "npx",
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/"
         ]
       }
     ]
   }
   

Permitir los Copilot conectores

Copilot Los conectores son servidores MCP remotos, por lo que se permiten o se bloquean con entradas serverUrl. Si no define allowedMcpServers, se permiten conectores a menos que coincidan con una deniedMcpServers entrada y no es necesario agregarlos. Si define allowedMcpServers, los conectores se bloquean a menos que sus direcciones URL coincidan con una entrada.

Para permitir todos los conectores, incluidos los conectores agregados en el futuro, agregue la siguiente entrada comodín a la lista existente allowedMcpServers .

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/*/mcp" }
  ]
}

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/*/mcp" }
  ]
}

Para permitir solo conectores específicos, agregue una entrada para la dirección URL de cada conector en su lugar. Para obtener la dirección URL de cada conector, consulte Direcciones URL de cada conector. Por ejemplo, las siguientes entradas permiten los conectores Slack y Sentry.

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/githubcopilotslackmcp/mcp" },
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/githubcopilotsentrymcp/mcp" }
  ]
}

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/githubcopilotslackmcp/mcp" },
    { "serverUrl": "https://api.github.com/copilot-connectors/api/v1/connectors/githubcopilotsentrymcp/mcp" }
  ]
}

En estos ejemplos solo se muestran las entradas del conector. Mantenga las demás entradas en la lista de permitidos, ya que se bloquea cualquier servidor MCP que no coincida con una entrada.

Para bloquear conectores específicos, agregue sus direcciones URL a deniedMcpServers. Dado que las reglas de denegación tienen prioridad, puede combinar la entrada de la lista de permitidos comodín con entradas de la lista de denegación para permitir todos los conectores excepto los que bloquee. Para bloquear todos los conectores, agregue la dirección URL de carácter comodín a deniedMcpServers.

Direcciones URL del conector

Reglas de evaluación

Copilot los clientes evalúan los servidores MCP en este orden:

1. Permitir siempre servidores predeterminados integrados, como el servidor MCP integrado GitHub .
2. Bloquee el servidor si coincide con cualquier entrada en deniedMcpServers.
3. Si allowedMcpServers está presente, bloquee el servidor si no coincide con una entrada.
4. Bloquee el servidor si su dirección URL o comando contiene una variable sin resolver, como ${VARIABLE} o $VARIABLE, porque el cliente no puede comprobar el servidor.

Si un cliente recibe la configuración de varios managed-settings.json métodos de implementación, se aplicará toda la configuración. Una regla de denegación de cualquier fuente bloquea el servidor y un servidor debe coincidir con una entrada de la lista de permitidos en cada capa que defina una.

Si una lista de permitidos o una lista de denegación tiene un formato incorrecto (por ejemplo, tiene JSON no válido), el cliente trata la directiva como una lista vacía allowedMcpServers . Esto bloquea todos los servidores excepto los servidores predeterminados integrados.

Si el cliente no puede determinar una capa de directiva debido a un error de recuperación o detección de dispositivos, conserva la directiva aplicada anteriormente. La directiva efectiva puede ser más restrictiva, pero no menos restrictiva.