에 대한 MCP 서버 추가 GitHub Copilot 명령 줄 인터페이스 (CLI)

Copilot의 기능을 확장하기 위해 모델 컨텍스트 프로토콜(MCP) 서버를 연결하여 추가 도구와 컨텍스트를 제공합니다.

이 기사에서

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

MCP 서버 추가

참고

GitHub MCP 서버는 기본 제공되며 코파일럿 CLI 추가 구성 없이 이미 사용할 수 있습니다. 아래 단계는 다른 MCP 서버를 추가하기 위한 것입니다.

조직 또는 기업이 레지스트리 URL 및 허용 목록 정책을 구성한 경우 해당 설정이 적용됩니다 코파일럿 CLI. 구성된 레지스트리 URL은 검색 원본으로 표시되며 허용 목록 정책에서 허용하는 서버만 실행할 수 있습니다.

다음과 같은 방법으로 MCP 서버를 추가할 수 있습니다.

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

/mcp add 명령 사용

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

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

  3. 서버 유형 옆에 있는 해당 번호를 눌러 형식을 선택합니다. 사용할 수 있는 형식은 다음과 같습니다.

    • 로컬 또는 STDIO: 로컬 프로세스를 시작하고 표준 입력/출력(stdin/stdout)을 통해 통신합니다. 두 옵션 모두 동일한 방식으로 작동합니다. STDIO는 표준 MCP 프로토콜 유형 이름이기 때문에 구성이 , 및 기타 MCP 클라이언트와 VS CodeCopilot 클라우드 에이전트호환되도록 하려면 이 이름을 선택합니다.
    • HTTP 또는 SSE: 원격 MCP 서버에 연결합니다. HTTP 는 스트리밍 가능한 HTTP 전송을 사용합니다. SSE 는 Server-Sent 이벤트 전송과 함께 레거시 HTTP를 사용하며 MCP 사양에서는 사용되지 않지만 이전 버전과의 호환성을 위해 계속 지원됩니다.

  4. 나머지 필드는 선택한 서버 유형에 따라 달라집니다.

    • 로컬 또는 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"}.

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

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

copilot mcp add 하위 명령 사용

대화형 모드를 입력하지 않고도 하위 명령을 사용하여 copilot mcp add 터미널에서 MCP 서버를 추가할 수 있습니다. 서버가 ~/.copilot/mcp-config.json의 사용자 구성에 추가됩니다.

로컬(stdio) 서버의 경우 -- 뒤에 다음 명령어를 제공하세요.

Shell
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

원격(HTTP/SSE) 서버의 경우 전송을 지정하고 URL을 제공합니다.

Shell
copilot mcp add --transport http SERVER-NAME URL

추가 옵션을 전달할 수도 있습니다.

  • --env KEY=VALUE: 서버에 대한 환경 변수를 설정합니다. 여러 변수에 대해 반복합니다.
  • --header "HEADER: VALUE": 원격 서버에 대한 HTTP 헤더를 설정합니다. 여러 헤더에 대해 반복합니다.
  • --transport TRANSPORT: 전송 유형(stdio또는http``sse)을 설정합니다. 기본값은 stdio입니다.
  • --tools TOOLS: 사용하도록 설정할 도구를 지정합니다. 모든 도구(기본값)에는 *를 사용하고, 쉼표로 구분된 목록 또는 없음에는 ""를 사용합니다.
  • --timeout MS: 시간 제한을 밀리초 단위로 설정합니다.

예제

로컬 stdio 서버를 추가합니다.

Shell
copilot mcp add context7 -- npx -y @upstash/context7-mcp

환경 변수가 있는 로컬 서버를 추가합니다.

Shell
copilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

원격 HTTP 서버를 추가합니다.

Shell
copilot mcp add --transport http notion \
  https://mcp.notion.com/mcp

권한 부여 헤더가 있는 원격 서버를 추가합니다.

Shell
copilot mcp add --transport http \
  --header "Authorization: Bearer YOUR-TOKEN" \
  stripe https://mcp.stripe.com

구성 파일 편집

에서 구성 파일을 편집하여 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": ["*"]
    }
  }
}

MCP 서버 구성에 대한 자세한 내용은 리포지토리에 대한 MCP 서버 구성을 참조하세요.

레지스트리에서 검색 및 설치

참고

이 /mcp search 명령은 현재 실험적 기능입니다. 이 기능을 사용하려면 --experimental 명령줄 옵션으로 코파일럿 CLI을 시작하거나, 세션 중에 /experimental on를 입력하세요.

대화형 모드에서 명령을 사용하여 MCP 레지스트리에서GitHub 직접 MCP 서버를 검색하고 설치할 /mcp search 수 있습니다. 이렇게 하면 구성 양식을 수동으로 작성하지 않고 사용 가능한 서버를 찾아보고 세부 정보를 보고 설치할 수 있습니다.

조직에서 사용자 지정 MCP 레지스트리 URL /mcp search 을 구성한 경우 기본 GitHub 레지스트리 대신 해당 레지스트리에 연결합니다.

  1. 대화형 모드에서 별별로 상위 서버를 찾아보거나 /mcp search 특정 서버를 검색하려면 입력 /mcp search QUERY 합니다. 다음은 그 예입니다.

    /mcp search context7

  2. 일치하는 서버의 키보드 탐색 가능 목록이 표시됩니다. 화살표 키를 사용하여 결과를 찾습니다.

  3. 서버를 선택하여 구성 양식을 엽니다. 양식은 레지스트리에서 서버의 구성으로 미리 채워집니다. API 키 또는 토큰과 같은 필수 필드를 입력합니다.

  4. Ctrl+S를 눌러 저장합니다. 서버가 사용자 mcp-config.json 에 추가되고 즉시 시작됩니다.

MCP 서버 관리

대화형 모드의 명령 또는 /mcp 터미널의 copilot mcp 하위 명령을 사용하여 구성된 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사용합니다.

터미널에서 하위 명령 사용 copilot mcp

대화형 모드로 전환하지 않고 터미널에서 MCP 서버를 관리할 수도 있습니다.

  • 구성된 모든 서버를 나열합니다.

    Shell
    copilot mcp list

    모든 구성 원본(사용자, 작업 영역 및 플러그 인)의 서버를 나열합니다. JSON 출력용으로 --json를 추가합니다.

  • 서버 세부 정보 보기:

    Shell
    copilot mcp get SERVER-NAME

    서버의 유형, 상태 및 사용 가능한 도구를 표시합니다. JSON 출력의 경우 --json를 추가합니다.

  • 서버 제거:

    Shell
    copilot mcp remove SERVER-NAME

    사용자 구성에서 서버를 제거합니다.

MCP 서버 사용

MCP 서버를 Copilot 추가한 후에는 프롬프트와 관련된 경우 제공하는 도구를 자동으로 사용할 수 있습니다. MCP 서버 및 특정 도구를 프롬프트에서 직접 참조하여 해당 도구가 사용되는지 확인할 수도 있습니다.

추가 읽기