Claude Code에서 Skillry MCP 연결하기(macOS 및 Windows)

짧은 답변

1아무 터미널에서 claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp를 한 번 실행합니다. --scope user가 없으면 서버는 실행한 폴더에만 존재합니다.
2claude mcp get skillry로 확인합니다. 상태 줄에 ✔ Connected가 보여야 합니다.
3항목은 ~/.claude.json(Windows: %USERPROFILE%\.claude.json)에 있습니다. JSON을 직접 붙여 넣어도 됩니다.

시작하기 전에

2026년 10월 28일 macOS의 Claude Code 2.1.296에서 테스트했습니다. Windows 명령은 공식 문서를 따랐으며 실제 기기에서는 아직 실행하지 않았습니다.

Claude Code가 설치되어 있고 로그인된 상태. claude --version이 2.x 버전을 출력해야 합니다.
Node.js 22 이상(node --version). Claude Code는 Node에 포함된 npx로 서버를 시작합니다.
Skillry에서 내려받을 것은 없습니다. 서버가 처음 시작될 때 npx가 패키지를 가져옵니다.

Claude Code는 서버를 세 범위 중 하나에 저장합니다. 이 가이드는 user 범위를 사용해 모든 프로젝트에서 Skillry를 쓸 수 있게 합니다.

범위	플래그	저장 위치	이럴 때 사용
User	`--scope user`	`~/.claude.json` 최상위	모든 프로젝트에서 Skillry를 쓰고 싶을 때. 이 가이드.
Local(기본값)	없음	`~/.claude.json`의 현재 프로젝트 경로 아래	이 폴더에서만 쓰고 싶을 때.
Project	`--scope project`	저장소의 `.mcp.json`	팀원이 저장소에서 받게 하고 싶을 때. 각자 첫 실행 시 승인합니다.

Claude Code에 Skillry 추가하기

가장 빠름. PowerShell과 명령 프롬프트를 포함한 모든 셸에서 작동

1
아무 폴더에서 터미널을 열고 실행합니다:
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
다음이 보여야 합니다: Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config, 이어서 File modified: ~/.claude.json.
2
Windows에서는 대신 이것을 실행합니다. cmd /c로 감싸면 프로그램이 아니라 스크립트인 npx를 Windows가 시작할 수 있습니다.
Windows(PowerShell 또는 명령 프롬프트)
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
새 Claude Code 세션을 시작하거나, 이미 열린 세션에서 /mcp를 입력합니다.
다음이 보여야 합니다: /mcp 목록에 skillry. 선택하면 12개 도구가 보입니다.

파일을 직접 관리하고 싶을 때

1
편집기에서 ~/.claude.json을 엽니다. Windows에서는 %USERPROFILE%\.claude.json입니다. Claude Code가 처음 실행될 때 만듭니다.
2
최상위 mcpServers 객체에 이것을 병합합니다. 이미 있는 서버는 그대로 둡니다.
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
최상위란 파일 루트의 다른 키들과 나란한 위치를 뜻합니다. 프로젝트 경로 아래의 항목은 그 프로젝트에서만 로드됩니다.

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

Windows

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

4
파일을 저장하고 새 세션을 시작합니다.
다음이 보여야 합니다: /mcp 목록에 skillry.

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

1
터미널에서 실행합니다:
터미널
```
claude mcp get skillry
```
다음이 보여야 합니다: Scope: User config (available in all your projects), Status: ✔ Connected, 그리고 추가한 npx 명령.
2
모든 서버의 상태를 한 번에 보려면 claude mcp list를 실행합니다. 세션 안에서는 /mcp가 같은 목록을 보여 주고 서버의 도구를 열 수 있게 합니다.

첫 확인이 서버를 시작하고, 첫 시작은 skillry-cli를 내려받습니다. 10초 이상 기다려 주세요. 그 뒤에도 ✘ Failed to connect가 남아 있으면 Node나 npx가 없다는 뜻입니다. 아래를 보세요.

첫 검색 해 보기

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

1
Claude Code에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트
```
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 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.

설치할 때 승인하기

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

1
Claude Code에게 선택한 Skill을 설치해 달라고 요청합니다. 예: 이 프로젝트에 설치해 줘.
다음이 보여야 합니다: 에이전트가 계정 연결이 필요하다고 알리고 브라우저를 엽니다. 터미널 클라이언트에서는 링크만 출력될 수 있으니 직접 열어 주세요.
2
페이지의 기기 코드가 에이전트에 표시된 것과 같은지 확인하고, 요청받으면 Skillry에 로그인한 뒤 Approve를 선택합니다.
다음이 보여야 합니다: Authorization approved와 에이전트로 돌아가라는 안내. 에이전트가 몇 초 안에 이를 감지하고 설치를 끝냅니다.

승인은 7일 동안 유효하며 운영체제의 키링(macOS는 키체인, Windows는 자격 증명 관리자)에 저장됩니다. 만료되면 에이전트가 다시 승인을 요청할 뿐입니다. 더 일찍 로그아웃하려면 에이전트에게 Skillry 계정 연결을 해제해 달라고 요청하세요.

/mcp에 Skillry가 없을 때

보이는 현상	예상 원인	해결 방법
`/mcp`에 skillry가 없음	다른 폴더에서 로컬 범위로 추가했거나, 추가하기 전에 세션이 시작됨	`claude mcp get skillry`를 실행합니다. `Scope: Local config`라고 나오면 제거하고 `--scope user`로 다시 추가합니다. 사용자 범위라고 나오면 새 세션을 시작합니다.
`claude mcp add`가 “was not saved”를 출력함	Claude Code가 `~/.claude.json`에 쓸 수 없었음	다른 Claude Code 세션을 닫고, 파일이 읽기 전용이 아닌지 확인한 뒤 명령을 다시 실행합니다.
Mac에서는 연결되는데 Windows PC에서는 실패함	Windows 항목이 `cmd /c` 없이 `npx`를 시작함	`claude mcp remove skillry -s user`를 실행하고, 이 페이지의 Windows 명령을 추가합니다.
서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음	`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
사용자 설정에서 서버를 제거합니다:
터미널
```
claude mcp remove skillry -s user
```
다음이 보여야 합니다: Removed MCP server skillry from user config.
2
서버는 두고 한 프로젝트에서만 끄려면 /mcp에서 토글합니다. Claude Code가 프로젝트별로 기억합니다.

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

레퍼런스

항목	macOS	Windows
설정 파일(user 및 local 범위)	`~/.claude.json`	`%USERPROFILE%\.claude.json`
실행 명령	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
확인	`claude mcp get skillry`	같음
제거	`claude mcp remove skillry -s user`	같음

Claude Code가 저장하는 항목(macOS)

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

범위 우선순위, 프로젝트 승인, 그 밖의 모든 옵션은 공식 MCP 문서에 있습니다.

자주 묻는 질문

프로젝트마다 명령을 실행해야 하나요?

아니요. --scope user를 쓰면 Skillry를 모든 프로젝트에서 쓸 수 있습니다. 기본 로컬 범위는 명령을 실행한 폴더에 묶어 버립니다.

Claude Code를 재시작해야 하나요?

새 세션이 서버를 인식합니다. 열린 세션에서는 상태 점검 후 /mcp에 표시됩니다.

팀이 항목을 공유할 수 있나요?

예. --scope project가 저장소의 .mcp.json에 기록하고, 각 팀원이 그곳에서 Claude Code를 처음 열 때 승인합니다.

출처

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

이전개요 다음Codex