Publiez un catalogue d’API
Un catalogue RFC 9727 à /.well-known/api-catalog liste vos API et relie chacune à sa description OpenAPI. Une requête, et un agent sait ce que vous proposez.
SagBot lit /.well-known/api-catalog sur votre site et les liens qu’il contient.
Décrivez votre serveur MCP
Si vous exploitez un serveur MCP, une server card à /.well-known/mcp/server-card.json permet aux clients MCP de le trouver et de le configurer à partir de votre seul domaine, sans qu’un utilisateur recopie une URL depuis votre documentation.
SagBot lit les chemins de server card MCP sous /.well-known/ sur votre site.
Publiez une agent card
Si votre produit est lui-même un agent, une card A2A à /.well-known/agent-card.json indique aux autres agents ce qu’il fait et comment lui parler.
SagBot lit /.well-known/agent-card.json sur votre site.
Rendez la connexion découvrable
Les métadonnées du serveur d’autorisation permettent à un agent de trouver vos points d’accès de connexion et de jeton sans les coder en dur. Servez /.well-known/oauth-authorization-server ou /.well-known/openid-configuration.
SagBot lit les documents de métadonnées OAuth et OpenID Connect de votre site.
Indiquez quel serveur émet les jetons pour votre API
Les métadonnées RFC 9728 à /.well-known/oauth-protected-resource indiquent à un agent quel serveur d’autorisation solliciter pour obtenir un jeton avant d’appeler votre API. Les serveurs MCP qui exigent une connexion en dépendent.
SagBot lit /.well-known/oauth-protected-resource sur votre site.
Expliquez comment les agents obtiennent des identifiants
Un fichier /auth.md explique en Markdown simple comment un agent s’inscrit, quels scopes existent et d’où viennent les clés. Affiché comme conseil : c’est récent, et peu coûteux à ajouter.
SagBot lit /auth.md sur votre site.
Exposez les actions de votre app comme outils WebMCP
WebMCP permet à un agent exécuté dans le navigateur d’appeler les actions de votre app comme des outils, au lieu de cliquer dans l’interface. Enregistrez des outils avec document.modelContext.registerTool(), ou ajoutez toolname et tooldescription aux formulaires clés.
SagBot lit le HTML et les scripts de votre site à la recherche d’outils WebMCP enregistrés ou de formulaires annotés. C’est un conseil, hors score.
Voyez lesquels votre produit réussit
Analysez en choisissant « API ou app » pour inclure ces contrôles. Chaque contrôle en échec est accompagné d’un correctif à coller dans un agent de code.