---
title: "agents.json erklärt: ein eigenes Manifest für Website-Tools"
description: "Was ein eigenes agents.json-Manifest leisten kann, welche Integration es braucht und wie es sich von WebMCP und A2A unterscheidet. Mit Restaurant-Beispiel."
author: "Matthias Meyer"
published: 2026-02-15
updated: 2026-09-30
updates:
  - date: 2026-09-30
    note: "agents.json als eigenes Manifest eingeordnet; ChatGPT-, WebMCP- und A2A-Grenzen sowie Rechte korrigiert."
language: de
tags: ["agents-json", "webmcp", "api", "ki-agenten", "discovery", "robots-txt"]
canonical: "https://studiomeyer.io/de/blog/agents-json-explained"
markdown_versions: ["https://studiomeyer.io/de/blog/agents-json-explained.md", "https://studiomeyer.io/en/blog/agents-json-explained.md", "https://studiomeyer.io/es/blog/agents-json-explained.md"]
publisher: "StudioMeyer, https://studiomeyer.io (llms.txt: https://studiomeyer.io/llms.txt)"
---

# agents.json erklärt: ein eigenes Manifest für Website-Tools

Eine maschinenlesbare Beschreibung kann einem Agenten sagen, welche Schnittstellen eine Website anbietet. Eine `agents.json` ist ein möglicher Weg dafür. Sie allein richtet aber keine Schnittstelle ein und bewirkt nicht, dass ChatGPT oder Claude die Website automatisch entdecken.

Unter dem Namen agents.json existieren unterschiedliche Community-Vorschläge und eigene Implementierungen. Es gibt keinen allgemeinen Standard, der das folgende Format allen Agenten verbindlich vorgibt. Dieser Artikel zeigt ein **eigenes, vereinfachtes Manifestformat**, wie es eine Website unter `/.well-known/agents.json` bereitstellen kann.

## Was die Datei beschreibt

Ein Manifest kann Name, Adresse und öffentlich dokumentierte Funktionen zusammenführen. Jede Funktion verweist auf einen tatsächlich implementierten Endpunkt. Ein fiktives Restaurant könnte so aussehen:

```json
{
  "schema_version": "1.0",
  "name": "Example Restaurant",
  "url": "https://restaurant.example",
  "tools": [
    {
      "name": "get_menu",
      "description": "Retrieve the current menu",
      "endpoint": "/api/menu",
      "method": "GET",
      "parameters": {}
    },
    {
      "name": "request_reservation",
      "description": "Submit a reservation request; confirmation is pending",
      "endpoint": "/api/reservation-requests",
      "method": "POST",
      "parameters": {
        "date": { "type": "string" },
        "guests": { "type": "integer", "minimum": 1 }
      }
    }
  ]
}
```

`schema_version` beschreibt hier die Version dieses eigenen Formats. Die Datei ist weder ein WebMCP-Manifest noch automatisch ein MCP-Server. Auch die `.example`-Adresse und Endpunkte sind Platzhalter.

Die wichtigste Information ist die Wirkung: `request_reservation` nimmt eine Anfrage entgegen. Es verspricht keine bestätigte Tischbuchung. Der Server muss fehlende Angaben, Berechtigungen und Fehler selbst behandeln.

## Wie ein Agent die Datei nutzen könnte

1. Der Agent oder seine Integration kennt die Manifestadresse.
2. Er liest die Funktionsbeschreibung und entscheidet, ob sie zur Aufgabe passt.
3. Für die Speisekarte ruft er den beschriebenen GET-Endpunkt auf.
4. Vor einer Reservierungsanfrage klärt er die Angaben und die Freigabe des Nutzers.
5. Er meldet das tatsächliche Ergebnis: angefragt, bestätigt oder abgewiesen.

Ohne eine passende Integration wird die Datei möglicherweise gar nicht ausgewertet. Eine Veröffentlichung beweist deshalb weder zusätzliche Besucher noch automatisch ausgeführte Aktionen.

## agents.json, Agent Card und WebMCP

| Beschreibung | Zweck |
|---|---|
| Eigene agents.json | HTTP-Funktionen in einem vereinbarten Format beschreiben |
| A2A Agent Card | Einen Agenten und seine ausführbaren Skills bekannt machen |
| WebMCP | JavaScript-Werkzeuge im geöffneten Browser-Dokument registrieren |

Für A2A 1.0 stehen Adresse, Binding und Protokollversion in `supportedInterfaces`. Ein gekürzter Kartenausschnitt, keine vollständige validierbare Karte:

```json
{
  "name": "Example Restaurant Agent",
  "supportedInterfaces": [
    {
      "url": "https://restaurant.example/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "skills": [
    {
      "id": "reservation-request",
      "name": "Request a reservation",
      "description": "Accepts a request; the restaurant confirms separately",
      "tags": ["restaurant", "reservation"]
    }
  ]
}
```

Die [A2A-Erklärung](https://studiomeyer.io/de/blog/a2a-protocol-explained) zeigt eine vollständige Karte und einen Ablauf. Eine Agent Card mit Reservierungs-Skill braucht einen Agenten, der tatsächlich antwortet. WebMCP verwendet dagegen die Browser-API `document.modelContext`; eine Prüfung der eigenen agents.json ist keine Prüfung auf WebMCP-Konformität.

## Bereitstellen und absichern

Stelle das Manifest als JSON unter der dokumentierten Adresse bereit. Halte Namen, Parameter und Beschreibungen mit den echten Endpunkten zusammen. Prüfe jede Funktion, bevor du sie bewirbst.

Eine öffentlich lesbare Datei braucht nicht immer `Access-Control-Allow-Origin: *`. CORS betrifft Aufrufe aus einem Browser; serverseitige Agenten haben diese Einschränkung nicht. Öffne Browserzugriffe nur im erforderlichen Umfang. Auch lesende Endpunkte dürfen eine Anmeldung verlangen, etwa wenn sie Kundendaten liefern.

Das Manifest selbst ist keine Zugangskontrolle. Anmeldung, Berechtigungen, Ratenbegrenzung und die Prüfung schreibender Aktionen gehören auf den Server. Beschreibungen und Ergebnisse können zudem manipulierte Anweisungen enthalten, die ein Agent als untrusted behandeln sollte.

## Ergänzung zur Website

`robots.txt` regelt Crawling, nicht zuverlässig die Aufnahme einer Seite in den Suchindex. Sitemaps helfen beim Finden von URLs. Ein agents.json-Manifest beschreibt mögliche Interaktionen. Diese Aufgaben ergänzen sich, sind aber kein gemeinsamer verpflichtender Standard.

Für eine reine Informationsseite kann ein Manifest wenig Mehrwert bringen. Für eine Anwendung mit nützlichen APIs lohnt es sich, einen konkreten Agentenablauf zu testen. Die Datei ist ein Einstieg in die Dokumentation, keine Garantie für KI-Traffic.

Quellen: [A2A 1.0](https://a2a-protocol.org/v1.0.0/specification/), [WebMCP](https://webmachinelearning.github.io/webmcp/), [Google zu robots.txt](https://developers.google.com/search/docs/crawling-indexing/robots/intro).

## Weiterlesen, WebMCP + Agenten-Protokolle

- [A2A Protocol erklärt: So sprechen KI-Agenten mit deiner Website](https://studiomeyer.io/de/blog/a2a-protocol-explained.md)
- [WebMCP Reality Check: Wo der Spec wirklich steht](https://studiomeyer.io/de/blog/webmcp-reality-check-may-2026.md)
- [WebMCP: Das neue Web-Protokoll für KI-Agents](https://studiomeyer.io/de/blog/webmcp-w3c-standard.md)