Usar o Klavierstuck no seu assistente de IA

O Klavierstuck tem um servidor MCP público (Model Context Protocol, a forma padrão de os assistentes de IA chamarem ferramentas externas). Adicione-o ao Claude ou a outro cliente MCP e o seu assistente poderá pesquisar no catálogo e consultar obras, compositores e catálogos, com um link para este site e a fonte dos dados em cada resposta.

Endereço do servidor

https://klavierstuck.org/mcp

Sem conta e sem chave: o servidor é gratuito, público e só de leitura.

No Claude

  1. Abra as Configurações e depois Conectores.
  2. Escolha “Adicionar conector personalizado”, dê-lhe o nome Klavierstuck e cole o endereço do servidor.
  3. Em uma nova conversa, pergunte por exemplo: “Que peças em ré menor estão nos níveis 4 a 6 do Piano Syllabus?”

Nos planos Team ou Enterprise, um proprietário da organização adiciona primeiro o conector.

Em outro cliente MCP

Adicione um servidor remoto com o endereço acima (transporte Streamable HTTP). A configuração depende do cliente; normalmente fica assim:

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

Um cliente que só executa servidores locais pode conectar-se através da ponte mcp-remote:

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

O que o seu assistente pode fazer

O servidor oferece sete ferramentas só de leitura. O assistente escolhe a certa sozinho; eis uma pergunta que usa cada uma.

search_works
Pesquisar obras por título ou número de catálogo, compositor, tonalidade, gênero, instrumento e dificuldade. “Que peças em ré menor estão nos níveis 4 a 6 do Piano Syllabus?”
get_work
Uma obra em detalhe: números de catálogo, tonalidade, datas, duração, níveis, andamentos e links (IMSLP, Wikipedia…). “Quero saber sobre os Noturnos de Chopin, Op. 27.”
get_composer
As datas de um compositor, os seus catálogos, movimentos estilísticos e obras por gênero. “O que escreveu Chopin para piano?”
list_composers
Os compositores do catálogo, ou os que correspondem a um nome. “Que compositores abrange o Klavierstuck?”
get_catalog
Um catálogo (Op., BWV, KK…) por ordem, com a tonalidade, a data e os níveis de cada obra. “Liste as primeiras obras do catálogo KK de Chopin.”
list_difficulty_scales
As escalas de dificuldade (Piano Syllabus, ABRSM, RCM…) e os seus níveis. “Que escalas de dificuldade posso usar e o que significam os seus níveis?”
list_eras_and_movements
As épocas e os movimentos estilísticos, com o número de compositores de cada um. “Que movimentos estilísticos pertencem à época romântica?”

Resolução de problemas

  • O conector não responde ou as ferramentas não aparecem: verifique se o endereço é exatamente https://klavierstuck.org/mcp, se o conector está ativado na conversa, e comece uma nova conversa.
  • O assistente diz que um compositor, tonalidade ou escala corresponde a várias entradas ou a nenhuma: o servidor lista os candidatos que conhece. Pergunte de novo com o nome completo, ou com o slug do endereço da página em klavierstuck.org.
  • Falta uma obra ou um detalhe parece errado: as respostas são as do site, por isso comunique-o, tal como para o site, para contact@klavierstuck.org.

Citar os dados

Cada resposta indica o link klavierstuck.org de cada obra, compositor ou catálogo e uma linha de fonte como “Levels: Piano Syllabus, PianoLibrary · Data: Klavierstuck”. Mantenha ambas quando reutilizar uma resposta: os níveis de dificuldade pertencem às instituições e aos sites que os publicam.

As respostas são paginadas (no máximo 50 obras por pesquisa, 100 entradas de catálogo por página). O Klavierstuck é um projeto amador; confirme as informações importantes nas fontes indicadas na página Sobre.