월 US$9.99에 모든 Premium Skill을 이용하세요. 언제든지 취소할 수 있습니다.지금 업그레이드

VS Code에서 Skillry MCP 연결하기

VS Code는 링크, Command Palette, 명령줄, 또는 mcp.json 파일로 MCP 서버를 추가하고 Copilot Chat의 에이전트 모드에서 사용합니다. 마음에 드는 방법을 고르세요. 어느 방법이든 MCP: List Servers에 skillry가 보이는 것으로 끝납니다.

대상
Copilot을 쓰는 VS Code
소요 시간
완료까지 4분
테스트
code --add-mcp, macOS, 2026년 10월 28일

짧은 답변

  1. 1VS Code에서 GitHub Copilot이 활성화되어 있어야 합니다(무료 티어로 충분). 없으면 MCP 명령이 제공되지 않습니다.
  2. 2가장 빠른 방법: skillry.dev/mcp의 Add to VS Code, 또는 터미널에서 code --add-mcp 명령 하나.
  3. 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 추가하기

skillry.dev에서 가장 빠름
  1. 1

    skillry.dev/mcp를 열고 VS Code와 운영체제를 선택한 뒤 Add to VS Code를 선택합니다. 브라우저가 VS Code를 열도록 허용합니다.

  2. 2

    VS Code가 서버 이름과 명령을 보여 주고 확인을 요청합니다. Install을 선택합니다.

    다음이 보여야 합니다: 사용자 mcp.json에 항목이 들어가고 그 위에 Start 동작이 표시됩니다. 선택하거나, 처음 사용할 때 서버가 시작되기를 기다립니다.

VS Code가 연결되었는지 확인하기

  1. 1

    Command Palette에서 MCP: List Servers를 실행하고 skillry를 선택합니다.

    다음이 보여야 합니다: Stop, Restart, Show Output 같은 동작이 있는 실행 중인 서버. 멈춰 있으면 Start를 선택합니다.

  2. 2

    Chat을 열고 Agent 모드로 전환한 뒤 도구 선택기를 엽니다.

    다음이 보여야 합니다: search_skills로 시작하는 Skillry 도구를 체크할 수 있습니다.

설치할 때 승인하기

설치할 때 Skillry 계정을 확인합니다. 에이전트에 비밀번호를 입력하거나 키를 붙여 넣지 않습니다. 처음 한 번 브라우저에 페이지가 열리고, 거기서 승인합니다.

  1. 1

    에이전트에게 선택한 Skill을 설치해 달라고 요청합니다. 예: 이 프로젝트에 설치해 줘.

    다음이 보여야 합니다: 에이전트가 계정 연결이 필요하다고 알리고 브라우저를 엽니다. 터미널 클라이언트에서는 링크만 출력될 수 있으니 직접 열어 주세요.

  2. 2

    페이지의 기기 코드가 에이전트에 표시된 것과 같은지 확인하고, 요청받으면 Skillry에 로그인한 뒤 Approve를 선택합니다.

    다음이 보여야 합니다: Authorization approved와 에이전트로 돌아가라는 안내. 에이전트가 몇 초 안에 이를 감지하고 설치를 끝냅니다.

승인은 7일 동안 유효하며 운영체제의 키링(macOS는 키체인, Windows는 자격 증명 관리자)에 저장됩니다. 만료되면 에이전트가 다시 승인을 요청할 뿐입니다. 더 일찍 로그아웃하려면 에이전트에게 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. 1

    MCP: List Servers를 실행하고 skillry를 선택한 뒤 Uninstall을 선택합니다. 또는 항목이 들어 있는 파일에서 항목을 삭제합니다.

    다음이 보여야 합니다: 목록에서 skillry가 사라집니다.

항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 항목을 제거하고 7일 뒤 승인이 만료되도록 두세요.

레퍼런스

파일macOSWindows
사용자 프로필 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 mcpcmd /c npx --yes skillry-cli@latest mcp
VS Code가 mcp.json에 저장하는 항목(macOS)
{
  "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가 처음 시작할 때 신뢰 확인 창을 봅니다.

출처

이 가이드가 도움이 되었나요?