Telaria MCP — Scope V1
Note de mise à jour (2026-06-14) : ce document remplace la définition V1 initiale (
draft_readme_basic). L'ancre V1 est désormaissearch_docs, qui exerce toute la chaîne RAG de bout en bout. Cf.ia-mcp.md§5 pour la décision.
1. Objectif du scope V1
Exposer la documentation Telaria à un agent IA (Claude Desktop, Cursor…) via le protocole MCP officiel. V1 = lecture seule, adossée au cœur RAG (L0).
Critère de validation : un client Claude Desktop peut interroger le corpus via search_docs et obtenir des passages pertinents avec score et source.
2. Les 3 outils V1
| Outil | Rôle | Auth |
|---|---|---|
list_docs |
Liste les documents indexés (chemin, titre) — filtre les exclusions (.aiignore, inputs/legacy/) |
scope tool:list_docs ∧ project:<slug> |
read_doc |
Retourne le Markdown brut d'un document + métadonnées (mtime, hash, taille) | scope tool:read_doc ∧ project:<slug> |
search_docs |
Recherche sémantique via RetrievalService L0 → top-k passages avec score cosinus et source |
scope tool:search_docs ∧ project:<slug> |
tools/list : auth optionnelle (catalogue statique sans token, filtré par scopes avec token).
tools/call : auth toujours obligatoire.
3. Hors scope V1 (→ V2+)
- Outils d'édition (
apply_patch,normalize_headings…) - Outils d'audit qualité (
audit_rgaa,check_links…) - Outils de génération (
draft_readme_basic,draft_user_doc…) - Resources MCP (exposer docs en ressources par URI)
- Prompts MCP (gabarits de prompts)
draft_readme_basicétait l'ancienne cible V1. Il est déclassé : il ne sollicite ni la doc ni le cœur RAG, ce qui ne démontre pas l'intégration MCP. Archivé en V2+.
4. Gouvernance V1
- Multi-tenant : un
Tenantisole projets, tokens, quotas. - Scopes 2D :
tool:<name>∧project:<slug>— vérifiés avant toute exécution. - ADN :
SCRATCH.mdjamais exposé,inputs/legacy/en lecture seule uniquement. - Quota : par (tenant, outil) — dépassement → erreur explicite.
- Audit : chaque appel tracé dans
mcp_tool_audit_log.
5. Statut d'implémentation
v0.1.3 (2026-05-30) — en production.
- ✅
tools/list(auth optionnelle, catalogue filtré par scopes) - ✅
tools/callpour les 3 outils V1 - ✅ Auth token opaque SHA-256, scopes, quotas par tenant+outil
- ✅ Transport
stdio+ Streamable HTTP - ✅ Audit log (
mcp_tool_audit_log)
Voir aussi
../../specs/ia-mcp.md— spécification consolidée (source de vérité)tlr-mcp-outils.md— schémas JSON des 3 outils V1tlr-mcp-implementation-symfony.md— pipeline d'exécution