Für Agenten geeignete Inhalte
Eine Dokumentationswebsite, die ausschließlich für Menschen erstellt wurde, ist für alles andere eine Wand aus HTML. Ein darauf zugreifender Agent muss erraten, welche Seite relevant ist, Fließtext nach Fakten durchsuchen und hat keine Möglichkeit, auf Grundlage des Gelesenen zu handeln. Docsbook veröffentlicht dieselbe Dokumentation über vier Oberflächen, die eine Maschine direkt nutzen kann — damit ein Agent die passende Methode findet, den Dokumentbestand liest, darin navigiert und ihn verändert.
Die vier sind keine Alternativen. Sie beantworten vier verschiedene Fragen, die ein Agent nacheinander stellt: wie wird diese Aufgabe erledigt, was kann ich aufrufen, wo befindet sich das und was gibt es überhaupt.
der SKILL.md-Katalog: vier Orchestrator-Skills, die jedem Agenten beibringen, wie Dokumentationsarbeit tatsächlich erledigt wird und wie diese Skills entdeckt, versioniert und ausgeführt werden
140 typisierte Tools über das Model Context Protocol: Frage den einen docsbook_expert-Agenten und erhalte Anweisungen zurück, lies Seiten, committe sie, lies Analysen, ändere Einstellungen und starte Agentenläufe
der Dokumentgraph: Seiten, Überschriften, Links und Anker als Knoten und Kanten, die ein Agent durchlaufen kann, anstatt sie per Grep zu durchsuchen
das Authentifizierungsmodell, Token-Bereiche, was der Server speichert und die Compliance-Lücken klar und deutlich formuliert
der maschinenlesbare Index der veröffentlichten Website, für einen Agenten ohne Token und ohne Checkout
Was jede Schnittstelle bietet#
| Schnittstelle | Die Frage des Agenten | Was sie bietet | Was sie kostet |
|---|---|---|---|
| SKILL.md-Katalog | "Wie wird diese Aufgabe richtig erledigt?" | Ein Workflow mit Leitplanken, geordneten Schritten und Abnahmekriterien, abgerufen von GitHub | Nichts — der Katalog ist öffentlich und find_skill wird nie abgerechnet |
| MCP-Server | "Was kann ich für welches Projekt aufrufen?" | 140 Tools hinter einem docsbook_expert-Agenten, ein instructions-Block beim Verbindungsaufbau sowie strukturierte Fehler, die den nächsten Schritt nennen |
Pro Aufruf zulasten des Projektguthabens abgerechnet; Erkundungsaufrufe sind kostenlos |
| Dokumentgraph | "Wo befindet sich dieses Konzept, und worauf verweist es?" | Seiten und Überschriften als separate Knotennamensräume, vier Arten von Kanten, fehlerhafte Links und Ankerkollisionen | In jedem Tarif kostenlos — er wird aus deinem eigenen Markdown erstellt |
| llms.txt | "Was gibt es überhaupt auf dieser Website?" | Ein flacher, abrufbarer Index jeder veröffentlichten Seite, ohne Authentifizierung | Kostenlos und ohne Docsbook-Konto lesbar |
Wie die Oberflächen aneinander übergeben#
Die Übergaben sind das Design, kein Zufall.
- Ein Skill benennt einen Bedarf, der MCP-Server beantwortet ihn. Die Skills von Docsbook geben an, welche Belege ein Schritt erfordert („die Zahlen lesen, bevor eine Seite gelesen wird“), und lassen das Modell das Tool auswählen. Das ist Absicht: Ein Skill, der Toolnamen fest kodiert, ist in dem Moment kaputt, in dem ein Tool umbenannt wird, und der Fehler bleibt unbemerkt — der Agent wählt etwas Ähnliches aus und improvisiert eine andere Methode hinter einem identisch aussehenden Bericht.
- Der MCP-Server teilt deinem Agenten mit, wie der Skill ausgeführt wird. Vier Tools wurden verwendet, um einen Skill auf den Rechnern von Docsbook auszuführen und eine Lauf-ID (
run_docs_*) zurückzugeben; sie wurden am 12.09.2026 entfernt.docsbook_expertantwortet stattdessen mit der Methode, den Schritten und dem jeweiligen Tool, und dein eigener Agent — der das Repository bereits besitzt — führt sie aus. - Der Graph ist das, was die Inhaltstools lesen.
search_docs,read_docundget_doc_outlinedurchsuchen keine Dateien per grep; sie fragen einenRichDocGraphab, der aus dem Markdown deines Repositorys erstellt und serverseitig zwischengespeichert wird. - llms.txt ist der Fallback für einen Agenten, der keines von beiden hat. Kein Token, kein Checkout, kein MCP-Client — nur ein HTTP-GET über die veröffentlichte Website.
Warum dies der richtige Weg ist (Belege)#
| Regel | Warum sie auf der Maschine funktioniert, die sie verarbeitet | Quelle |
|---|---|---|
| Veröffentlichen Sie die Methode als Datei, die der Agent bei Bedarf lädt, nicht als Fließtext in einer Systemaufforderung | Das Agent-Skills-Design von Anthropic lädt einen Skill stufenweise — „bis ein Skill ausgelöst wird, belegen nur sein Name und seine Beschreibung Kontext“ | Übersicht über Agent Skills |
| Halten Sie die Tool-Oberfläche typisiert und benannt, nicht als einzelnen Endpunkt „Dokumentation erledigen“ | MCP-Tools sind „so konzipiert, dass sie modellgesteuert sind“, und werden vom Modell aus tools/list entdeckt und aufgerufen |
MCP-Spezifikation 2026-07-28, Tools |
| Laden Sie nicht alles auf einmal in das Kontextfenster | „Kontext muss daher als endliche Ressource mit abnehmendem Grenznutzen behandelt werden“ | Effektives Kontext-Engineering |
| Geben Sie einem Modell für einen großen Katalog eine durchsuchbare Struktur statt einer flachen Liste | Anthropic misst, dass „Claudes Fähigkeit, das richtige Tool auszuwählen, nachlässt, sobald Sie mehr als 30–50 verfügbare Tools überschreiten“ | Tool-Suchwerkzeug |
| Geben Sie der Suche einen Graphen statt einer Ansammlung von Seiten | Die Suche in langen Kontexten nimmt in der Mitte ab: Die Leistung „nimmt deutlich ab, wenn Modelle relevante Informationen in der Mitte langer Kontexte abrufen müssen“ (Liu et al., TACL 2024) | In der Mitte verloren |
Zwei davon verdienen ihre gemessene Form statt eines Slogans. Die Suche über eine große Tool-Registry wurde unabhängig benchmarkgetestet: RAG-MCP (arXiv-Preprint 2505.03275, Gan und Sun, Mai 2025) berichtet eine Genauigkeit bei der Tool-Auswahl von „43,13 % gegenüber 13,62 % als Baseline“, wenn Tools abgerufen werden, statt sie alle aufzulisten, wodurch die Prompt-Token „um über 50 %“ reduziert werden. Ein Preprint aus dem Jahr 2026, der Registries „mit 20 bis 3.251 Tools“ benchmarktestet, berichtet für die adaptive Vorauswahl eine Auswahlgenauigkeit von 93,1 % gegenüber 87,1 % bei einer festen Vorauswahl von fünf Tools (arXiv 2605.24660). Beide sind nicht begutachtete Preprints; betrachten Sie die Richtung als gut belegt und die genauen Zahlen als Messung eines einzelnen Teams.
Grenzen und offene Fragen#
- Die vier Oberflächen kosten nicht alle gleich viel. Der Skills-Katalog, der Graph und llms.txt sind in jedem Tarif kostenlos. MCP-Tool-Aufrufe werden pro Aufruf vom Guthaben des Projekts abgerechnet, und der leserorientierte KI-Chat, der das Modellbudget von Docsbook verbraucht, beginnt ab Pro. Die aktuellen Beträge finden Sie auf der Preisseite; in dieser Dokumentation werden bewusst keine Beträge genannt, da ein in eine Seite kopierter Preis unbemerkt veraltet.
- „Agent-ready“ ist eine Aussage über die Form, keine Rangordnung. Docsbook kann Ihnen zeigen, dass eine Seite abrufbar ist, dass ihre Abschnitte für sich stehen und dass ihre Anker aufgelöst werden. Ob ein bestimmter Assistent sie anschließend zitiert, misst dieses Produkt nicht für Sie, und keine öffentliche Quelle legt eine allgemeine Rate fest. Informationen darüber, was messbar ist, finden Sie unter GEO.
- Die Anzahl der Tools verändert sich. 140 ist die Anzahl der Toolnamen, die dieser Build registriert. Maßgeblich ist die Anzahl, die
tools/listfür Ihr Token zurückgibt; der MCP-Bereich Ihres Administrationspanels liest diesen Wert live und nicht aus einer schriftlich festgehaltenen Kopie. - Die MCP-Spezifikation hat sich unterdessen weiterentwickelt. Revision
2026-07-28machte MCP zustandslos und entfernte deninitialize-Handshake vollständig — „Es gibt keinen Aushandlungs-Handshake“ (Versionierung und Kompatibilität). Der Server von Docsbook wird über einen zustandslosen HTTP-Transport bereitgestellt, spricht aber weiterhin die initialisierungsbasierten Revisionen, die sein SDK unterstützt — aktuell2025-11-25— und enthält seinen Orientierungstext ininitialize, was eine Platzierung vor2026-07-28darstellt. Ein Client, der ausschließlich2026-07-28spricht, wird keine Verbindung herstellen. Die übrige Liste der Lücken finden Sie unter Sicherheit des MCP-Servers. - Keine der hier genannten Oberflächen ersetzt korrekte Dokumentation. Ein Agent, der einen Korpus perfekt durchsuchen kann, gibt weiterhin das wieder, was im Korpus steht.
Verwandt#
- GEO — von einem Assistenten zitiert werden, der sich mit nichts verbindet
- llms.txt — die vierte Oberfläche, dokumentiert zusammen mit der SEO- und GEO-Familie
- MCP-Tools-Referenz — jedes Tool mit seinen Parametern und seiner Abrechnungsklasse
- Webhooks — die Push-Hälfte: benachrichtigt werden, wenn etwas passiert ist, anstatt danach zu fragen
- KI-Chat — der Assistent, mit dem Ihre Leser sprechen und der denselben Graphen liest