Claude Desktop에서 Skillry MCP 연결하기

Skillry 데스크톱 확장 프로그램 설치

Skillry .mcpb를 다운로드하고 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension…에서 선택하세요. + → Connectors에서 도구를 확인하세요.

시작하기 전에

• macOS 또는 Windows용 Claude Desktop, 최신 버전: Claude 메뉴 → 업데이트 확인….
• 확장 프로그램은 Claude Desktop에 내장된 Node.js 22+를 사용하므로 별도 설치가 필요 없습니다. 아래 수동 설정에는 Node.js 22+와 npx가 필요합니다.

Skillry .mcpb를 다운로드하고 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension…에서 선택하세요. + → Connectors에서 도구를 확인하세요.

수동 설정(대안)

1. 1

   Claude Desktop 메뉴에서 도움말 → 문제 해결 → 개발자 모드 활성화…를 선택하고 활성화를 누릅니다. 이미 개발자 메뉴가 보이면 이 단계는 건너뜁니다.

   다음이 보여야 합니다: 메뉴에 개발자가 추가됩니다.

2. 2

   개발자 → 앱 설정 파일 열기를 선택합니다.

   다음이 보여야 합니다: claude_desktop_config.json이 기본 편집기에서 열립니다. 파일이 없으면 Claude Desktop이 만듭니다.

3. 3

   이 내용을 mcpServers 객체에 병합하고 기존 서버는 그대로 둡니다. mcpServers가 아직 없으면 아래처럼 추가합니다.

   {
     "mcpServers": {
       "skillry": {
         "command": "npx",
         "args": [
           "--yes",
           "skillry-cli@latest",
           "mcp"
         ]
       }
     }
   }

4. 4

   Windows에서는 이 항목을 대신 사용합니다.

   {
     "mcpServers": {
       "skillry": {
         "command": "cmd",
         "args": [
           "/c",
           "npx",
           "--yes",
           "skillry-cli@latest",
           "mcp"
         ]
       }
     }
   }

5. 5

   파일을 저장한 뒤 개발자 → MCP 구성 새로고침을 선택합니다.

   다음이 보여야 합니다: 다음 섹션처럼 Connectors에 skillry가 보입니다.

   Skillry가 보이지 않으면 Claude Desktop을 완전히 종료했다가 다시 여세요. macOS에서는 Claude 메뉴에서 종료(⌘Q), Windows에서는 트레이 아이콘에서 종료합니다.

Claude Desktop이 연결되었는지 확인하기

1. 1

   대화에서 메시지 입력란의 +를 누르고 Connectors를 선택합니다.

   다음이 보여야 합니다: 목록에 skillry와 도구가 보이며, 첫 번째는 search_skills입니다.

2. 2

   상태를 보려면 Settings → Desktop app을 열고 Extensions 옆의 Manage를 선택한 뒤 Local MCP servers 아래를 확인합니다(이전 설정 레이아웃: Settings → Developer). 개발자 → MCP 로그 파일 열기로 로그를 엽니다.

첫 검색 해 보기

검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.

1. 1

   Claude Desktop에서 새 대화를 열고 이 요청을 붙여 넣습니다.

   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. 2

   에이전트가 Skillry 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.

설치할 때 승인하기

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

1. 1

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

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

2. 2

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

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

Claude Desktop이 Skillry를 보지 못할 때

제거 또는 연결 해제

Extensions에서 Skillry를 비활성화하거나 제거하세요. 수동 설정은 skillry 항목만 삭제하세요.

1. 1

   claude_desktop_config.json에서 skillry 항목을 삭제하고 저장한 뒤 개발자 → MCP 구성 새로고침을 선택합니다.

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

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

레퍼런스

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

설정 파일 형식은 Model Context Protocol 문서에 있습니다. 그 문서의 스크린샷은 이전 설정 창이라 현재 버전에는 없는 Edit Config 버튼이 보입니다.

자주 묻는 질문