짧은 답변
- 1VS Code에서 GitHub Copilot이 활성화되어 있어야 합니다(무료 티어로 충분). 없으면 MCP 명령이 제공되지 않습니다.
- 2가장 빠른 방법: skillry.dev/mcp의 Add to VS Code, 또는 터미널에서
code --add-mcp명령 하나. - 3Command Palette의 MCP: List Servers로 확인합니다.
skillry가 실행 중이어야 합니다.
시작하기 전에
code --add-mcp 방법은 2026년 10월 28일 macOS의 VS Code 1.141에서 테스트했습니다. 다른 방법은 공식 문서를 따랐으며 실제 설치 환경에서는 아직 실행하지 않았습니다.
- GitHub Copilot에 로그인되어 있고 AI 기능이 활성화된 VS Code. Copilot 무료 티어로 충분합니다.
- Node.js 22 이상(
node --version). VS Code는npx로 서버를 시작합니다. - VS Code에는 파일 형식이 두 가지 있습니다.
servers키를 쓰는 자체mcp.json과,mcpServers키를 쓰는 이식 가능한 Copilot 파일~/.copilot/mcp-config.json입니다. 둘 다 작동하며, 이 페이지는 각 방법이 어느 파일에 기록하는지 알려 줍니다.
| 방법 | 기록 위치 | 이럴 때 좋음 |
|---|---|---|
| Add to VS Code 링크 | 사용자 프로필의 mcp.json | 이미 skillry.dev/mcp에 있을 때 |
| Command Palette의 MCP: Add Server | ~/.copilot/mcp-config.json(Copilot Global) | VS Code 안에서 클릭으로 진행하고 싶을 때 |
터미널의 code --add-mcp | 사용자 프로필의 mcp.json | 명령 하나로 끝내고 싶을 때 |
mcp.json 직접 편집 | 여는 파일 | 항목을 직접 보고 싶을 때 |
VS Code에 Skillry 추가하기
- 1
skillry.dev/mcp를 열고 VS Code와 운영체제를 선택한 뒤 Add to VS Code를 선택합니다. 브라우저가 VS Code를 열도록 허용합니다.
- 2
VS Code가 서버 이름과 명령을 보여 주고 확인을 요청합니다. Install을 선택합니다.
다음이 보여야 합니다: 사용자
mcp.json에 항목이 들어가고 그 위에 Start 동작이 표시됩니다. 선택하거나, 처음 사용할 때 서버가 시작되기를 기다립니다.
- 1
Command Palette(macOS는 ⇧⌘P, Windows는 Ctrl+Shift+P)를 열고 MCP: Add Server를 실행합니다.
- 2
Command (stdio)를 선택하고 실행 명령을 입력합니다. macOS는
npx --yes skillry-cli@latest mcp, Windows는cmd /c npx --yes skillry-cli@latest mcp. - 3
서버 ID로
skillry를 입력합니다. - 4
Global을 선택하고, 물으면 Copilot Global을 선택합니다. 이렇게 하면
~/.copilot/mcp-config.json에 기록됩니다.다음이 보여야 합니다: 새 서버에 대한 신뢰 확인 창. 수락하면 VS Code가 서버를 시작할 수 있습니다.
- 1
터미널에서 이것을 실행합니다. Windows에서는 PowerShell을 사용하세요. 작은따옴표가 그대로 작동합니다.
macOS code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'다음이 보여야 합니다:
Added MCP servers: skillry. VS Code가 열리거나 앞으로 나옵니다. - 2
Windows에서는 Windows가
npx를 시작할 수 있도록 대신 이것을 실행합니다:Windows(PowerShell) code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'
- 1
Command Palette에서 MCP: Open User Configuration을 실행합니다. 사용자 프로필의
mcp.json이 열리고, 없으면 만들어집니다. - 2
servers객체에 이것을 병합합니다. 이미 있는 서버는 그대로 둡니다.macOS { "servers": { "skillry": { "type": "stdio", "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows에서는 대신 이 항목을 사용합니다.
Windows { "servers": { "skillry": { "type": "stdio", "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
저장합니다. VS Code가 항목 위에 Start를 표시하면 선택합니다.
다음이 보여야 합니다: MCP: List Servers에서 서버가 실행 중.
VS Code가 연결되었는지 확인하기
- 1
Command Palette에서 MCP: List Servers를 실행하고
skillry를 선택합니다.다음이 보여야 합니다: Stop, Restart, Show Output 같은 동작이 있는 실행 중인 서버. 멈춰 있으면 Start를 선택합니다.
- 2
Chat을 열고 Agent 모드로 전환한 뒤 도구 선택기를 엽니다.
다음이 보여야 합니다:
search_skills로 시작하는 Skillry 도구를 체크할 수 있습니다.
첫 검색 해 보기
검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.
- 1
Copilot Chat의 에이전트 모드에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트 Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.다음이 보여야 합니다: Skill 후보 세 개가 나오고, 각각 미리보기 링크, 필요한 입력, 의존성, 외부 비용이 함께 표시됩니다. 설치되는 것은 없습니다.
- 2
에이전트가 Skillry 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.
VS Code가 Skillry를 보지 못할 때
| 보이는 현상 | 예상 원인 | 해결 방법 |
|---|---|---|
| Command Palette에 MCP: Add Server가 없음 | Copilot에 로그인되지 않았거나 AI 기능이 비활성화됨 | GitHub에 로그인하고 Copilot을 활성화합니다. Chat을 쓸 수 있게 되면 MCP 명령이 나타납니다. |
| 서버가 목록에 있지만 멈춰 있거나 오류가 표시됨 | 한 번도 시작되지 않았거나 npx가 실패함 | MCP: List Servers에서 Start를 선택하고 Show Output으로 오류를 읽습니다. npx가 없다는 것은 VS Code가 쓰는 셸에 Node.js가 설치되지 않았다는 뜻입니다. |
| Chat에 도구가 나타나지 않음 | Chat이 Agent 모드가 아니거나 도구가 체크 해제됨 | Agent 모드로 전환하고 도구 선택기를 열어 Skillry 도구를 체크합니다. |
| 서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음 | npx가 설치되지 않았거나, Node.js가 22보다 오래되었거나, 첫 시작이 패키지 다운로드 중에 시간 초과됨 | 터미널에서 node --version과 npx --version을 실행합니다. 그다음 npx --yes skillry-cli@latest mcp를 직접 한 번 실행하고, 시작되면 Ctrl+C를 누른 뒤 클라이언트를 다시 시도합니다. 이제 패키지가 캐시에 있습니다. |
| Windows에서 서버가 시작되자마자 종료됨 | 항목이 npx를 직접 실행하는데, Windows는 실행에 셸이 필요함 | 이 페이지의 Windows 항목을 사용합니다. 명령은 cmd이고 인수는 /c, npx로 시작합니다. |
| 브라우저 페이지에 요청이 잘못되었거나 만료되었다고 표시됨 | 기기 코드를 너무 늦게 승인했거나, 이전 시도의 코드임 | 에이전트에게 다시 연결해 달라고 요청하고 새 코드를 몇 분 안에 승인합니다. |
| 설치가 Premium 또는 구매 메시지와 함께 멈춤 | Skill이 Premium이고 계정에 플랜도 구매 내역도 없음 | 에이전트가 보여 주는 링크로 Skill을 구매하거나 구독한 뒤 다시 요청합니다. 그전에는 아무것도 결제되지 않습니다. |
제거 또는 연결 해제
- 1
MCP: List Servers를 실행하고
skillry를 선택한 뒤 Uninstall을 선택합니다. 또는 항목이 들어 있는 파일에서 항목을 삭제합니다.다음이 보여야 합니다: 목록에서
skillry가 사라집니다.
항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 항목을 제거하고 7일 뒤 승인이 만료되도록 두세요.
레퍼런스
| 파일 | macOS | Windows |
|---|---|---|
사용자 프로필 mcp.json(servers 키) | ~/Library/Application Support/Code/User/mcp.json | %APPDATA%\Code\User\mcp.json |
Copilot 파일(mcpServers 키) | ~/.copilot/mcp-config.json | %USERPROFILE%\.copilot\mcp-config.json |
| 워크스페이스 파일 | 프로젝트 안의 .vscode/mcp.json | 같음 |
| 실행 명령 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
{
"servers": {
"skillry": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}모든 필드, 설치 URL 형식, 두 파일 형식은 MCP 설정 레퍼런스에 있습니다.
자주 묻는 질문
Copilot이 필요한가요?
예. VS Code의 MCP 지원은 Copilot Chat의 에이전트 모드에 있습니다. Copilot 무료 티어로 충분합니다.
어느 파일을 써야 하나요?
아무거나 하나. 링크와 code --add-mcp는 사용자 프로필의 mcp.json에, MCP: Add Server는 Copilot 파일에 기록합니다. Skillry를 둘 다에 추가하지 마세요.
팀과 공유할 수 있나요?
저장소의 .vscode/mcp.json에 항목을 넣으세요(servers 형식). 팀원은 VS Code가 처음 시작할 때 신뢰 확인 창을 봅니다.
출처
이 가이드가 도움이 되었나요?
