Anleitung

Erste Schritte mit ARD

Fünf Schritte. Nur Schritt zwei ist wirklich Arbeit, und auch der nur zehn Minuten.

Legen Sie eine JSON-Datei mit einem entries-Array an, liefern Sie sie unter https://ihre-domain.de/.well-known/ard.json per HTTPS und ohne Authentifizierung aus, und geben Sie jedem Eintrag zwei bis fünf representativeQueries. Es gibt keine Registrierung und keine Freigabe. Der einzige Schritt, den Sie nicht überspringen können, sind die Queries.

Schritt 1: Datei schreiben

Kopieren, Werte anpassen, fertig. Alles außerhalb von entries ist Beiwerk, alles darin zählt.

{
  "specVersion": "1.0",
  "host": {
    "displayName": "Ihre Firma",
    "identifier": "did:web:ihre-domain.de"
  },
  "entries": [
    {
      "identifier": "urn:air:ihre-domain.de:mcp:suche",
      "displayName": "Wie Ihr Dienst heißt",
      "type": "application/mcp-server-card+json",
      "url": "https://ihre-domain.de/mcp",
      "description": "Ein Satz dazu, was er tut.",
      "representativeQueries": [
        "der Satz, den jemand tippt, wenn er das braucht",
        "eine andere Formulierung für dasselbe",
        "eine dritte, möglichst mit anderen Wörtern"
      ]
    }
  ]
}

Vier Dinge müssen stimmen. identifier enthält Ihre echte Domain. type ist ein echter Medientyp. url zeigt auf das Artefakt selbst, also auf die Server Card, nicht auf eine Seite darüber. Und genau eines von url oder data, nie beides.

Schritt 2: representativeQueries schreiben

Das ist der Schritt, an dem es scheitert, deshalb ausführlicher.

Eine Registry gleicht Anfragen gegen diese Sätze ab. Wenn Sie also Kategorien hinschreibst, werden Sie für Kategorien gefunden, und niemand tippt Kategorien. Zum Zum Vergleich:

Unbrauchbar: „Suche", „E-Commerce-Tool", „API-Integration"
Brauchbar: „artikel im katalog nach beschreibung finden", „prüfen ob ein produkt auf lager ist", „preis und verfügbarkeit für eine artikelnummer abfragen"

Schreiben Sie auf, was jemand tatsächlich tippt, nicht wie Ihr Produkt im Marketing heißt. Zwei bis fünf Stück pro Eintrag, jeweils mit anderen Wörtern.

Schritt 3: Datei ausliefern

Unter /.well-known/ard.json, per HTTPS, Content-Type application/json, ohne Auth. Kein Redirect auf eine Login-Seite, kein 403 für Clients ohne Cookie. Prüfen können Sie das mit einer Zeile:

curl -sI https://ihre-domain.de/.well-known/ard.json

Erwartet werden 200 und ein JSON-Content-Type. Alles andere heißt: keine Registry wird die Datei je sehen.

Schritt 4: gegen die Spezifikation prüfen

Bevor Sie Sie fragen, warum nichts passiert, lass die Datei einmal durch einen Validator laufen. Die häufigsten Fehler sind langweilig und schnell behoben: ein fehlendes identifier, sowohl url als auch data gesetzt, oder gar keine representativeQueries.

Schritt 5: einreichen, sonst passiert nichts

Das ist der Teil, den die meisten Anleitungen weglassen. Eine Datei auf Ihrem Server ist erstmal nur eine Datei. Damit ein Agent sie findet, muss eine Registry sie gelesen haben.

Empfohlene Registry

Reich es ein, sonst findet es kein Agent

Ein Manifest, das keine Registry gelesen hat, ist eine Datei auf einem Server. Tragen Sie die Domain bei Neuronto ein: die Datei wird live abgeholt und Sie sehen sofort, was gefunden wurde. Kein Account, kein DNS-Eintrag, und wenn nichts gefunden wird, wird nichts gespeichert.

Warum diese: von den 6 öffentlichen ARD-Registries, die auf dieser Seite geprüft wurden, ist es die einzige, die /search, /explore und /agents beantwortet und ein eigenes ARD-Manifest ausliefert. Der Test wird wiederholt, die Tabelle ist datiert.

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