짧은 답변
- 1클라이언트에 항목 하나를 추가합니다. 이 항목은
npx --yes skillry-cli@latest mcp(Windows에서는cmd /c npx …)를 실행합니다. 직접 내려받을 것도, API 키도 없습니다. - 2검색은 계정 없이 됩니다. 처음 설치할 때 에이전트가 브라우저 페이지를 열고, 거기서 한 번 승인합니다. 승인은 운영체제 키링에 7일 동안 유지됩니다.
- 3아래에서 클라이언트를 골라 정확한 단계를 확인하세요. 모든 클라이언트 페이지는 연결 확인 방법과 실패했을 때의 대처로 끝납니다.
필요한 것
- Mac 또는 Windows PC. 승인이 운영체제 키링에 저장되는데 Skillry가 키체인과 자격 증명 관리자만 지원하므로 Linux는 아직 지원하지 않습니다.
- Node.js 22 이상.
node --version으로 확인하고, 명령이 없으면 nodejs.org에서 LTS 버전을 설치합니다. - 아래 여섯 클라이언트 중 하나. 로그인되어 있고 최신 상태여야 합니다.
- Skillry 계정은 설치할 때만 필요합니다. 검색과 Skill 상세 보기에는 아무것도 필요 없습니다. 무료 계정은 무료 Skill을 설치하고, Premium Skill은 구매나 플랜이 필요합니다.
클라이언트 선택
Claude Code아무 터미널에서 명령 하나. macOS에서 테스트 완료.
Codex명령 하나, 또는 ChatGPT 데스크톱 앱 설정. CLI, 앱, IDE 확장이 공유합니다.
CursorAdd to Cursor 링크, 또는 mcp.json에 두 줄.VS Code링크, Command Palette, code --add-mcp, 또는 mcp.json. Copilot이 필요합니다.
Gemini CLI / Antigravitygemini mcp add, 또는 Antigravity가 읽는 공유 mcp_config.json.
Claude DesktopSkillry 데스크톱 확장 프로그램 설치순서대로 일어나는 일
클라이언트에 Skillry를 추가합니다
클라이언트는 처음 필요할 때 npx로 로컬 서버를 시작합니다. 첫 시작은 패키지를 내려받느라 10초 이상 걸릴 수 있고, 이후에는 바로 시작됩니다.
만들고 싶은 것을 설명합니다
에이전트가 search_skills를 호출해 미리보기 링크, 입력, 의존성, 외부 비용이 포함된 후보를 보여 줍니다. 계정은 필요 없습니다.
하나를 골라 설치하라고 말합니다
에이전트가 get_skill_access를 호출합니다. 계정이 아직 연결되지 않았으면 아래에 설명한 브라우저 페이지를 엽니다.
브라우저에서 승인합니다
에이전트가 지정한 에이전트와 범위에 Skill을 설치합니다. 설치는 Skill을 실행하지 않습니다. 나중에 요청할 때 에이전트가 실행합니다.
첫 검색 해 보기
검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.
- 1
에이전트에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트 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를 보지 못할 때
먼저 클라이언트별 페이지를 보세요. 각 클라이언트 고유의 확인 방법이 있습니다. 아래 문제는 모든 클라이언트에서 일어납니다.
| 보이는 현상 | 예상 원인 | 해결 방법 |
|---|---|---|
| 에이전트가 Skillry 도구가 없다고 말함 | 항목이 다른 프로젝트나 범위에 추가되었거나, 변경 후 클라이언트를 재시작하지 않음 | 클라이언트 페이지에 있는 확인 명령을 실행합니다. 서버가 없으면 사용자 범위로 다시 추가하고, 목록에 있으면 클라이언트를 재시작하거나 새로 고칩니다. |
| 검색은 되지만 설치가 일일 한도로 거부됨 | 계정이 오늘 Skill 50회 로드에 도달함 | 한도는 00:00 UTC에 초기화됩니다. 그동안 검색은 계속 됩니다. |
| 서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음 | 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을 구매하거나 구독한 뒤 다시 요청합니다. 그전에는 아무것도 결제되지 않습니다. |
한도와 경계
하루 50회
계정당 Skill 로드 횟수. MCP, Skillry CLI, 웹사이트가 공유합니다. 검색은 계산되지 않습니다.
7일
브라우저 승인 한 번이 유지되는 기간. 만료되면 에이전트가 다시 요청합니다.
API 키 불필요
붙여 넣을 것이 없습니다. 승인은 에이전트가 아니라 운영체제가 저장합니다.
도구 12개
검색, 확인, 설치, 업데이트, 계정 도구. 모든 인수는 레퍼런스에 있습니다.
- 설치는 에이전트의 Skills 폴더에 파일을 추가합니다. Skillry는 Skill을 실행하지 않고 모델 호출 비용도 내지 않습니다. 이미지나 영상 모델이 필요한 Skill은 내 도구나 키를 사용하며, 에이전트가 선택 전에 그 비용을 보여 줍니다.
- 서버는 내 컴퓨터에서 돌아가고, 카탈로그, 접근 확인, 다운로드를 위해서만 skillry.dev와 통신합니다. 카탈로그와 패키지 내용은 신뢰할 수 없는 데이터로 취급합니다.
- 언제든 연결을 끊을 수 있습니다. 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 클라이언트에서 항목을 제거하세요.
모든 도구는 레퍼런스에
Skillry MCP 도구 레퍼런스에 12개 도구의 인수, 기본값, 예시, 복구 경로가 모두 있습니다. 연결하는 데는 필요 없지만, “무엇을 요청할 수 있나?”에 정확히 답해 줍니다.
자주 묻는 질문
API 키가 필요한가요?
아니요. 검색에는 아무것도 필요 없고, 설치에는 브라우저에서 Skillry 계정을 한 번 승인하면 됩니다. 저장되는 유일한 비밀 정보는 운영체제 키링이 7일 동안 보관하는 승인입니다.
예전 방식으로 Skill을 계속 설치할 수 있나요?
예. 설치 프롬프트, Skillry CLI, ZIP 다운로드 모두 그대로 유지됩니다. Skill 설치하기를 보세요.
서버가 내 파일을 어딘가로 보내나요?
아니요. 로컬에서 돌아가며, 카탈로그, 접근 확인, 요청한 Skill 다운로드를 위해서만 skillry.dev에 접속합니다.
어떤 클라이언트를 골라야 하나요?
평소 쓰는 클라이언트를 선택하세요. Claude Code, Codex, Gemini CLI는 명령으로, Cursor와 VS Code는 설치 링크로, Claude Desktop은 Skillry .mcpb 확장 프로그램으로 연결합니다.
출처
이 가이드가 도움이 되었나요?