Publique um catálogo de APIs
Um catálogo da RFC 9727 em /.well-known/api-catalog lista suas APIs e liga cada uma à sua descrição OpenAPI. Uma requisição, e o agente sabe o que você oferece.
O SagBot lê o /.well-known/api-catalog do seu site e os links dentro dele.
Descreva seu servidor MCP
Se você opera um servidor MCP, um cartão de servidor em /.well-known/mcp/server-card.json permite que os clientes MCP o encontrem e o configurem só a partir do seu domínio, em vez de uma pessoa copiar uma URL da sua documentação.
O SagBot lê os caminhos do cartão de servidor MCP em /.well-known/ no seu site.
Publique um cartão de agente
Se o seu produto é ele mesmo um agente, um cartão A2A em /.well-known/agent-card.json diz a outros agentes o que ele faz e como se comunicar com ele.
O SagBot lê /.well-known/agent-card.json no seu site.
Torne o login descobrível
Os metadados do servidor de autorização permitem que um agente encontre seus endpoints de login e de token sem tê-los fixos no código. Sirva /.well-known/oauth-authorization-server ou /.well-known/openid-configuration.
O SagBot lê os documentos de metadados OAuth e OpenID Connect do seu site.
Diga qual servidor emite tokens para a sua API
Os metadados da RFC 9728 em /.well-known/oauth-protected-resource informam a um agente qual servidor de autorização consultar para obter um token antes de chamar a sua API. Servidores MCP que exigem login dependem disso.
O SagBot lê /.well-known/oauth-protected-resource no seu site.
Explique como os agentes obtêm credenciais
Um arquivo /auth.md diz em Markdown simples como um agente se registra, quais escopos existem e de onde vêm as chaves. Mostrado como conselho: é novo e barato de adicionar.
O SagBot lê /auth.md no seu site.
Exponha as ações do seu app como ferramentas WebMCP
O WebMCP permite que um agente rodando no navegador chame as ações do seu app como ferramentas, em vez de clicar pela interface. Registre as ferramentas com document.modelContext.registerTool() ou adicione toolname e tooldescription aos formulários principais.
O SagBot lê o HTML e os scripts do seu site em busca de ferramentas WebMCP registradas ou formulários anotados. É um conselho, não faz parte da pontuação.
Veja quais dessas seu produto cumpre
Analise como API ou app para incluir estas verificações. Cada uma reprovada vem com uma correção para colar em um agente de programação.