Utiliser Klavierstuck dans votre assistant IA

Klavierstuck dispose d’un serveur MCP public (Model Context Protocol, le moyen standard pour un assistant IA d’appeler des outils externes). Ajoutez-le à Claude ou à tout autre client MCP : votre assistant pourra chercher dans le catalogue et consulter œuvres, compositeurs et catalogues, avec dans chaque réponse un lien vers ce site et la source des données.

Adresse du serveur

https://klavierstuck.org/mcp

Ni compte ni clé : le serveur est gratuit, public et en lecture seule.

Dans Claude

  1. Ouvrez Paramètres, puis Connecteurs.
  2. Choisissez « Ajouter un connecteur personnalisé », nommez-le Klavierstuck et collez l’adresse du serveur.
  3. Dans une nouvelle conversation, demandez par exemple : « Quelles pièces en ré mineur sont de niveau 4 à 6 sur Piano Syllabus ? »

Avec une offre Team ou Enterprise, un propriétaire de l’organisation ajoute d’abord le connecteur.

Dans un autre client MCP

Ajoutez un serveur distant avec l’adresse ci-dessus (transport Streamable HTTP). Le fichier de configuration dépend du client ; il ressemble en général à ceci :

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

Un client qui ne lance que des serveurs locaux peut s’y connecter grâce au pont mcp-remote :

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

Ce que votre assistant peut faire

Le serveur propose sept outils en lecture seule. Votre assistant choisit lui-même le bon ; voici une question qui utilise chacun d’eux.

search_works
Chercher des œuvres par titre ou numéro de catalogue, compositeur, tonalité, genre, instrument et difficulté. « Quelles pièces en ré mineur sont de niveau 4 à 6 sur Piano Syllabus ? »
get_work
Une œuvre en détail : numéros de catalogue, tonalité, dates, durée, niveaux, mouvements et liens (IMSLP, Wikipédia…). « Parle-moi des Nocturnes op. 27 de Chopin. »
get_composer
Les dates d’un compositeur, ses catalogues, ses courants artistiques et ses œuvres par genre. « Qu’a écrit Chopin pour le piano ? »
list_composers
Les compositeurs du catalogue, ou ceux qui correspondent à un nom. « Quels compositeurs Klavierstuck couvre-t-il ? »
get_catalog
Un catalogue (op., BWV, KK…) dans l’ordre, avec la tonalité, la date et les niveaux de chaque œuvre. « Donne-moi les premières œuvres du catalogue KK de Chopin. »
list_difficulty_scales
Les barèmes de difficulté (Piano Syllabus, ABRSM, RCM…) et leurs niveaux. « Quels barèmes de difficulté puis-je utiliser, et que signifient leurs niveaux ? »
list_eras_and_movements
Les époques et courants artistiques, avec le nombre de compositeurs de chacun. « Quels courants artistiques appartiennent à l’époque romantique ? »

Dépannage

  • Le connecteur ne répond pas ou ses outils n’apparaissent pas : vérifiez que l’adresse est exactement https://klavierstuck.org/mcp, que le connecteur est activé dans la conversation, puis ouvrez une nouvelle conversation.
  • L’assistant indique qu’un compositeur, une tonalité ou un barème correspond à plusieurs entrées ou à aucune : le serveur liste les candidats qu’il connaît. Reformulez avec le nom complet, ou avec le slug de l’adresse de la page klavierstuck.org.
  • Une œuvre manque ou une information semble fausse : les réponses sont celles du site, signalez-le donc comme pour le site, à contact@klavierstuck.org.

Citer les données

Chaque réponse donne le lien klavierstuck.org de chaque œuvre, compositeur ou catalogue, et une ligne de source comme « Levels: Piano Syllabus, PianoLibrary · Data: Klavierstuck ». Merci de garder les deux si vous réutilisez une réponse : les niveaux de difficulté viennent des organismes et sites qui les publient.

Les réponses sont paginées (50 œuvres au plus par recherche, 100 entrées de catalogue par page). Klavierstuck est un projet amateur : vérifiez les informations importantes auprès des sources citées sur la page À propos.