Fai scoprire il tuo prodotto agli agenti AI e lasciali collegare

Gli agenti non sfogliano la tua documentazione per trovare la tua API. Guardano in pochi percorsi noti del tuo dominio. Questi controlli mostrano se un agente che conosce solo il tuo dominio riesce a trovare la tua API, il tuo server MCP e il modo per autenticarsi.

Tipo di sito

Pubblica un catalogo API

Un catalogo RFC 9727 in /.well-known/api-catalog elenca le tue API e collega ciascuna alla sua descrizione OpenAPI. Una sola richiesta, e un agente sa cosa offri.

SagBot legge /.well-known/api-catalog sul tuo sito e i link che contiene.

Descrivi il tuo server MCP

Se gestisci un server MCP, una server card in /.well-known/mcp/server-card.json permette ai client MCP di trovarlo e configurarlo partendo solo dal tuo dominio, invece di far copiare a un utente un URL dalla tua documentazione.

SagBot legge i percorsi della server card MCP sotto /.well-known/ sul tuo sito.

Pubblica una agent card

Se il tuo prodotto è esso stesso un agente, una card A2A in /.well-known/agent-card.json dice agli altri agenti cosa fa e come comunicarci.

SagBot legge /.well-known/agent-card.json sul tuo sito.

Rendi l’accesso individuabile

I metadati dell’authorization server permettono a un agente di trovare i tuoi endpoint di accesso e dei token senza scriverli a mano nel codice. Servi /.well-known/oauth-authorization-server oppure /.well-known/openid-configuration.

SagBot legge i documenti di metadati OAuth e OpenID Connect sul tuo sito.

Indica quale server emette i token per la tua API

I metadati RFC 9728 in /.well-known/oauth-protected-resource dicono a un agente a quale authorization server chiedere un token prima di chiamare la tua API. I server MCP che richiedono l’accesso si basano su questi.

SagBot legge /.well-known/oauth-protected-resource sul tuo sito.

Spiega come gli agenti ottengono le credenziali

Un file /auth.md spiega in semplice Markdown come si registra un agente, quali scope esistono e da dove arrivano le chiavi. Mostrato come consiglio: è una novità, e costa poco aggiungerlo.

SagBot legge /auth.md sul tuo sito.

Esponi le azioni della tua app come tool WebMCP

WebMCP permette a un agente che gira nel browser di chiamare le azioni della tua app come tool invece di cliccare nell’interfaccia. Registra i tool con document.modelContext.registerTool(), oppure aggiungi toolname e tooldescription ai form principali.

SagBot legge l’HTML e gli script del tuo sito, alla ricerca di tool WebMCP registrati o form annotati. È un consiglio, non fa parte del punteggio.

Scopri quali di questi controlli supera il tuo prodotto

Scansiona come API o app per includere questi controlli. Ogni controllo non superato include una correzione da incollare in un agente di coding.

Tipo di sito

Anche per il tuo team