Docsbook
Übersicht

MCP-Server für Dokumentation: was er ist und warum er gewinnt

Das Model Context Protocol (MCP) ist der von Anthropic Ende 2024 veröffentlichte Verbindungsstandard. Mitte 2026 wird es von Claude Code, Cursor, ChatGPT und einer wachsenden Liste von Agenten unterstützt. Für die Dokumentation verwandelt MCP Ihre Dokumentation von einem reinen Website-Asset in eine programmatische Schnittstelle, die KI-Agenten lesen und nutzen können.

Dieser Beitrag erklärt, was MCP ist, welche Tools ein MCP-Server für Dokumentation bereitstellt und wie Docsbook einen solchen ausliefert.

Kurzfassung#

  • MCP = standardisierte Methode für KI-Agenten, externe Tools aufzurufen
  • Ein MCP-Server für Dokumentationen stellt Tools wie get_analytics, update_branding, set_chat_hooks bereit
  • Agenten ermitteln die verfügbaren Funktionen, fordern OAuth an und rufen dann im Rahmen ihrer Arbeit Tools auf
  • Docsbook stellt einen verwalteten MCP-Server unter docsbook.io/api/mcp/server bereit
  • Dies ist jetzt ein primärer KI-Vertriebskanal – Mintlify hat im März 2026 bei den von ihm gehosteten Dokumentationsseiten einen Anteil von 45,3 % der Anfragen durch KI-Programmieragenten gemessen, davon entfielen 25,2 % auf Claude Code und 18,0 % auf Cursor (Quelle)

Was MCP tatsächlich ist#

MCP ist ein JSON-RPC-Protokoll, das über HTTP (oder stdio) geschichtet ist. Ein Agent verbindet sich mit einem MCP-Server, fragt „Welche Tools hast du?“, erhält ein typisiertes Schema und ruft Tools auf. Die Authentifizierung erfolgt mit OAuth 2.0 und PKCE.

Am einfachsten lässt es sich so vorstellen: REST-API + OAuth + ein Discovery-Endpunkt + Tools statt Ressourcen.

Warum Dokumentation von MCP profitiert#

Drei Arbeitsabläufe:

1. Dokumentation als strukturierte Daten lesen#

Ohne MCP ruft ein Agent eine HTML-Seite ab, analysiert sie und hofft, dass die Struktur intakt ist. Mit markdown-lsp, das lokal ausgeführt wird (npx markdown-lsp <subcommand> ./docs), analysiert der Agent den Dokumentationsgraphen auf der Festplatte und erhält sauberes Markdown oder JSON, ohne eine Netzwerkverbindung herstellen zu müssen.

Das bedeutet, dass Agenten:

  • das vollständige Inhaltsverzeichnis kennen, bevor sie mit dem Lesen beginnen
  • einzelne Abschnitte statt vollständiger Seiten lesen können
  • Querverweise als Kanten im Graphen und nicht als Regex-Treffer sehen
  • versionsstabile Metadaten erhalten

2. Docs-Konfiguration vom Agenten aus bearbeiten#

Ein Benutzer in Claude Code kann sagen: „Setze die Akzentfarbe meiner Dokumentation auf Markenlila und füge einen Discord-Link in der Fußzeile hinzu.“ Der Agent ruft update_branding und update_navigation auf dem MCP-Server auf. Kein Wechseln zwischen Dashboards, kein Kopieren und Einfügen, keine Bearbeitung von Markdown.

3. Dokumentationsanalysen innerhalb des Agenten abfragen#

„Welche Seiten hatten letzte Woche die meisten fehlgeschlagenen Suchen?“ — der Agent ruft get_failed_searches auf, sieht die Liste und bietet an, fehlende Inhalte direkt dort zu entwerfen.

Welche Tools ein guter Docs-MCP-Server bereitstellt#

Der MCP-Server von Docsbook stellt Tools in diesen Kategorien bereit. Die vollständige Liste wird vom Server selbst bei der Verbindung zurückgegeben — die folgende Tabelle zeigt die Struktur, nicht das Inventar:

Kategorie Beispiele
Arbeitsbereich list_workspaces, get_workspace, create_workspace
Inhalte und Dokumentation search_docs, get_doc_outline, write_docs
Branding update_branding, update_ui_settings, update_navigation
KI-Einstellungen update_ai_settings, set_chat_system_prompt, set_chat_hooks
SEO und Domain update_seo, update_domain
Übersetzung update_languages, set_translation_mode, approve_translation
Analysen get_analytics, get_ai_questions, get_failed_searches, get_negative_feedback, get_top_visitors, get_visitor_activity
Webhooks register_webhook_*, list_webhook_deliveries, test_webhook
Skills find_skill (fragt den docs-skills-Katalog ab)

Verbindung über Claude Code#

mcp add --transport http https://docsbook.io/api/mcp/server

Der OAuth-Ablauf wird im Browser geöffnet. Sie autorisieren den Zugriff, und die Tools erscheinen in Claude Code. Sie müssen keine API-Schlüssel verwalten und keine Konfigurationsdatei bearbeiten.

Cursor verwendet denselben MCP-Server mit einer ähnlichen Benutzererfahrung. ChatGPT und Gemini werden im Laufe des Jahres 2026 HTTP-MCP-Unterstützung hinzufügen.

LSP-ähnliche Tools sind die unterschätzte Hälfte (lokales Plugin, kein gehostetes MCP)#

Die meisten MCP-Marketingtexte für Dokumentation konzentrieren sich auf Lesen/Schreiben — im Fall von Docsbook search_docs, um zitierfähige Abschnitte zu finden, get_doc_outline, um vor dem Suchen oder Schreiben den Titel, die Anzahl der Überschriften und die Größe jeder Seite zu sehen, und write_docs, um Änderungen zu übernehmen (durch OAuth-Einwilligung abgesichert: Der Kunde wählt bei der Autorisierung der Verbindung den Nur-Lesen- oder Lese-Schreib-Bereich). Der größere Wert für Agents liegt in der LSP-ähnlichen Such- und Navigationsoberfläche — für ein funktionierendes Repository wird diese Oberfläche jedoch besser als lokales Claude-Code-Plugin bereitgestellt und nicht als gehostetes MCP-Tool. Die lokale Analyse auf der Festplatte ist schneller, günstiger und erfordert nicht, dass die Dokumentation bereits veröffentlicht ist.

Docsbook stellt dies über markdown-lsp bereit — führen Sie es lokal aus, und der Agent erhält:

  • doc_outline — Überschriftenhierarchie einer Seite (keine Inhalte)
  • doc_search_symbols — unscharfe Teilsequenzsuche über alle Überschriften („oaf“ → „OAuth flow“)
  • doc_search_text — Volltextsuche mit Snippets und exakter Zeile/Spalte
  • doc_search_links_to — eingehende Verweise (LSP references)
  • doc_resolve_link — relativer oder Wiki-Link → absolute GitHub-URL mit Anker
  • doc_definition — page#anchor → exakte Quellposition

LSP — Language Server Protocol — ist die Grundlage für „Gehe zu Definition“, „Verweise suchen“ und die Symbolsuche in VS Code. Das Plugin wendet dasselbe Modell auf Ihren lokalen Dokumentationsbaum an, sodass ein Agent mit IDE-ähnlicher Präzision navigieren kann. Der gehostete MCP-Server bleibt auf Arbeitsbereichsoperationen (Branding, Analysen, Webhooks, Übersetzungen) fokussiert, bei denen die Cloud tatsächlich Eigentümerin der Daten ist.

Warum dies ein echter Vertriebskanal ist#

Drei Signale aus den Jahren 2025–2026:

  1. Mintlify-Telemetrie. Mintlify hat den Traffic über 30 Tage hinweg auf den von ihm gehosteten Dokumentationsseiten gemessen — insgesamt etwa 790 Millionen Anfragen — und berichtet, dass KI-Coding-Agenten 45,3 % aller Anfragen ausmachten, wobei Claude Code 25,2 % und Cursor 18,0 % erreichten (Der Status des Agent-Traffics in der Dokumentation, veröffentlicht am 3. April 2026). Bei der anschließenden Messung lag der Anteil der Agenten im Juli 2026 bei 66 % des Traffics (Bericht zur Jahresmitte 2026, veröffentlicht am 29. Juli 2026). Das ist die Flotte eines einzelnen Anbieters und nicht das gesamte Web, aber es handelt sich um die größte veröffentlichte Messung des Agent-Traffics zu Dokumentationen.
  2. Anthropics Nutzung der eigenen Produkte. Die eigene Dokumentation von Anthropic und die Claude-Code-Dokumentation setzen vorrangig auf MCP.
  3. Die Client-Seite ist bereits aufgebaut. Claude Code, Cursor und ChatGPT werden mit MCP-Unterstützung ausgeliefert, sodass der Connector keine Akzeptanz auf Seiten der Leser benötigt — nur auf deiner.

Wenn du für Entwickler entwickelst und dein Publikum Claude Code oder Cursor verwendet, ist MCP keine optionale Infrastruktur mehr.

Was es kostet, selbst etwas zu entwickeln#

Ein sinnvoller Docs-MCP-Server erfordert:

  • HTTP-Transport + JSON-RPC-Framing
  • OAuth-2.0-Authorization-Code- + PKCE-Flow
  • Tool-Definitionen mit typisierten Schemata
  • Parsing des Dokumentgraphen für Lesewerkzeuge — normalerweise als lokales CLI-Tool wie markdown-lsp statt als gehosteter Endpunkt bereitgestellt, da die lokale Verarbeitung auf der Festplatte schneller und kostengünstiger ist
  • Schreibzugriff, wenn du Konfigurationen bearbeiten möchtest
  • Ratenbegrenzung und Audit-Protokollierung

Etwa 4–6 Entwicklungswochen, wenn du das noch nie gemacht hast. Der MCP-Server von Docsbook wird zusammen mit dem Arbeitsbereich geliefert und kostet im Betrieb nichts; markdown-lsp ist für die Lesewerkzeuge des Dokumentgraphen kostenlos und Open Source.

Docsbook stellt einen verwalteten MCP-Server mit OAuth bereit, sodass Claude Code und Cursor deine Dokumentation lesen und bearbeiten können, ohne dass du irgendetwas betreiben musst. Verbindungsdetails findest du unter docsbook.io/mcp.

Kostenlos starten — keine Kreditkarte erforderlich

Nächste Schritte#

Updated

War diese Seite hilfreich?

Powered by Docsbook