짧은 답변
- 1skillry.dev/mcp에서 Cursor를 고르고 Add to Cursor를 누른 뒤 Cursor 안에서 서버를 확인합니다.
- 2또는
skillry항목을~/.cursor/mcp.json(모든 프로젝트)이나.cursor/mcp.json(한 프로젝트)에 병합합니다. - 3Cursor의 Customize 페이지에서 확인합니다.
skillry가 켜져 있고 도구 목록이 보여야 합니다.
시작하기 전에
2026년 10월 28일에 공식 문서와 대조했습니다. 이 클라이언트의 실제 설치 환경에서는 아직 실행하지 않았습니다. 사용 중인 기기에서 단계가 다르면 페이지 하단의 문제 신고로 알려 주세요.
- Cursor가 설치되어 있고 로그인된 상태.
- Node.js 22 이상(
node --version). Cursor는npx로 서버를 시작합니다.
| 파일 | 적용 범위 | 이럴 때 사용 |
|---|---|---|
~/.cursor/mcp.json | 이 컴퓨터의 모든 프로젝트 | 어디서나 Skillry를 쓰고 싶을 때. 이 가이드. |
프로젝트 안의 .cursor/mcp.json | 그 프로젝트만 | 저장소를 통해 팀과 공유하고 싶을 때. |
Cursor에 Skillry 추가하기
- 1
skillry.dev/mcp를 열고 Cursor와 운영체제를 선택합니다.
- 2
Add to Cursor를 선택합니다. 브라우저가 Cursor를 열지 물으면 허용합니다.
- 3
Cursor에서
skillry라는 서버와npx명령을 검토한 뒤 확인합니다.다음이 보여야 합니다: Customize 페이지의 MCP 목록에
skillry.Cursor가 열렸다고 Skillry가 연결된 것은 아닙니다. Customize 페이지를 확인하거나 아래의 첫 검색을 실행하세요.
- 1
~/.cursor/mcp.json을 만들거나 엽니다. 한 프로젝트만이라면 그 프로젝트 안의.cursor/mcp.json을 사용합니다. - 2
mcpServers객체에 이것을 병합합니다. 이미 있는 서버는 그대로 둡니다.macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows에서는 대신 이 항목을 사용합니다.
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
파일을 저장합니다. Cursor가 변경을 감지합니다. 서버가 나타나지 않으면 Cursor를 재시작합니다.
다음이 보여야 합니다: Customize 페이지의 MCP 목록에
skillry.
Cursor가 연결되었는지 확인하기
- 1
사이드바에서 Customize를 열고 MCP 서버 중에서
skillry를 찾습니다.다음이 보여야 합니다: 서버가 켜져 있고 상태가 정상이며,
search_skills로 시작하는 도구가 나열됩니다. - 2
오류가 표시되면 선택해서 로그를 읽습니다. 첫 시작은 패키지를 내려받느라 10초 이상 걸릴 수 있습니다.
첫 검색 해 보기
검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.
- 1
Cursor의 에이전트 채팅에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트 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 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.
Cursor가 Skillry를 보지 못할 때
| 보이는 현상 | 예상 원인 | 해결 방법 |
|---|---|---|
Customize 페이지에 skillry가 없음 | 파일 위치가 잘못되었거나 JSON이 유효하지 않음 | 경로(모든 프로젝트라면 ~/.cursor/mcp.json)를 확인하고 JSON을 검증합니다. 끝에 쉼표가 없어야 하고, skillry가 mcpServers 안에 있어야 합니다. |
| Add to Cursor 링크를 눌러도 아무 일이 없음 | 브라우저가 cursor:// 링크를 차단함 | 브라우저가 Cursor를 열도록 허용하거나 mcp.json 편집 탭을 사용합니다. |
| 서버가 꺼져 있음 | Customize 페이지에서 꺼짐 | 켜세요. 어느 쪽이든 Cursor는 항목을 유지합니다. |
| 서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음 | 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
Customize 페이지에서
skillry를 제거하거나mcp.json에서 항목을 삭제합니다. 유지하되 로드되지 않게 하려면 거기서 끄세요.다음이 보여야 합니다: MCP 목록에서
skillry가 사라집니다.
항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 항목을 제거하고 7일 뒤 승인이 만료되도록 두세요.
레퍼런스
| 항목 | macOS | Windows |
|---|---|---|
| 전역 설정 파일 | ~/.cursor/mcp.json | %USERPROFILE%\.cursor\mcp.json |
| 프로젝트 설정 파일 | .cursor/mcp.json | 같음 |
| 실행 명령 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 확인 | Customize 페이지 | 같음 |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Add to Cursor 링크는 cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=…이며, config는 같은 항목을 base64로 인코딩한 것입니다. Cursor가 이를 디코딩해 저장 전에 보여 줍니다. 자세한 내용은 설치 링크 문서에 있습니다.
자주 묻는 질문
Add to Cursor 링크는 안전한가요?
서버 이름과 실행 명령만 base64로 인코딩해 담고 있습니다. 확인하기 전에 Cursor가 둘 다 보여 주고, 확인할 때까지 아무것도 실행되지 않습니다.
전역 파일과 프로젝트 파일 중 어느 것을?
나 혼자 쓰려면 전역(~/.cursor/mcp.json). 팀이 저장소에서 받아야 하면 프로젝트(.cursor/mcp.json).
Cursor를 재시작해야 하나요?
보통은 아닙니다. 파일이 바뀌면 Customize 페이지가 새로 고쳐집니다. 서버가 끝내 나타나지 않으면 Cursor를 재시작하세요.
출처
이 가이드가 도움이 되었나요?
