Telaria MCP Bundle (PHP/Symfony)

⚠️ Spec consolidée — la référence unique du serveur MCP est désormais specs/ia-mcp.md (umbrella tlr-mcp). Ce document est conservé comme matériel source détaillé (protocole officiel, catalogue d'outils, schémas) ; en cas de divergence, ia-mcp.md fait foi.

Ce document est le point d'entrée de la spécification intégrale de Telaria MCP. Il définit les objectifs, la portée, les références normatives et l'organisation documentaire.

1. Statut et objectifs

Statut : document maître.

Objectifs :

1. Garantir une implémentation MCP conforme aux spécifications officielles.
2. Structurer les capacités serveur (resources, prompts, tools, utilitaires).
3. Encadrer sécurité, conformité RGPD et accessibilité RGAA AA.
4. Permettre une production documentaire fiable et auditée.

2. Documents de la spécification

• tlr-mcp-scope-v1.md : périmètre V1 — 3 outils lecture seule (list_docs, read_doc, search_docs).
• tlr-mcp-outils.md : catalogue d'outils V1 avec schémas JSON + réserve V2+.
• tlr-mcp-data-model.md : entités Doctrine, seeding (app:mcp:seed), audit log.
• tlr-mcp-protocole.md : versionnement, JSON-RPC, cycle de vie, transports.
• tlr-mcp-serveur.md : resources, prompts, tools et utilitaires MCP.
• tlr-mcp-securite-conformite.md : OAuth 2.1, sécurité, RGPD, RGAA, Opquast.
• tlr-mcp-exploitation.md : troubleshooting, audit log, tokens, observabilité.
• tlr-mcp-exemples.md : exemples JSON-RPC complets.
• tlr-mcp-implementation-symfony.md : implémentation Symfony.
• tlr-mcp-fondamentaux-ia.md : base IA conviviale.

3. Références normatives

Références MCP :

• Versionnement : https://modelcontextprotocol.io/specification/versioning
• Cycle de vie : https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle
• Transports : https://modelcontextprotocol.io/specification/2025-11-25/basic/transports
• Resources : https://modelcontextprotocol.io/specification/2025-11-25/server/resources
• Prompts : https://modelcontextprotocol.io/specification/2025-11-25/server/prompts
• Tools : https://modelcontextprotocol.io/specification/2025-11-25/server/tools
• Progress : https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/progress
• Cancellation : https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/cancellation
• Logging : https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging
• Tasks : https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks
• Authorization : https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization

Autres références :

• JSON-RPC 2.0 : https://www.jsonrpc.org/specification
• RGAA 4.1.2 : https://accessibilite.numerique.gouv.fr/
• WCAG 2.2 (W3C Recommendation) : https://www.w3.org/WAI/news/2023-10-05/wcag22rec/
• Opquast (référentiel qualité numérique) : https://checklists.opquast.com/fr/qualite-numerique/
• RGPD : https://eur-lex.europa.eu/eli/reg/2016/679/oj/fra

4. Version de protocole cible

La version MCP cible est la révision 2025-11-25, identifiée comme version courante par la spécification officielle. Source : https://modelcontextprotocol.io/specification/versioning

5. Portée fonctionnelle

Telaria MCP couvre :

1. Resources : exposition de contenus et métadonnées via URI.
2. Prompts : gabarits de messages et arguments.
3. Tools : outils invocables avec schémas d'entrée et sorties structurées.
4. Utilitaires : progress, cancellation, logging et tasks (expérimental).

Sources : https://modelcontextprotocol.io/specification/2025-11-25/server/resources https://modelcontextprotocol.io/specification/2025-11-25/server/prompts https://modelcontextprotocol.io/specification/2025-11-25/server/tools https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/progress https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/cancellation https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks

6. Exigences globales

1. Conformité JSON-RPC 2.0 pour tous les échanges.
2. Sécurité renforcée sur les transports (Origin, authentification, contrôle d'accès).
3. Humain dans la boucle pour les outils sensibles.
4. Conformité RGAA AA, WCAG 2.2, Opquast et RGPD.

Sources : https://www.jsonrpc.org/specification https://modelcontextprotocol.io/specification/2025-11-25/basic/transports https://modelcontextprotocol.io/specification/2025-11-25/server/tools https://accessibilite.numerique.gouv.fr/ https://www.w3.org/WAI/news/2023-10-05/wcag22rec/ https://checklists.opquast.com/fr/qualite-numerique/ https://eur-lex.europa.eu/eli/reg/2016/679/oj/fra