---
title: "VS Code (GitHub Copilot) MCP 설정: 파일 경로, 키, 예시 · DotsAgent"
description: "Microsoft의 MCP 서버를 VS Code (GitHub Copilot)에 추가하는 방법을 알아보세요. 설정 파일 위치, 최상위 키와 형식, 원격 OAuth 지원, 설정 예시를 확인할 수 있습니다."
url: https://dotsagent.io/ko/mcp/clients/vscode-copilot
---

Microsoft

# VS Code (GitHub Copilot)에 MCP 서버 추가

VS Code는 작업 영역의 .vscode/mcp.json, 사용자 프로필의 mcp.json 또는 최신 형식의 이식 가능한 .mcp.json 파일을 읽습니다.

- **macOS**: `User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json`
- **Windows**: `User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json`
- **Linux**: `User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json`
- **프로젝트 파일**: `.vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers')`
- **최상위 키**: `servers`
- **형식**: json
- **원격 서버용 OAuth**: 

## 설정 예시

이 예시는 이 클라이언트가 요구하는 형식으로 GitHub 호스팅 서버와 로컬 서버인 Playwright를 추가합니다.

`.vscode/mcp.json`

```
{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}
```

`shell`

```
code --add-mcp '{"name":"github","type":"http","url":"https://api.githubcopilot.com/mcp/"}'
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
```

## 참고 및 특이사항

- .vscode/mcp.json에서는 servers 키를 사용하고, 이식 가능한 .mcp.json 및 ~/.copilot/mcp-config.json에서는 mcpServers를 사용합니다.
- 최상위 inputs 배열을 사용하면 비밀번호를 입력하라는 메시지가 표시되므로 키를 파일에 저장하지 않아도 됩니다.
- 이제 안내에 따라 진행하는 Add server 흐름에서는 이식 가능한 파일을 권장하며 .vscode/mcp.json과 사용자 프로필 파일을 더 이상 사용하지 않도록 표시합니다. 두 파일 모두 계속 작동합니다.
- VS Code는 Claude Desktop, Copilot CLI, Cursor 및 Windsurf에 이미 설정된 서버도 검색합니다.
- code --add-mcp는 JSON 문자열에서 서버를 추가합니다.

[VS Code (GitHub Copilot) 설정 만들기 →](https://dotsagent.io/ko/mcp/config#client=vscode-copilot)

## 다른 클라이언트

[Claude Desktop](https://dotsagent.io/ko/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/ko/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/ko/mcp/clients/cursor)

[Windsurf / Devin Desktop](https://dotsagent.io/ko/mcp/clients/windsurf)

[Zed](https://dotsagent.io/ko/mcp/clients/zed)

[OpenAI Codex CLI](https://dotsagent.io/ko/mcp/clients/codex-cli)

[Gemini CLI](https://dotsagent.io/ko/mcp/clients/gemini-cli)

[ChatGPT](https://dotsagent.io/ko/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/ko/mcp/clients/openclaw)

[Cline](https://dotsagent.io/ko/mcp/clients/cline)

[Continue](https://dotsagent.io/ko/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/ko/mcp/clients/jetbrains-ai)

## 출처

1. [code.visualstudio.com](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration)/docs/copilot/reference/mcp-configuration
2. [code.visualstudio.com](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)/docs/copilot/customization/mcp-servers

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일