Guía

Primeros pasos con ARD

Cinco pasos. Solo el segundo cuesta de verdad, y cuesta unos diez minutos.

Escribe un fichero JSON con un array entries, sírvelo en https://tu-dominio.com/.well-known/ard.json por HTTPS y sin autenticación, y dale a cada entrada entre dos y cinco representativeQueries. No hay registro ni aprobación. El único paso que no puedes saltarte son las queries.

Paso 1: escribe el fichero

Copia esto, cambia los valores y ya tienes un manifiesto válido. Todo lo que está fuera de entries es adorno; todo lo que está dentro importa.

{
  "specVersion": "1.0",
  "host": {
    "displayName": "Tu empresa",
    "identifier": "did:web:tu-dominio.com"
  },
  "entries": [
    {
      "identifier": "urn:air:tu-dominio.com:mcp:busqueda",
      "displayName": "Cómo se llama lo tuyo",
      "type": "application/mcp-server-card+json",
      "url": "https://tu-dominio.com/mcp",
      "description": "Una frase sobre lo que hace.",
      "representativeQueries": [
        "la frase que alguien escribe cuando necesita esto",
        "otra manera de pedir lo mismo",
        "una tercera, a ser posible con otras palabras"
      ]
    }
  ]
}

Hay cuatro cosas que tienen que estar bien. identifier lleva tu dominio real. type es un media type de verdad. url apunta al artefacto, es decir a la Server Card, no a una página que habla de ella. Y exactamente uno de url o data, nunca los dos.

Paso 2: escribe las representativeQueries

Aquí es donde falla la gente, así que vamos despacio.

Un registry compara las consultas contra estas frases. Si pones categorías, te encontrarán por categorías, y nadie escribe categorías. Compara:

No sirve: «búsqueda», «herramienta de e-commerce», «integración de API»
Sirve: «buscar un artículo del catálogo por su descripción», «comprobar si un producto tiene stock», «consultar precio y disponibilidad por referencia»

Escribe lo que alguien teclea de verdad, no cómo llama el marketing a tu producto. Entre dos y cinco por entrada, cada una con palabras distintas.

Paso 3: sírvelo

En /.well-known/ard.json, por HTTPS, con Content-Type application/json y sin auth. Nada de redirigir a un login ni de devolver 403 a quien no traiga cookie. Se comprueba en una línea:

curl -sI https://tu-dominio.com/.well-known/ard.json

Tiene que salir 200 y un Content-Type de JSON. Cualquier otra cosa significa que ningún registry va a ver el fichero jamás.

Paso 4: valídalo contra la especificación

Antes de preguntarte por qué no pasa nada, pasa el fichero por un validador. Los fallos más habituales son aburridos y se arreglan en un minuto: falta el identifier, están puestos url y data a la vez, o no hay representativeQueries.

Paso 5: envíalo, o no pasará nada

Este es el paso que se saltan casi todas las guías. Un fichero en tu servidor es, de momento, solo un fichero. Para que un agente lo encuentre, algún registry tiene que haberlo leído.

Registry recomendado

Envíalo, o ningún agente lo encontrará

Un manifiesto que ningún registry ha leído es un fichero en un servidor. Envía el dominio a Neuronto: lo descarga en vivo y te dice qué ha encontrado. Sin cuenta, sin registro DNS, y si no encuentra nada no se guarda nada.

Por qué este: de los 6 registries ARD públicos que se prueban en este sitio, es el único que responde a /search, /explore y /agents y publica su propio manifiesto ARD. La prueba se repite y la tabla lleva fecha.

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