# MCP(모델 컨텍스트 프로토콜) Copilot를 MCP(모델 컨텍스트 프로토콜) 서버를 통해 외부 도구 및 데이터에 연결합니다. ## 모델 컨텍스트 프로토콜(MCP) 개요 모델 컨텍스트 프로토콜(MCP)은 애플리케이션이 대규모 언어 모델(LLM)과 컨텍스트를 공유하는 방식을 정의하는 개방형 표준입니다. MCP는 AI 모델을 다양한 데이터 원본 및 도구에 연결하여 보다 효과적으로 함께 작동할 수 있도록 하는 표준화된 방법을 제공합니다. MCP를 사용하여 GitHub Copilot의 기능을 다양한 기존 도구 및 서비스와 통합하여 확장할 수 있습니다. MCP는 모든 주요 Copilot 환경 전반에서 작동합니다. IDE에서 작업하든, GitHub Copilot CLI을 사용하든, GitHub Copilot app에서 작업하든, GitHub.com의 에이전트에 작업을 위임하든 관계없습니다. MCP를 사용하여 새 도구 및 서비스를 생성하여 Copilot와 함께 작동하도록 할 수 있으며, 환경을 사용자 지정하고 개선할 수 있습니다. 예를 들어 문제 추적기를 연결하면 Copilot가 수정 작업을 하는 동안 버그를 조회할 수 있으므로, 이슈를 채팅에 복사해 달라고 요청하지 않아도 됩니다. MCP에 대한 자세한 내용은 [공식 MCP 설명서](https://modelcontextprotocol.io/introduction)를 참조하세요. 파트너와 커뮤니티의 MCP 서버 큐레이팅 목록은 [MCP 레지스트리를GitHub 참조하세요](https://github.com/mcp). 기업 및 조직은 정책에서 **MCP 서버를 Copilot** 사용하여 조직 또는 엔터프라이즈 구성원에 대해 MCP 사용을 사용하거나 사용하지 않도록 선택할 수 있습니다. 이 정책은 기본적으로 사용하지 않도록 설정되어 있습니다. [기업에서 GitHub Copilot에 대한 정책 및 기능 관리](/ko/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies) 및 [조직의 GitHub Copilot 대한 정책 및 기능 관리](/ko/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies)을(를) 참조하세요. MCP 정책은 해당 정책을 설정한 조직 또는 기업의 \*\*\*\* 또는 Copilot Business 구독을 보유한 사용자에게Copilot Enterprise 적용됩니다. Copilot Free, Copilot Pro또는 Copilot Pro+Copilot Max 이 정책의 적용을 받는 MCP 액세스 권한이 **없습니다**. MCP는 프롬프트, 파일 및 지침을 통해 제공하는 컨텍스트를 보완합니다. 에이전트의 작동 방식에 대한 지침을 대체하지 않고 도구 및 데이터에 대한 연결을 추가합니다. 컨텍스트를 확인 및 관리하는 방법에 대한 지침은 [GitHub Copilot에 대한 프롬프트 및 컨텍스트](/ko/copilot/concepts/prompting-and-context)을 참조하세요. GitHub 검증 MCP 서버(커넥터)를 통해 서비스를 한 번 연결한 다음, 각 환경에서 설정을 반복하거나 별도로 로그인하지 않고 지원되는 Copilot 환경 전반에서 연결을 사용합니다. 이러한 연결은 클라우드 샌드박스에서 Copilot 실행되는 세션에서도 작동하지만 GitHub Actions에서 실행되는 세션에서는 작동하지 않습니다. [코파일럿 커넥터](/ko/copilot/concepts/customizations/copilot-connectors)을(를) 참조하세요. ## MCP를 사용할 수 있는 위치 MCP 설정은 사용하는 위치에 따라 달라집니다.Copilot * **다음 GitHub Copilot app**: 리포지토리 또는 로컬 Copilot 구성에 구성된 MCP 서버를 사용할 수 있습니다. **사용자 지정** 탭에서 추가 MCP 서버를 검색하고 설치할 수도 있습니다. * **Copilot CLI**: GitHub Copilot CLI 로컬 및 원격 MCP 서버를 모두 지원합니다. GitHub MCP 서버는 추가 구성 없이 기본 제공되고 사용할 수 있습니다. * **Copilot cloud agent (포함 automations) 및 Copilot code review**: GitHub.com 리포지토리 수준에서 구성된 MCP 서버를 지원합니다. 구성은 , 및 에 적용됩니다. GitHub MCP 서버와 Playwright MCP 서버는 기본적으로 구성됩니다. * **IDE**: MCP 서버는 Visual Studio, JetBrains IDE들, Visual Studio Code, Xcode 및 Eclipse에서 지원됩니다. 연결 및 인증 옵션은 IDE에 따라 달라집니다. [MCP(모델 컨텍스트 프로토콜) 서버를 사용하여 GitHub Copilot 채팅 확장](/ko/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/extend-copilot-chat-with-mcp)을(를) 참조하세요. GitHub.com의 채팅에는 분기를 만들고 코드를 검색하는 도구와 같은 미리 구성된 도구가 있습니다. 이는 Copilot cloud agent 및 Copilot code review용 리포지토리 MCP 설정과는 별개입니다. [GitHub.com 및 GitHub Mobile의 GitHub Copilot](/ko/copilot/concepts/copilot-surfaces/copilot-on-github)을(를) 참조하세요. ## MCP용 Copilot cloud agent 다음 섹션에서는 automations의 MCP 기본값 및 구성을 설명하며, 여기에는 Copilot cloud agent가 포함됩니다. 리포지토리 수준 MCP 설정도 아래에 설명된 대로 Copilot code review에 적용됩니다. 다른 표면의 경우 [다음 단계](#next-steps)의 설치 가이드를 사용합니다. ### 기본 MCP 서버 Copilot cloud agent에는 구성된 MCP 서버 두 개가 있습니다. * **GitHub** 는 문제 및 끌어오기 요청과 같은 리포지토리 데이터에 대한 액세스를 제공합니다. 기본적으로 현재 리포지토리에 대한 읽기 전용 액세스 권한이 있는 특수 범위의 토큰을 사용합니다. 해당 리포지토리 외부에 액세스하려면 더 광범위한 액세스 권한으로 자격 증명을 명시적으로 구성해야 합니다. * **Playwright**는 웹 페이지를 읽고, 상호 작용하고, 스크린샷을 찍을 수 있는 도구를 제공합니다. 기본적으로 `localhost` 또는 `127.0.0.1`을 통해 에이전트 자체 환경의 웹 리소스에만 액세스할 수 있습니다. 이러한 기본값은 클라우드 환경에만 해당합니다. 예를 들어, Copilot CLI에는 추가 구성 없이 GitHub MCP 서버가 포함되지만 다른 서버는 별도로 구성합니다. ### 개인 MCP 서버 개인 MCP 서버는 Copilot 사용자의 고유한 워크플로를 위해 도구와 데이터에 연결해 줍니다. 시작하는 모든 클라우드 세션에서 사용할 수 있도록 서버를 한 번 구성합니다. 이러한 서버는 귀하만 사용할 수 있으며 동일한 리포지토리에서 작업하는 다른 사용자에게는 영향을 미치지 않습니다. 개인 MCP 서버를 구성하기 전에 필요한 서비스가 GitHub 인증된 MCP 서버(커넥터)로 지원되는지 확인합니다. GitHub-확인된 MCP 서버는 클라우드 및 로컬 세션 모두에서 사용할 수 있으며 GitHub가 MCP 서버 구성 및 인증을 처리합니다. 반면 개인 MCP 서버는 키 기반 인증만 지원하며 클라우드 샌드박스에서만 사용할 수 있습니다. [코파일럿 커넥터](/ko/copilot/concepts/customizations/copilot-connectors)을(를) 참조하세요. 리포지토리 간에 원하는 연결 또는 사용자 고유의 자격 증명이 필요한 연결에 개인 MCP 서버를 사용하세요. 특정 리포지토리에서 작업하는 협력자에게 공유 구성을 제공하려면 대신 [리포지토리 수준 구성](#repository-level-configuration) 을 사용합니다. 1. [ ](https://github.com/copilot?ref_product=copilot\&ref_type=engagement\&ref_style=text\&utm_source=customization-concept-doc-home\&utm_medium=docs\&utm_campaign=universe-2026) Copilot 의 홈 페이지로 이동합니다. 2. 왼쪽 메뉴에서 **사용자 지정** 메뉴를 클릭합니다. 3. 필요한 서비스가 GitHub로 검증된 MCP 서버에 포함되는지 확인합니다. 4. GitHub-검증된 MCP 서버가 요구 사항을 충족하지 않고 사용자 고유의 MCP 서버를 구성하려는 경우 **추가** 드롭다운 메뉴를 선택한 다음, **MCP 서버**를 클릭합니다. 5. 서버 이름, 전송 유형, URL 또는 시작 명령 및 기타 필수 구성을 입력합니다. 6. 인증이 필요한 경우 Personal MCP server secrets에 이름이 로 시작하는 비밀(예: )을 만들고 서버 구성에서 이를 참조합니다. 7. **서버 추가**를 클릭합니다. 기본적으로 개인 MCP 서버 비밀은 개인 계정으로 범위가 지정된 세션에서 사용할 수 있습니다. 선택한 조직에서 그곳의 인증된 서버를 사용하기 위해 해당 항목의 사용을 허용할 수도 있습니다. #### Limitations * 개인 MCP 서버는 모든 클라우드 세션에서 사용할 수 있습니다. 현재 개별 세션에 대해 어떤 서버를 활성화할지 선택할 수 없습니다. * 사용자 지정 HTTP 및 SSE MCP 서버는 URL에서 쿼리 매개 변수를 지원하지 않습니다. 대신 이러한 값을 요청 헤더로 전달합니다. * 서버를 사용할 수 없는 경우 해당 구성을 확인하고 필요한 비밀이 있는지 확인하고 세션이 실행되는 계정 또는 조직에서 사용할 수 있는지 확인합니다. * 개인 및 리포지토리 수준 구성에서 총 50개의 MCP 서버를 사용할 수 있습니다. ### 리포지토리 수준 구성 리포지토리 수준 MCP 서버는 특정 리포지토리에서 작업하기 위한 도구 및 데이터에 Copilot 연결합니다. 리포지토리 관리자는 GitHub.com의 리포지토리 설정에서 이러한 서버를 구성하며, 리포지토리에 대한 쓰기 권한이 있는 모든 사용자가 이 구성을 볼 수 있습니다. 이러한 설정은 Copilot in the cloud(automations 포함) 및 Copilot code review 모두에 적용됩니다. 코드 검토용 MCP 도구 사용을 별도로 비활성화할 수 있습니다. 공동 작업자가 공유 문제 추적기 또는 설명서 서비스와 같은 동일한 도구가 필요한 경우 리포지토리 수준 구성을 사용합니다. 인증이 필요한 서버의 경우 개인 자격 증명 대신 Copilot용 서비스 계정을 사용합니다. 리포지토리 수준 서버는 개인 MCP 서버 비밀을 참조할 수 없습니다. 개인 서버 및 리포지토리 수준의 서버를 함께 사용할 수 있습니다. 두 구성 모두 이름이 같은 서버를 정의하는 경우 리포지토리 수준 구성이 우선합니다. 이 리포지토리 설정은 Copilot CLI에서 사용하는 프로젝트 MCP 구성 파일과 다릅니다. 어디서나 동일한 구성 위치가 적용된다고 가정하지 말고 Surface용 설정 가이드를 사용하세요. Automations 는 이러한 MCP 서버의 도구를 사용할 수 있지만 각 automation별로 선택한 도구만 사용할 수 있습니다. [Copilot 자동화](/ko/copilot/concepts/agent-capabilities/agent-powered-workflows-and-operations/about-automations#tools-and-actions)을(를) 참조하세요. > [!WARNING] > @mentioning하여 작업을 Copilot에 위임하거나 이슈 또는 풀 리퀘스트를 Copilot에 할당하면, Copilot는 구성된 MCP 도구를 자율적으로 사용하며 이를 호출하기 전에 승인을 요청하지 않습니다. 이러한 워크플로의 경우 각 서버를 검토하고 작업에 필요한 도구와 액세스만 허용합니다. 사용할 Copilot cloud agentCopilot code reviewMCP 서버를 구성하는 경우 다음 사항에 유의하세요. * Copilot cloud agent와 Copilot code review는 MCP 도구만 지원합니다. 현재 MCP 서버에서 제공하는 리소스 또는 프롬프트를 지원하지 않습니다. * 리포지토리 설정 또는 사용자 지정 에이전트 프로필에 구성된 MCP 서버의 경우, Copilot cloud agent 및 Copilot code review은 현재 인증 및 권한 부여에 OAuth를 사용하는 원격 서버를 지원하지 않습니다. Copilot code review에는 추가로 `annotations.readOnlyHint: true`를 선언하는 도구가 필요합니다. 이 주석이 없거나 `false`로 설정된 도구는 제외됩니다. 구성, 인증 및 유효성 검사 절차는 [리포지토리에 대한 MCP 서버 구성](/ko/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)을 참조하세요. ### 사용자 지정 에이전트용 MCP 서버 Copilot cloud agent의 경우, 에이전트 프로필은 리포지토리에서 작업하는 모든 에이전트가 사용할 수 있도록 하는 대신 해당 사용자 지정 에이전트에 대한 MCP 서버를 정의할 수 있습니다. `mcp-servers` 프로필 속성은 IDE에서 직접 실행되는 사용자 지정 에이전트에서 사용되지 않습니다. Copilot cloud agent의 경우 기본 서버 구성이 먼저 처리된 다음, 사용자 지정 에이전트 구성, 리포지토리 설정이 처리됩니다. 이후 구성은 이전 설정을 재정의할 수 있습니다. 이 정렬은 Copilot CLI의 프로젝트 파일 우선 순위를 설명하지 않습니다. 프로필 형식, 지원되는 속성 및 처리 규칙은 [사용자 지정 에이전트 구성](/ko/copilot/reference/custom-agents-configuration)을 참조하세요. ## 모범 사례 * 타사 서버를 사용하도록 설정하기 전에 검토하세요. 조직의 요구 사항에 따라 해당 도구, 인증 요구 사항 및 데이터 액세스를 확인합니다. * 작업에 필요한 도구만 사용하도록 설정합니다. 리포지토리 설정에서 모든 도구를 사용하도록 설정하는 대신 특정 도구(가급적 읽기 전용 도구)를 허용 목록에 추가하려면 `tools` 필드를 사용합니다. automations에서 필요한 특정 도구를 선택합니다. * 자격 증명이 필요한 리소스로만 범위가 지정되도록 유지합니다. 태스크에 필요한 경우가 아니면 기본 토큰의 액세스 권한을 Copilot cloud agent 확대하지 마세요. * 구성에 의존하기 전에 구성의 유효성을 검사하세요. 에이전트 세션에서 사용할 수 있는 서버 및 도구를 확인하세요. 사용자 환경에 대한 설정 지침은 [다음 단계를](#next-steps) 참조하세요. ## MCP 서버 정보 GitHub GitHub MCP 서버는 MCP(모델 컨텍스트 프로토콜) 서버가 제공하고 유지 관리합니다GitHub. GitHub MCP 서버를 사용하여 다음을 수행할 수 있습니다. * 코드 관련 작업을 자동화하고 간소화합니다. * 타사 도구(예: 커서, Windsurf 또는 향후 통합)를 GitHub의 컨텍스트 및 AI 기능을 활용할 수 있도록 연결합니다. * 모든 디바이스에서 작동하는 클라우드 기반 워크플로를 로컬 설정 없이 활성화하세요. * GitHub 도구, 예를 들어 Copilot cloud agent (구독 필요) 및 GitHub Copilot (구독 필요)의 호출을 통해 코드 생성과 보안 분석을 지원합니다. MCP 서버를 사용하는 GitHub 방법을 알아보려면 [IDE에서 GitHub MCP 서버 사용](/ko/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/use-the-github-mcp-server)을 참조하세요. 편집기에서 MCP 서버를 지원하는 GitHub 지 여부와 사용할 수 있는 연결 및 인증 방법을 확인하려면 리포지토리의 [](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/README.md#support-by-host-application)`github/github-mcp-server` 참조하세요. ### 원격 접근 로컬 설정 없이 GitHub을 통해 Copilot Chat에서 원격으로 MCP 서버에 접근할 수 있습니다. 원격 서버는 원격 GitHub MCP 서버에서만 사용할 수 있는 추가 도구 집합에 액세스할 수 있습니다. 이러한 도구 목록은 [](https://github.com/github/github-mcp-server?tab=readme-ov-file#additional-toolsets-in-remote-github-mcp-server) 리포지토리의 `github/github-mcp-server`을 참조하세요. MCP 서버는 GitHub 필요한 경우 MCP 호환 편집기에서 로컬로 실행할 수도 있습니다. ### 도구 집합 사용자 지정 > [!IMPORTANT] > 최신 도구 집합 및 신뢰할 수 있는 구성 지침은 항상 GitHub의 MCP 서버 리포지토리를 검토 [](https://github.com/github/github-mcp-server) 합니다. MCP 서버는 GitHub 도구 세트를 통해 특정 기능 그룹을 사용하거나 사용하지 않도록 설정합니다. 도구 집합을 사용하면 AI 도구에서 사용할 수 있는 GitHub API 기능을 제어할 수 있습니다. 필요한 도구 집합만 사용하도록 설정하면 AI 도우미의 성능과 보안이 향상됩니다. 도구가 적으면 도구 선택 정확도가 향상되고 오류가 줄어듭니다. 사용하지 않는 도구 집합을 사용하지 않도록 설정하면 AI의 컨텍스트 창에서 토큰도 해제됩니다. 도구 집합에는 도구뿐만 아니라 해당하는 경우 관련 MCP 리소스 및 프롬프트도 포함되어 있습니다. MCP 서버에 대한 도구 집합을 GitHub 구성하는 방법을 알아보려면 [GitHub MCP 서버에 대한 도구 집합 구성](/ko/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/configure-toolsets)을 참조하세요. ### Security 모든 공용 리포지토리와 GitHub Advanced Security로 적용되는 프라이빗 리포지토리의 경우, MCP 서버와의 GitHub 상호 작용은 푸시 보호에 의해 안전하게 보호되며, 이는 AI가 생성한 응답의 비밀을 차단하고 사용자를 대신하여 수행될 작업에 포함되지 않도록 합니다. 또한 AI 코딩 에이전트 내에서 코드에서 노출된 비밀을 사전에 검색할 수 있습니다. 자세한 내용은 [GitHub MCP 서버로 비밀 검색](/ko/code-security/how-tos/use-ghas-with-ai-coding-agents/scan-for-secrets-with-github-mcp-server)을(를) 참조하세요. ## GitHub MCP 레지스트리 정보 GitHub MCP 레지스트리는 파트너와 커뮤니티의 MCP 서버 큐레이팅된 목록입니다. 레지스트리를 사용하여 새 MCP 서버를 검색하고 특정 요구 사항을 충족하는 서버를 찾을 수 있습니다. > [!NOTE] > GitHub MCP 레지스트리는 현재 공개 미리 보기 상태에 있으며 변경될 수 있습니다. ## 에이전트 찾기 에이전트 찾기는 모든 기능을 미리 구성하지 않고 런타임에 작업에 적합한 기능(예: MCP 서버, 도구, 에이전트 및 기술)을 찾는 데 도움이 GitHub Copilot 되는 검색 서비스입니다. MCP 레지스트리와 마찬가지로 기능 카탈로그를 검색하고 요청 시 사용할 수 있는 순위 일치 GitHub Copilot 항목을 반환합니다. 에이전트 찾기는 개방형 ARD(에이전트 리소스 검색) 사양을 구현합니다. Copilot CLI 설정에 대해서는 [에이전트 찾기 사용](/ko/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-agent-finder)을 참조하세요. GitHub Copilot app는 기본 제공 `af` 기술을 제공합니다. [GitHub Copilot 앱의 기본 제공 스킬](/ko/copilot/reference/github-copilot-app-reference/built-in-skills)을(를) 참조하세요. 카탈로그를 찾아보려면 [GitHub 에이전트 찾기를 참조하세요](https://github.com/agentfinder). ## 다음 단계 * [에 대한 MCP 서버 추가 GitHub Copilot CLI](/ko/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) -에 MCP 서버 추가 Copilot CLI * [GitHub Copilot 앱 사용자 지정](/ko/copilot/how-tos/github-copilot-app/customize-github-copilot-app)—GitHub Copilot app 내에서 MCP 서버 관리 * [리포지토리에 대한 MCP 서버 구성](/ko/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)—Copilot cloud agent 및 Copilot code review용 리포지토리 MCP 서버 구성 * [MCP(모델 컨텍스트 프로토콜) 서버를 사용하여 GitHub Copilot 채팅 확장](/ko/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/extend-copilot-chat-with-mcp) - IDE에 Copilot Chat MCP 서버 추가 * [GitHub MCP 서버 설정](/ko/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/set-up-the-github-mcp-server) - MCP 서버 설정 GitHub