AI Catalog

Waarom het belangrijk is

Een AI Catalog geeft agents een machineleesbare lijst van de AI-resources van een site: MCP-servers, API's, skills en docs. Agents vinden het via links, dus link het vanaf de homepage.

Zo los je het op

Publiceer een geldige AI Catalog en vermeld deze in de homepage-head en HTTP Link-header.

1. Maak /.well-known/ai-catalog.json met specVersion en entries. Geef elke entry een identifier, een mediatype en precies één same-origin URL of inline datawaarde.

   {
     "specVersion": "1.0",
     "entries": [
       {
         "identifier": "urn:air:example:mcp",
         "type": "application/mcp-server-card+json",
         "url": "https://example.com/mcp/server-card"
       },
       {
         "identifier": "urn:air:example:openapi",
         "type": "application/openapi+json",
         "url": "https://example.com/openapi.json"
       }
     ]
   }

2. Lever het bestand als application/json met HTTP 200.

3. Voeg een link rel="ai-catalog" toe aan de head van de homepage en een overeenkomstige HTTP Link-header die naar dezelfde catalogus verwijst.

   <link rel="ai-catalog" href="/.well-known/ai-catalog.json">
   
   Link: </.well-known/ai-catalog.json>; rel="ai-catalog"

Controleren

Start een nieuwe scan voor dit checkpoint: