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

Cursor에서 Skillry MCP 연결하기

Cursor는 링크나 mcp.json으로 MCP 서버를 설치합니다. Skillry MCP 페이지의 Add to Cursor 버튼은 항목 전체를 Cursor에 넘겨 줍니다. 파일을 직접 보고 싶다면 ~/.cursor/mcp.json에 항목을 직접 추가하세요.

대상
Cursor 사용자
소요 시간
완료까지 3분
확인
공식 문서, 2026년 10월 28일

짧은 답변

  1. 1skillry.dev/mcp에서 Cursor를 고르고 Add to Cursor를 누른 뒤 Cursor 안에서 서버를 확인합니다.
  2. 2또는 skillry 항목을 ~/.cursor/mcp.json(모든 프로젝트)이나 .cursor/mcp.json(한 프로젝트)에 병합합니다.
  3. 3Cursor의 Customize 페이지에서 확인합니다. skillry가 켜져 있고 도구 목록이 보여야 합니다.

시작하기 전에

2026년 10월 28일에 공식 문서와 대조했습니다. 이 클라이언트의 실제 설치 환경에서는 아직 실행하지 않았습니다. 사용 중인 기기에서 단계가 다르면 페이지 하단의 문제 신고로 알려 주세요.

  • Cursor가 설치되어 있고 로그인된 상태.
  • Node.js 22 이상(node --version). Cursor는 npx로 서버를 시작합니다.
파일적용 범위이럴 때 사용
~/.cursor/mcp.json이 컴퓨터의 모든 프로젝트어디서나 Skillry를 쓰고 싶을 때. 이 가이드.
프로젝트 안의 .cursor/mcp.json그 프로젝트만저장소를 통해 팀과 공유하고 싶을 때.

Cursor에 Skillry 추가하기

가장 빠름. Cursor가 저장 전에 항목을 보여 줍니다
  1. 1

    skillry.dev/mcp를 열고 Cursor와 운영체제를 선택합니다.

  2. 2

    Add to Cursor를 선택합니다. 브라우저가 Cursor를 열지 물으면 허용합니다.

  3. 3

    Cursor에서 skillry라는 서버와 npx 명령을 검토한 뒤 확인합니다.

    다음이 보여야 합니다: Customize 페이지의 MCP 목록에 skillry.

    Cursor가 열렸다고 Skillry가 연결된 것은 아닙니다. Customize 페이지를 확인하거나 아래의 첫 검색을 실행하세요.

Cursor가 연결되었는지 확인하기

  1. 1

    사이드바에서 Customize를 열고 MCP 서버 중에서 skillry를 찾습니다.

    다음이 보여야 합니다: 서버가 켜져 있고 상태가 정상이며, search_skills로 시작하는 도구가 나열됩니다.

  2. 2

    오류가 표시되면 선택해서 로그를 읽습니다. 첫 시작은 패키지를 내려받느라 10초 이상 걸릴 수 있습니다.

설치할 때 승인하기

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

  1. 1

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

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

  2. 2

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

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

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

    Customize 페이지에서 skillry를 제거하거나 mcp.json에서 항목을 삭제합니다. 유지하되 로드되지 않게 하려면 거기서 끄세요.

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

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

레퍼런스

항목macOSWindows
전역 설정 파일~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.json
프로젝트 설정 파일.cursor/mcp.json같음
실행 명령npx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
확인Customize 페이지같음
Cursor가 저장하는 항목(macOS)
{
  "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를 재시작하세요.

출처

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