API, autenticação, MCP e descoberta de skills

API Catalog

Um API catalog lista suas APIs e aponta para a descrição, a documentação e o endpoint de status de cada uma, usando o formato linkset da RFC 9727.

Por que importa

É assim que um agente que nunca viu seu produto descobre que você tem uma API, sem ler seu site de marketing.

Critério de aprovação

/.well-known/api-catalog retorna application/linkset+json com pelo menos uma entrada.

O que o scanner registra
Cada requisição que a verificação faz é registrada — URL, método, status da resposta, cabeçalhos relevantes e uma prévia do corpo — e exibida sob a verificação nos seus resultados.

Como implementar

Publish an API catalog for automated API discovery (RFC 9727)

/.well-known/api-catalog retorna application/linkset+json com pelo menos uma entrada.

O passo a passo de implementação faz parte do plano Pro.

Ver planos

www.rfc-editor.org SKILL.md

Escanear seu site

Veja se esta verificação passa no seu domínio, junto com as outras 21.

Escanear site

Verificações relacionadas

Descoberta OAuth

/.well-known/oauth-authorization-server ou /.well-known/openid-configuration expõe metadados utilizáveis.

OAuth Protected Resource

/.well-known/oauth-protected-resource declara resource e authorization_servers.

Auth.md

/auth.md existe com um H1 em markdown mencionando auth.md.

MCP Server Card

/.well-known/mcp/server-card.json descreve o servidor com um serverInfo.name.

A2A Agent Card

/.well-known/agent-card.json declara name, version e as interfaces suportadas.

Agent Skills

/.well-known/agent-skills/index.json lista pelo menos uma skill.

WebMCP

O código da página registra ferramentas no lado do navegador por meio de navigator.modelContext.

Manifesto ARD

/.well-known/ai-catalog.json declara specVersion, host e pelo menos uma entrada.