Connecte Claude Code, Gemini CLI ou n'importe quel client MCP à ton compte Musy. Lis tes collections, pousse des fragments, parcours INSPIRE — directement depuis ton terminal.
Musy expose un serveur MCP pour que tout agent qui parle le protocole — Claude Code, Gemini CLI, clients Python custom, outils internes — puisse lire tes collections, y déposer des fragments, parcourir INSPIRE, et lancer une recherche Hyper-Library. Tout sous ton compte, scopé à tes tokens, révocable en un clic.
Ce guide t'explique comment générer un token et le brancher dans les deux clients les plus courants.
Onze outils sont exposés aujourd'hui, regroupés par scope :
core — primitives Musy : whoami, list_my_collections, get_collection, search_musy, get_inspire_feed, add_url_to_collection.read + search + recipes — Hyper-Library : search_files, get_document, list_recipes, get_recipe.vault — dashboard admin : get_vault_summary.Chaque outil revérifie l'autorisation côté serveur. Un token ne peut jamais lire le contenu privé d'un autre utilisateur.
/account/secrets (ou utilise le hub Atelier de la Galaxy Nav → "Secret Vault" — la même page héberge tes clés BYOK et tes tokens MCP).core suffit. Garde vault désactivé sauf si l'agent doit vraiment accéder aux lectures admin.musy_mcp_ et n'est affiché qu'une seule fois. Traite-le comme un mot de passe.Le token ne quitte jamais Musy en clair après création. Seul son hash SHA-256 est stocké.
Claude Code lit les serveurs MCP depuis ~/.config/claude-code/mcp.json (ou une config projet — voir docs Anthropic). Ajoute une entrée :
{
"mcpServers": {
"musy": {
"url": "https://musy.gallery/api/mcp",
"headers": {
"Authorization": "Bearer musy_mcp_TON_TOKEN_ICI"
}
}
}
}Redémarre Claude Code et le serveur musy apparaît dans /mcp. Ton agent dispose maintenant de 11 outils :
> claude qu'y a-t-il dans ma collection "Reading list" ?
[utilise: list_my_collections, puis get_collection]
Tu as 12 items dans "Reading list" :
• "Why Functional Programming Matters" — John Hughes
• ...
Gemini CLI utilise ~/.gemini/settings.json :
{
"mcpServers": {
"musy": {
"url": "https://musy.gallery/api/mcp",
"headers": {
"Authorization": "Bearer musy_mcp_TON_TOKEN_ICI"
}
}
}
}Redémarre gemini et la même surface d'outils est disponible.
L'endpoint parle simplement JSON-RPC 2.0 sur POST. Tout client compatible MCP fonctionne ; si tu codes ton propre client :
curl -X POST https://musy.gallery/api/mcp \
-H "Authorization: Bearer musy_mcp_TON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'Puis tools/list pour énumérer, tools/call avec { name, arguments } pour invoquer.
Le flow agent le plus courant. L'agent appelle list_my_collections, pioche celle qui correspond, puis add_url_to_collection :
> claude sauvegarde https://www.example.com/article dans ma Reading list
[utilise: list_my_collections, trouve id="rdg_abc123"]
[utilise: add_url_to_collection avec collectionId="rdg_abc123", url=...]
✓ Ajouté à Reading list. Le titre a été unfurled automatiquement : "..."
L'outil add_url_to_collection unfurled l'URL via Open Graph — titre, description, thumbnail sont hot-linked depuis le CDN source, jamais cachés sur Musy. Même posture juridique que le client web.
> claude quels fragments sont en haut de mon flux INSPIRE ?
[utilise: get_inspire_feed avec limit=10]
Voici 10 depuis tes curateurs suivis :
1. "Brian Eno — Reflection" par @leon (Spotify)
2. "Plans de salle berlinois" par @claire-arc (Are.na)
...
> claude est-ce que j'ai du Bauhaus dans mes collections ?
[utilise: search_musy avec query="Bauhaus"]
Trois résultats à travers collections + posts :
- Collection "Architecture du XXe" : ...
- Post de @leon daté 2026-04-12 : ...
/account/secrets — instantané.lastUsedAt pour repérer une activité dormante ou inattendue.core ne peut pas toucher à ton Hyper-Library ; un token avec seulement read ne peut pas créer de post.musy_mcp_xxxx…) est loggable.Aujourd'hui l'endpoint MCP hérite des mêmes rate limits per-user que le reste de /api. On expose ça sans quota publié pendant la beta privée. Si ton agent tourne fort, attends-toi à une erreur -32000 avec un hint d'attente — backoff et retry.
Prévu pour les sprints suivants :
create_post), follow/unfollow, save/like@musy/mcp-server qui mirror cet endpoint, pour le dev localTu veux un outil qui n'existe pas encore ? Ouvre une issue avec le contrat que tu attends et on priorise.