GitHub Copilot CLI에 MCP 서버 추가하기

모델 컨텍스트 프로토콜(MCP)은 애플리케이션이 대규모 언어 모델(LLM)과 컨텍스트를 공유하는 방식을 정의하는 개방형 표준입니다. GitHub Copilot CLI에 MCP 서버를 연결하면 Copilot가 외부 도구, 데이터 원본 및 서비스에 접근할 수 있게 됩니다. MCP에 대한 개요는 모델 컨텍스트 프로토콜(MCP) 정보을(를) 참조하세요.

MCP 서버 추가

참고 항목

GitHub MCP 서버는 Copilot CLI에 내장되어 있으며, 추가 구성 없이 즉시 사용할 수 있습니다. 아래 단계는 다른 MCP 서버를 추가하기 위한 것입니다.

CLI 내에서 대화형 /mcp add 명령을 사용하거나 구성 파일을 직접 편집하여 MCP 서버를 추가할 수 있습니다.

특정 MCP 서버에 대한 설치 지침, 사용 가능한 도구 및 URL은 GitHub MCP 레지스트리를 참조하세요.

          `/mcp add` 명령 사용

대화형 모드에서 .를 입력합니다 /mcp add. 구성 양식이 표시됩니다. Tab 키를 사용하여 필드 간을 탐색합니다.

       **서버 이름** 옆에 MCP 서버의 고유한 이름을 입력합니다. 서버를 참조하는 데 사용할 이름입니다.

```
       **서버 유형** 옆에 있는 해당 번호를 눌러 형식을 선택합니다. 사용할 수 있는 형식은 다음과 같습니다.
```
* 로컬 또는 STDIO: 로컬 프로세스를 시작하고 표준 입력/출력(stdin/stdout)을 통해 통신합니다. 두 옵션 모두 동일한 방식으로 작동합니다. STDIO 는 표준 MCP 프로토콜 형식 이름이므로 구성이 VS Code, Copilot 코딩 도우미및 기타 MCP 클라이언트와 호환되도록 하려면 이 이름을 선택합니다. * HTTP 또는 SSE: 원격 MCP 서버에 연결합니다. HTTP 는 스트리밍 가능한 HTTP 전송을 사용합니다. SSE 는 Server-Sent 이벤트 전송과 함께 레거시 HTTP를 사용하며 MCP 사양에서는 사용되지 않지만 이전 버전과의 호환성을 위해 계속 지원됩니다.
나머지 필드는 선택한 서버 유형에 따라 달라집니다.
- ```
     **로컬** 또는 **STDIO**를 선택한 경우:
```
  * 명령 옆에 인수를 포함하여 서버를 시작하는 명령을 입력합니다. 예: npx @playwright/mcp@latest. 이는 JSON 구성 파일의 command 속성과 args 모두에 해당합니다. * 환경 변수 옆에 API 키 또는 토큰과 같이 서버에서 필요로 하는 환경 변수를 JSON 키-값 쌍으로 선택적으로 지정합니다. 예: {"API_KEY": "YOUR-API-KEY"}. 변수 PATH는 사용자 환경에서 자동으로 상속됩니다. 다른 모든 환경 변수는 여기에서 구성해야 합니다.
- ```
     **HTTP** 또는 **SSE**를 선택한 경우:
```
  * URL 옆에 원격 서버 URL을 붙여넣습니다. 예: https://mcp.context7.com/mcp. * HTTP 헤더 옆에는 필요에 따라 HTTP 헤더를 JSON으로 지정합니다. 예: {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

       **도구** 옆에 사용할 수 있는 서버의 도구를 지정합니다. 
       `*` 모든 도구를 포함하거나 쉼표로 구분된 도구 이름 목록을 입력합니다(따옴표가 필요 없음). 기본값은 `*`입니다.

       <kbd>Ctrl</kbd>+<kbd>S</kbd>를 눌러 구성을 저장합니다. CLI를 다시 시작하지 않고 MCP 서버가 추가되고 즉시 사용할 수 있습니다.

구성 파일 편집

에서 구성 파일을 편집하여 MCP 서버를 추가할 수도 있습니다 ~/.copilot/mcp-config.json. 구성을 공유하거나 한 번에 여러 서버를 추가하려는 경우에 유용합니다.

다음 예제에서는 로컬 서버와 원격 HTTP 서버가 있는 구성 파일을 보여줍니다.

JSON

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

MCP 서버 구성에 대한 자세한 내용은 MCP(모델 컨텍스트 프로토콜)를 사용하여 GitHub Copilot 코딩 에이전트 확장을 참조하세요.

MCP 서버 관리

Copilot CLI를 통해 구성된 MCP 서버를 다음 /mcp 명령으로 관리할 수 있습니다.

        **구성된 MCP 서버를 나열합니다.** 명령을 `/mcp show`사용합니다. 이렇게 하면 구성된 모든 MCP 서버와 해당 현재 상태가 표시됩니다.

        **특정 서버에 대한 세부 정보 보기:** 명령을 `/mcp show SERVER-NAME`사용합니다. 지정된 서버의 상태와 서버에서 제공하는 도구 목록이 표시됩니다.

        **서버의 구성을 편집** 합니다. 명령을 `/mcp edit SERVER-NAME`사용합니다.

        **서버를 삭제합니다.** 명령을 `/mcp delete SERVER-NAME`사용합니다.

        **서버를 사용하지 않도록 설정합니다.** 명령을 `/mcp disable SERVER-NAME`사용합니다. 비활성화된 서버는 설정값은 그대로 유지되나, 현재 세션의 Copilot 활용 대상에서는 제외됩니다.

        **이전에 사용하지 않도록 설정된 서버를 사용하도록 설정합니다** . 명령을 `/mcp enable SERVER-NAME`사용합니다.

MCP 서버 사용

MCP 서버를 추가하면 Copilot가 프롬프트에 적합한 도구를 자동으로 활용할 수 있게 됩니다. MCP 서버 및 특정 도구를 프롬프트에서 직접 참조하여 해당 도구가 사용되는지 확인할 수도 있습니다.

추가 읽기

        [AUTOTITLE](/copilot/concepts/about-mcp)

        [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)

이 문서의 내용

MCP 서버 추가

구성 파일 편집

MCP 서버 관리

MCP 서버 사용

추가 읽기