Agents IA et API

Grilla peut être utilisé par un agent IA (Claude, ChatGPT, Cursor, VS Code ou tout client compatible MCP, le Model Context Protocol). L'agent cherche dans la documentation, explique un critère du RGAA, et, si vous l'y autorisez, lance des analyses et lit vos rapports.

Deux serveurs MCP

Serveur	Adresse	Connexion	Outils
Public	https://grilla.fr/api/mcp	Aucune	Rechercher et lire la documentation, détail d'un critère RGAA avec sa méthodologie officielle, offres
Votre compte	https://grilla.fr/api/mcp/compte	Votre compte Grilla (OAuth)	Les outils publics, plus : analyser une page, lister vos rapports, lire un rapport

Les deux utilisent le transport Streamable HTTP. Ajoutez l'adresse comme « connecteur personnalisé » ou « serveur MCP distant » dans votre client. Par exemple, avec Claude Code :

claude mcp add --transport http grilla https://grilla.fr/api/mcp/compte

Connecter votre compte

À la première utilisation du serveur de votre compte, votre client ouvre une page Grilla :

1. Connectez-vous à Grilla, si ce n'est pas déjà fait.
2. Grilla affiche le nom de l'agent et ce qu'il demande :
   • Lire les rapports d'analyse de votre organisation ;
   • Lancer des analyses de pages, qui consomment vos crédits (1 crédit par page) ;
   • garder l'accès jusqu'à 14 jours sans vous redemander.
3. Cliquez sur Autoriser, ou Refuser.

L'accès vaut pour l'organisation dans laquelle vous travaillez au moment d'autoriser. Si vous quittez cette organisation, l'agent perd l'accès. Les analyses lancées par un agent suivent les mêmes règles qu'à la main : un abonnement est nécessaire, et seules les pages publiques peuvent être analysées.

N'autorisez un agent que si vous avez vous-même lancé la connexion. Une page Grilla qui vous demande d'autoriser un agent inconnu doit être refusée.

Retirer l'accès

Page Équipe, section Agents IA autorisés : le bouton Retirer l'accès supprime l'autorisation de l'agent. Il devra vous la redemander. Un accès déjà délivré expire au plus tard 15 minutes après.

Dans le navigateur (WebMCP)

Les navigateurs qui proposent WebMCP (document.modelContext) donnent à leur assistant des outils sur les pages de Grilla : rechercher dans la documentation, détail d'un critère, offres, ouvrir l'exemple de rapport, préremplir le formulaire d'analyse. L'assistant ne lance jamais d'analyse lui-même : vous gardez le dernier clic.

API publique

Une API REST en lecture seule, sans authentification, décrite en OpenAPI : openapi.json.

Requête	Réponse
GET /api/docs/recherche?q=déclaration	Pages de documentation pertinentes, avec un extrait
GET /docs/scan-de-page.md	Une page de documentation en Markdown
GET /api/criteres/1.1	Un critère du RGAA 4.1.2, ses tests et la méthodologie de la DINUM
GET /api/offres	Les offres et leurs crédits
GET /api/sante	L'état du service

Fichiers de découverte

Pour que les agents trouvent tout cela seuls, Grilla publie :

• /.well-known/api-catalog : le catalogue des API (RFC 9727) ;
• /.well-known/ai-catalog.json : le catalogue des ressources pour agents (serveurs MCP, skill, API) ;
• /.well-known/mcp/server-card.json : la fiche du serveur MCP public ;
• /.well-known/agent-skills/index.json : une skill « auditer une page selon le RGAA avec Grilla » ;
• /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server : la configuration OAuth 2.1 ;
• /auth.md : comment un agent obtient l'accès à un compte (en anglais) ;
• /llms.txt : le sommaire du site pour les modèles de langage.