Publica un catálogo de API
Un catálogo RFC 9727 en /.well-known/api-catalog enumera tus API y enlaza cada una con su descripción OpenAPI. Una solicitud, y el agente sabe qué ofreces.
SagBot lee /.well-known/api-catalog en tu sitio y los enlaces que contiene.
Describe tu servidor MCP
Si tienes un servidor MCP, una tarjeta de servidor en /.well-known/mcp/server-card.json permite que los clientes MCP lo encuentren y lo configuren solo a partir de tu dominio, en lugar de que un usuario copie una URL de tu documentación.
SagBot lee las rutas de la tarjeta de servidor MCP bajo /.well-known/ en tu sitio.
Publica una tarjeta de agente
Si tu producto es en sí un agente, una tarjeta A2A en /.well-known/agent-card.json cuenta a otros agentes qué hace y cómo comunicarse con él.
SagBot lee /.well-known/agent-card.json en tu sitio.
Haz que el inicio de sesión sea descubrible
Los metadatos del servidor de autorización permiten que un agente encuentre tus endpoints de inicio de sesión y de tokens sin fijarlos en el código. Sirve /.well-known/oauth-authorization-server o /.well-known/openid-configuration.
SagBot lee los documentos de metadatos OAuth y OpenID Connect de tu sitio.
Indica qué servidor emite los tokens de tu API
Los metadatos RFC 9728 en /.well-known/oauth-protected-resource indican a un agente a qué servidor de autorización pedir un token antes de llamar a tu API. Los servidores MCP que exigen inicio de sesión dependen de ellos.
SagBot lee /.well-known/oauth-protected-resource en tu sitio.
Explica cómo obtienen credenciales los agentes
Un archivo /auth.md explica en Markdown sencillo cómo se registra un agente, qué scopes existen y de dónde salen las claves. Se muestra como consejo: es nuevo y barato de añadir.
SagBot lee /auth.md en tu sitio.
Expón las acciones de tu app como herramientas WebMCP
WebMCP permite que un agente que se ejecuta en el navegador llame a las acciones de tu app como herramientas, en lugar de ir haciendo clic por la interfaz. Registra herramientas con document.modelContext.registerTool(), o añade toolname y tooldescription a los formularios clave.
SagBot lee el HTML y los scripts de tu sitio en busca de herramientas WebMCP registradas o formularios anotados. Es un consejo, no forma parte de la puntuación.
Descubre cuáles de estas supera tu producto
Analiza como API o app para incluir estas verificaciones. Cada una fallida incluye una corrección para pegar en un agente de programación.