Assistants

MCP Libris Translate

Le serveur MCP permet à un assistant de consulter la bibliothèque, de préparer le contexte et de piloter les travaux dans la limite des droits de votre compte.

Connexion

Créez un jeton d’automatisation dans Mon compte › Jetons d’API. Le MCP est compris dans les formules Studio et Pro : avec une autre licence, l’appel répond 402 avec le code automation_not_licensed. Choisissez les permissions nécessaires.
Dans votre client MCP, choisissez un serveur HTTP distant à l’adresse https://libris.example/mcp, remplacée par l’adresse HTTPS de votre installation.
Fournissez Authorization: Bearer avec le secret provenant du stockage sécurisé de votre client. Initialisez la connexion puis demandez tools/list.

Le transport accepte POST /mcp en JSON-RPC et répond en JSON. La version annoncée est 2025-06-18. Il n’expose ni flux SSE GET, ni ressources ou prompts MCP. Une erreur 405 sur GET /mcp ne signifie donc pas que POST est indisponible.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "demo-client", "version": "1.0" }
  }
}

Procédure recommandée

Importez d’abord le livre avec l’interface ou l’API REST : le catalogue MCP ne contient aucun outil d’envoi de fichiers.

Demandez à l’assistant de lister les livres, de lire le livre choisi, puis d’appeler estimate_job avant start_job. Les identifiants doivent provenir des réponses précédentes. Suivez l’avancement avec list_jobs ; utilisez control_job pour suspendre, reprendre, annuler ou relancer un travail. Ces opérations peuvent appeler des modèles payants.

Deux outils imposent des contrôles supplémentaires. Par défaut, propagate_term produit uniquement un aperçu : il compte les passages, les occurrences et les chapitres, isole les corrections humaines et présente jusqu’à cinq exemples. L’écriture exige un nouvel appel avec dry_run=false et confirm=true. control_series peut lancer, suspendre, reprendre ou annuler une série entière. Son action start exige la permission pipeline:start en plus de jobs:control, afin qu’un jeton autorisé à suspendre une série ne puisse pas engager de frais sans permission supplémentaire.

Les suppressions exigent confirm=true : vérifiez l’objet concerné avant de les autoriser. Utilisez shelve_book pour un simple archivage. export_book renvoie du texte ou du Markdown et peut tronquer un résultat volumineux ; demandez un intervalle de chapitres pour les livres longs, et utilisez l’interface ou l’API REST pour obtenir un EPUB.

Catalogue des outils

Chaque appel reste soumis aux permissions du jeton et aux droits effectifs du compte. Le catalogue annoncé par votre installation fait foi.

Outil	Permission	Usage
`list_books`	`library:read`	Lister les livres
`get_book`	`library:read`	Consulter un livre et son état
`list_chapters`	`library:read`	Lister les chapitres d'un livre
`book_quality`	`library:read`	Consulter les indicateurs de qualité
`configure_book`	`library:write`	Modifier les réglages d'un livre
`shelve_book`	`library:write`	Archiver ou désarchiver
`delete_book`	`library:delete`	Supprimer un livre
`list_series`	`series:read`	Lister les séries
`get_series`	`series:read`	Consulter une série
`create_series`	`library:write`	Créer une série
`update_series`	`library:write`	Modifier les réglages d'une série
`attach_volume`	`library:write`	Rattacher ou détacher un volume
`series_consistency`	`series:read`	Auditer la cohérence d'une série
`delete_series`	`library:delete`	Supprimer une série
`list_terms`	`library:read`	Lire un glossaire
`add_term`	`library:write`	Ajouter un terme
`edit_term`	`library:write`	Modifier un terme
`propagate_term`	`library:write`	Propager un terme après aperçu
`delete_term`	`library:delete`	Supprimer un terme
`read_bible`	`library:read`	Consulter la Book Bible d’un livre ou d’une série
`estimate_job`	`library:read`	Estimer le coût
`start_job`	`pipeline:start`	Lancer un travail
`list_jobs`	`jobs:read`	Suivre les travaux d’un livre
`control_job`	`jobs:control`	Piloter un travail
`control_series`	`jobs:control`	Lancer, suspendre ou reprendre une série
`export_book`	`results:read`	Lire la traduction
`list_providers`	`content:write`	Lister les fournisseurs de modèles accessibles
`licence_status`	`library:read`	État de la licence

Refus et limites

Un appel d’outil refusé peut répondre avec isError=true dans le résultat MCP : lisez ce champ, pas seulement le statut HTTP. Révoquer le jeton coupe l’accès. Les plafonds du jeton, les limites de fréquence, la licence et les pauses de travaux restent applicables.

Jetons et budgets · API REST · Référence technique MCP