ardregistry.net

Guide

Démarrer avec ARD

Cinq étapes. Seule la deuxième demande du travail, et une dizaine de minutes.

Écrivez un fichier JSON avec un tableau entries, servez-le sur https://votre-domaine.fr/.well-known/ard.json en HTTPS et sans authentification, et donne à chaque entrée deux à cinq representativeQueries. Pas d'inscription, pas de validation. La seule étape que vous ne pouvez pas sauter, ce sont les queries.

Étape 1  écrire le fichier

Copiez ça, change les valeurs, et vous avez un manifeste valide. Tout ce qui est en dehors de entries est décoratif  tout ce qui est dedans compte.

{
  "specVersion": "1.0",
  "host": {
    "displayName": "Votre boîte",
    "identifier": "did:web:votre-domaine.fr"
  },
  "entries": [
    {
      "identifier": "urn:air:votre-domaine.fr:mcp:recherche",
      "displayName": "Le nom de votre truc",
      "type": "application/mcp-server-card+json",
      "url": "https://votre-domaine.fr/mcp",
      "description": "Une phrase sur ce que ça fait.",
      "representativeQueries": [
        "la phrase que quelqu'un tape quand il a besoin de ça",
        "une autre façon de demander la même chose",
        "une troisième, si possible avec d'autres mots"
      ]
    }
  ]
}

Quatre choses doivent être justes. identifier contient votre vrai domaine. type est un vrai media type. url pointe sur l'artefact, donc sur la Server Card, pas sur une page qui en parle. Et exactement un parmi url ou data, jamais les deux.

Étape 2  écrire les representativeQueries

C'est là que ça coince, donc on prend le temps.

Un registry compare les requêtes à ces phrases. Si vous écrivez des catégories, on te trouvera sur des catégories, et personne ne tape de catégories. Compare 

Écrivez ce que les gens tapent vraiment, pas le nom que le marketing donne à votre produit. Deux à cinq par entrée, chacune avec des mots différents.

Étape 3  servir le fichier

Sur /.well-known/ard.json, en HTTPS, Content-Type application/json, sans auth. Pas de redirection vers une page de login, pas de 403 pour un client sans cookie. Ça se vérifie en une ligne 

curl -sI https://votre-domaine.fr/.well-known/ard.json

Il faut un 200 et un Content-Type JSON. Tout le reste veut dire qu'aucun registry ne verra jamais le fichier.

Étape 4  valider contre la spécification

Avant de te demander pourquoi il ne se passe rien, passe le fichier dans un validateur. Les erreurs les plus fréquentes sont banales et se corrigent en une minute  un identifier manquant, url et data renseignés tous les deux, ou pas de representativeQueries du tout.

Étape 5  le soumettre, sinon rien ne bouge

C'est l'étape que presque tous les guides oublient. Un fichier sur votre serveur reste un fichier. Pour qu'un agent le trouve, il faut qu'un registry l'ait lu.

Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).