Agent-fähige Inhalte
Eine ausschließlich für Menschen erstellte Dokumentationswebsite 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 Methode finden, den Korpus lesen, seine Struktur navigieren und ihn ändern kann.
Die vier sind keine Alternativen. Sie beantworten vier verschiedene Fragen, die ein Agent der Reihe nach 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 vermitteln, wie Dokumentationsarbeit tatsächlich erledigt wird und wie sie entdeckt, versioniert und ausgeführt werden
310 typisierte Tools über das Model Context Protocol: Seiten lesen, Änderungen committen, Analysen lesen, Einstellungen ändern und Agentenläufe starten
der Dokumentgraph: Seiten, Überschriften, Links und Anker als Knoten und Kanten, die ein Agent durchlaufen kann, anstatt sie mit grep zu durchsuchen
das Authentifizierungsmodell, Token-Bereiche, was der Server speichert und welche Compliance-Lücken bestehen – klar und direkt formuliert
der maschinenlesbare Index der veröffentlichten Website, für einen Agenten ohne Token und ohne Checkout
Was jede Oberfläche bietet#
| Oberfläche | Die Frage des Agenten | Was sie bietet | Was sie kostet |
|---|---|---|---|
| SKILL.md-Katalog | „Wie wird diese Aufgabe ordnungsgemäß erledigt?“ | Ein Workflow mit Leitplanken, geordneten Schritten und Akzeptanzkriterien, abgerufen von GitHub | Nichts — der Katalog ist öffentlich und find_skill wird nie abgerechnet |
| MCP-Server | „Was kann ich für welches Projekt aufrufen?“ | 310 Tools, ein instructions-Block beim Verbindungsaufbau, strukturierte Fehler, die den nächsten Schritt nennen |
Pro Aufruf über das Guthaben des Projekts abgerechnet; Discovery-Aufrufe sind kostenlos |
| Dokumentgraph | „Wo befindet sich dieses Konzept, und was verweist darauf?“ | 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 ineinandergreifen#
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 Werkzeug auswählen. Das ist beabsichtigt: Ein Skill, der Werkzeugnamen fest einprogrammiert, funktioniert in dem Moment nicht mehr, in dem ein Werkzeug umbenannt wird, und der Fehler bleibt unbemerkt — der Agent wählt etwas Ähnliches aus und improvisiert eine andere Methode hinter einem Bericht, der identisch aussieht.
- Der MCP-Server kann den Skill für Sie ausführen.
run_docs_analyze,run_docs_create,run_docs_manageundrun_docs_automateführen einen der vier Orchestrator-Skills auf den Rechnern von Docsbook für Ihren Arbeitsbereich aus und geben statt eines Ergebnisses eine Lauf-ID zurück. - Der Graph ist das, was die Inhaltswerkzeuge lesen.
search_docs,read_docundget_doc_outlinedurchsuchen keine Dateien mit grep; sie fragen einenRichDocGraphab, der aus dem Markdown Ihres Repositorys erstellt und serverseitig zwischengespeichert wird. - llms.txt ist der Fallback für einen Agenten, der keines von beidem 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 dies auf der Maschine funktioniert, die es verarbeitet | Quelle |
|---|---|---|
| Veröffentlichen Sie die Methode als Datei, die der Agent bei Bedarf lädt, nicht als Prosa in einem System-Prompt | 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 zu Agent Skills |
| Halten Sie die Tool-Oberfläche typisiert und benannt, statt einen einzigen Endpunkt „Dokumentation ausführen“ bereitzustellen | MCP-Tools sind „dafür konzipiert, modellgesteuert zu sein“, 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 eine große Katalogstruktur eine durchsuchbare Struktur statt einer flachen Liste | Anthropic misst, dass „Claudes Fähigkeit, das richtige Tool auszuwählen, abnimmt, sobald mehr als 30–50 verfügbare Tools vorhanden sind“ | Tool-Suchfunktion |
| Geben Sie der Suche einen Graphen statt einer Ansammlung von Seiten | Der Abruf in langen Kontexten verschlechtert sich in der Mitte: Die Leistung „verschlechtert sich deutlich, 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 Schlagworts. Der Abruf ü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 % im Baseline-Szenario“, wenn Tools abgerufen werden, anstatt alle aufzulisten, und reduziert die Prompt-Token „um über 50 %“. Ein Preprint aus dem Jahr 2026, der Registries „mit 20 bis 3.251 Tools“ benchmarktestet, berichtet bei der adaptiven Vorauswahl eine Auswahlgenauigkeit von 93,1 % gegenüber 87,1 % für eine feste 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 gegen das Guthaben des Projekts abgerechnet, und die beiden Funktionen, die das Modellbudget von Docsbook beanspruchen — Agent-Ausführungen (
run_docs_*,agent_*) und der leserorientierte KI-Chat — beginnen mit 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 Formaussage, keine Ranglistenaussage. Docsbook kann Ihnen zeigen, dass eine Seite abrufbar ist, dass ihre Abschnitte eigenständig bestehen und dass ihre Anker aufgelöst werden können. Ob ein bestimmter Assistent sie anschließend zitiert, misst dieses Produkt nicht für Sie, und keine öffentliche Quelle belegt eine allgemeine Rate. Informationen darüber, was messbar ist, finden Sie unter GEO.
- Die Anzahl der Tools ändert sich. 310 ist die Anzahl der Toolnamen, die dieser Build registriert. Die maßgebliche Anzahl ist das, was
tools/listfür Ihr Token zurückgibt; der MCP-Bereich Ihres Admin-Panels liest diesen Wert live aus, statt eine niedergeschriebene Kopie zu verwenden. - Die MCP-Spezifikation hat sich 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 führt 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 beschriebenen Oberflächen ist ein Ersatz dafür, dass die Dokumentation korrekt ist. Ein Agent, der einen Korpus perfekt navigieren kann, gibt weiterhin das wieder, was im Korpus steht.
Verwandte Inhalte#
- GEO — von einem Assistenten zitiert werden, der niemals eine Verbindung zu irgendetwas herstellt
- llms.txt — die vierte Oberfläche, dokumentiert zusammen mit der SEO- und GEO-Familie
- Referenz der MCP-Tools — jedes Tool mit seinen Parametern und seiner Abrechnungsklasse
- Webhooks — die Push-Hälfte: benachrichtigt werden, wenn etwas passiert ist, statt danach zu fragen
- KI-Chat — der Assistent, mit dem Ihre Leser sprechen und der denselben Graphen liest