AI 어시스턴트에서 Klavierstuck 사용하기

Klavierstuck은 공개 MCP 서버(Model Context Protocol, AI 어시스턴트가 외부 도구를 호출하는 표준 방식)를 제공합니다. Claude나 다른 MCP 클라이언트에 추가하면 어시스턴트가 카탈로그를 검색하고 작품, 작곡가, 작품 목록을 읽을 수 있으며, 모든 답변에 이 사이트로 돌아오는 링크와 데이터 출처가 함께 표시됩니다.

서버 주소

https://klavierstuck.org/mcp

계정도 키도 필요 없습니다. 서버는 무료이며 공개되어 있고 읽기 전용입니다.

Claude에서

  1. 설정을 열고 커넥터로 이동합니다.
  2. “사용자 지정 커넥터 추가”를 선택하고 이름을 Klavierstuck으로 정한 뒤 서버 주소를 붙여 넣습니다.
  3. 새 대화에서 예를 들어 이렇게 물어보세요: “Piano Syllabus 4~6등급인 라단조 곡은 무엇인가요?”

Team 또는 Enterprise 요금제에서는 조직 소유자가 먼저 커넥터를 추가해야 합니다.

다른 MCP 클라이언트에서

위 주소로 원격 서버를 추가합니다 (Streamable HTTP 전송). 설정 파일은 클라이언트마다 다르지만 대개 다음과 같습니다:

{
  "mcpServers": {
    "klavierstuck": {
      "type": "http",
      "url": "https://klavierstuck.org/mcp"
    }
  }
}

로컬 서버만 실행할 수 있는 클라이언트는 mcp-remote 브리지를 통해 연결할 수 있습니다:

npx mcp-remote https://klavierstuck.org/mcp

어시스턴트가 할 수 있는 일

서버는 읽기 전용 도구 7개를 제공합니다. 어시스턴트가 알맞은 도구를 스스로 고르며, 아래는 각 도구를 사용하는 질문의 예입니다.

search_works
제목 또는 작품 번호, 작곡가, 조성, 장르, 악기, 난이도로 작품을 검색합니다. “Piano Syllabus 4~6등급인 라단조 곡은 무엇인가요?”
get_work
작품 하나의 자세한 정보: 작품 번호, 조성, 연도, 연주 시간, 난이도, 악장, 링크 (IMSLP, Wikipedia…). “쇼팽의 야상곡 Op. 27에 대해 알려 주세요.”
get_composer
작곡가의 생몰년, 작품 목록, 양식 사조, 장르별 작품. “쇼팽은 피아노를 위해 어떤 곡을 썼나요?”
list_composers
카탈로그에 있는 작곡가, 또는 이름과 일치하는 작곡가. “Klavierstuck에는 어떤 작곡가가 있나요?”
get_catalog
작품 목록 (Op., BWV, KK…)을 순서대로, 각 작품의 조성, 연도, 난이도와 함께 보여 줍니다. “쇼팽 KK 작품 목록의 첫 작품들을 보여 주세요.”
list_difficulty_scales
난이도 등급 체계 (Piano Syllabus, ABRSM, RCM…)와 그 등급. “어떤 난이도 등급 체계를 쓸 수 있고, 각 등급은 무엇을 뜻하나요?”
list_eras_and_movements
시대와 양식 사조, 그리고 각각의 작곡가 수. “낭만주의 시대에는 어떤 양식 사조가 있나요?”

문제 해결

  • 커넥터가 응답하지 않거나 도구가 보이지 않으면: 주소가 정확히 https://klavierstuck.org/mcp 인지, 대화에서 커넥터가 켜져 있는지 확인한 뒤 새 대화를 시작하세요.
  • 어시스턴트가 작곡가, 조성 또는 등급 체계가 여러 항목과 일치하거나 아무것도 일치하지 않는다고 하면: 서버는 알고 있는 후보를 나열합니다. 전체 이름이나 klavierstuck.org 페이지 주소의 슬러그로 다시 물어보세요.
  • 작품이 빠졌거나 정보가 잘못된 것 같으면: 답변은 사이트의 내용과 같으므로 사이트와 마찬가지로 다음 주소로 알려 주세요: contact@klavierstuck.org.

데이터 인용

모든 답변에는 각 작품, 작곡가, 작품 목록의 klavierstuck.org 링크와 “Levels: Piano Syllabus, PianoLibrary · Data: Klavierstuck” 같은 출처 표시가 함께 나옵니다. 답변을 다시 사용할 때는 두 가지를 모두 남겨 주세요. 난이도 등급은 이를 발표하는 기관과 사이트의 것입니다.

답변은 페이지 단위로 나뉩니다 (검색당 최대 50개 작품, 페이지당 최대 100개의 작품 목록 항목). Klavierstuck은 아마추어 프로젝트이므로 중요한 사실은 다음 페이지에 나열된 출처와 대조해 확인해 주세요: 소개 페이지.