엔터프라이즈에 대한 MCP 서버 허용 목록 구성

허용 목록에 대해

허용 목록 및 거부 목록을 정의하여 엔터프라이즈의 사용자가 Copilot 클라이언트 및 클라우드 샌드박스에서 실행할 수 있는 MCP 서버를 제어할 수 있습니다. 이러한 목록은 엔터프라이즈의 managed-settings.json에 정의되며, 이를 GitHub에 저장할 수 있습니다. 자세한 내용은 회사의 MCP 서버 사용량을(를) 참조하세요.

allowedMcpServers 및 deniedMcpServers는 사용자 설정 및 리포지토리 설정에 정의된 MCP 서버에 적용되지만, 리포지토리 사용자 지정 에이전트 프로필에 정의된 MCP 서버에는 적용되지 않습니다. 그러나 조직 또는 리포지토리 수준의 사용자 지정 방화벽에서 MCP 서버를 시작하는 데 필요한 도메인이 허용되지 않도록 하여 사용자 지정 에이전트 프로필에 구성된 MCP 서버의 사용을 방지할 수 있습니다. GitHub Copilot 방화벽 사용자 지정 또는 비활성화을(를) 참조하세요.

이러한 컨트롤은 MCP 관리 설정을 지원하는 클라이언트의 Copilot 커넥터에도 적용됩니다. 허용 목록을 정의하는 경우 URL이 허용 목록 항목과 일치하는 커넥터만 사용할 수 있습니다. "커넥터 허용"을 Copilot참조하세요.

필수 조건

• MCP 서버를 실행하려면 엔터프라이즈 또는 MCP 서버를 허용해야 하는 조직에 대해 Copilot의 MCP 서버 정책을 사용하도록 설정해야 합니다.
• 현재 MCP 서버를 사용자 지정 레지스트리로 제한하는 경우 새 허용 목록과의 충돌을 방지하고 단일 원본을 유지 관리하려면 이 제한을 해제하는 것이 좋습니다. 레지스트리 서버 정책에 대한 MCP 액세스 제한 정책을 모두 허용으로 설정하고 필요에 따라 MCP 레지스트리 URL의 값을 지웁다.

이러한 설정은 정책의 MCP 섹션에서 찾을 수 있습니다 Copilot . 기업에서 GitHub Copilot에 대한 정책 및 기능 관리을(를) 참조하세요.

허용 목록 또는 거부 목록 정의

1. 엔터프라이즈용 managed-settings.json 파일을 만듭니다. 대부분의 기업에서는 이 파일을 리포지토리에 .github-private 저장합니다. 모바일 디바이스 관리를 사용하여 사용자의 컴퓨터에 직접 설치할 수도 있습니다. 사용자에게 엔터프라이즈 관리 설정을 배포하는 방법 선택을(를) 참조하세요.

2. 파일을 편집하여 MCP 서버에 대한 허용 목록 및 거부 목록을 정의합니다. 이름, 서버 URL 또는 특정 명령을 사용하여 일치시킬 수 있습니다. 구문 세부 정보는 "엔터프라이즈 관리 설정"에서 allowedMcpServers 및 deniedMcpServers 를 참조하세요.

   다음 예제에서는 세 가지 허용 목록 항목 중 하나와 일치하는 서버를 허용합니다. 루트 파일 시스템에 액세스하도록 구성된 파일 시스템 서버는 허용 목록 항목과 일치하더라도 항상 차단됩니다.

   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",
           "/"
         ]
       }
     ]
   }
   

커넥터를 허용 Copilot

Copilot 커넥터는 원격 MCP 서버이므로 serverUrl 항목으로 허용하거나 차단합니다. allowedMcpServers을 정의하지 않으면 커넥터는 deniedMcpServers 항목과 일치하는 경우를 제외하고 허용되며 추가할 필요가 없습니다. allowedMcpServers 정의하는 경우 해당 URL이 항목과 일치하는 경우가 아니면 커넥터가 차단됩니다.

나중에 추가되는 커넥터를 포함하여 모든 커넥터를 허용하려면 기존 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" }
  ]
}

특정 커넥터만 허용하려면 각 커넥터의 URL에 대한 항목을 대신 추가합니다. 각 커넥터의 URL은 커넥터 URL을 참조하세요. 예를 들어 다음 항목은 Slack 및 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" }
  ]
}

다음 예제에서는 커넥터 항목만 보여 줍니다. 항목과 일치하지 않는 MCP 서버가 차단되므로 허용 목록에 다른 항목을 유지하세요.

특정 커넥터를 차단하려면 해당 URL을 deniedMcpServers에 추가합니다. 거부 규칙이 우선하기 때문에 와일드카드 허용 목록 항목을 거부 목록 항목과 결합하여 차단한 커넥터를 제외한 모든 커넥터를 허용할 수 있습니다. 모든 커넥터를 차단하려면 와일드카드 URL을 deniedMcpServers에 추가합니다.

커넥터 URL들

평가 규칙

Copilot 클라이언트는 다음 순서대로 MCP 서버를 평가합니다.

1. 기본 제공 MCP 서버와 같은 기본 제공 GitHub 서버는 항상 허용합니다.
2. 에 있는 항목과 일치하는 경우 서버를 차단합니다 deniedMcpServers.
3. allowedMcpServers이 있는 경우, 항목과 일치하지 않으면 서버를 차단합니다.
4. 클라이언트가 서버를 확인할 수 없으므로 URL 또는 명령에 확인되지 않은 변수(예: ${VARIABLE} 또는 $VARIABLE)가 포함된 경우 서버를 차단합니다.

클라이언트가 여러 managed-settings.json 배포 방법에서 설정을 받으면 모든 설정이 적용됩니다. 어느 소스에서든 거부 규칙이 있으면 서버가 차단되며, 허용 목록이 정의된 모든 계층에서 서버는 허용 목록 항목과 일치해야 합니다.

허용 목록 또는 거부 목록의 형식이 잘못된 경우(예: 잘못된 JSON이 있음) 클라이언트는 정책을 빈 allowedMcpServers 목록으로 처리합니다. 기본 제공 서버를 제외한 모든 서버를 차단합니다.

클라이언트가 검색 또는 디바이스 검색 오류로 인해 정책 계층을 확인할 수 없는 경우 이전에 적용된 정책을 유지합니다. 효과적인 정책은 더 제한적일 수 있지만 덜 제한적일 수는 없습니다.