Docsbook
Übersicht

MCP-Server für Dokumentation: Was er ist und warum er überzeugt

Das Model Context Protocol (MCP) ist der Verbindungsstandard, den Anthropic Ende 2024 veröffentlicht hat. Bis Mitte 2026 wird er von Claude Code, Cursor, ChatGPT und einer wachsenden Zahl von Agenten unterstützt. Für Dokumentationen verwandelt MCP Ihre Dokumentation von einer reinen Website-Ressource 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 Dokumentationen bereitstellt und wie Docsbook einen solchen ausliefert.

Kurzfassung#

  • MCP = standardisierte Möglichkeit für KI-Agenten, externe Tools aufzurufen
  • Ein Docs-MCP-Server stellt Tools wie get_analytics, update_branding, set_chat_hooks bereit
  • Agenten ermitteln die verfügbaren Funktionen, fordern OAuth an und rufen anschließend im Rahmen ihrer Arbeit Tools auf
  • Docsbook stellt unter docsbook.io/api/mcp/server einen verwalteten MCP-Server bereit
  • Dies ist jetzt ein primärer KI-Vertriebskanal — Mintlify ermittelte, dass KI-Coding-Agenten im März 2026 45,3 % der Anfragen an die von Mintlify gehosteten Dokumentationsseiten ausmachten, Claude Code 25,2 % und Cursor 18,0 % (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?“, empfängt ein typisiertes Schema und ruft Tools auf. Die Authentifizierung erfolgt über OAuth 2.0 mit PKCE.

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

Warum Dokumentation von MCP profitiert#

Drei Workflows:

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 Netzwerk-Rundreise.

Das bedeutet, dass Agenten:

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

2. Bearbeiten der Dokumentationskonfiguration über den Agenten#

Ein Benutzer in Claude Code kann sagen: „Setze meine Akzentfarbe für die 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. Abfragen von Dokumentationsanalysen innerhalb des Agenten#

„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 vollständige 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
Domain update_domain
Übersetzung update_languages, set_translation_mode, approve_translation
Analytics 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
Funktionen 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 sich, und die Tools erscheinen in Claude Code. Keine API-Schlüssel zu verwalten, keine Konfigurationsdatei zu bearbeiten.

Cursor verwendet denselben MCP-Server mit einer ähnlichen Benutzererfahrung. ChatGPT und Gemini fügen bis 2026 Unterstützung für HTTP-MCP hinzu.

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

Die meisten MCP-Marketingtexte zu 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 eingeschränkt: Der Kunde wählt bei der Autorisierung der Verbindung den Nur-Lesen- oder Lese-/Schreib-Berechtigungsumfang). Der größere Nutzen 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. Das Parsen direkt 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 (ohne Textkörper)
  • doc_search_symbols — unscharfe Teilsequenzsuche über alle Überschriften („oaf“ → „OAuth flow“)
  • doc_search_text — Volltextsuche mit Ausschnitten und exakter Zeilen-/Spaltenangabe
  • 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 — ermöglicht „Gehe zu Definition“, „Referenzen suchen“ und die Symbols uche in VS Code. Das Plugin wendet dasselbe Modell auf Ihren lokalen Dokumentationsbaum an, sodass ein Agent mit IDE-ähnlicher Präzision navigiert. Der gehostete MCP-Server bleibt auf Arbeitsbereichsoperationen (Branding, Analytics, Webhooks, Übersetzungen) fokussiert, bei denen die Cloud tatsächlich die Daten besitzt.

Warum dies ein echter Vertriebskanal ist#

Drei Signale aus den Jahren 2025–2026:

  1. Mintlify-Telemetrie. Mintlify hat den Datenverkehr über 30 Tage hinweg auf den von ihnen gehosteten Dokumentationsseiten gemessen – 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 Stand des Agentenverkehrs in der Dokumentation, veröffentlicht am 3. April 2026). Eine Folgemessung ergab einen Agentenanteil von 66 % des Datenverkehrs im Juli 2026 (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 Agentenverkehrs zu Dokumentationen.
  2. Anthropic nutzt die eigenen Produkte. Die eigene Dokumentation von Anthropic und die Claude-Code-Dokumentation setzen vorrangig auf MCP.
  3. Die Client-Seite ist bereits entwickelt. 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 Seite.

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

Was es kostet, selbst zu entwickeln#

Ein sinnvoller Docs-MCP-Server benötigt:

  • HTTP-Transport + JSON-RPC-Framing
  • OAuth-2.0-Authorization-Code- + PKCE-Flow
  • Tool-Definitionen mit typisierten Schemas
  • Parsing des Dokumentationsgraphen für Lese-Tools – in der Regel als lokales CLI-Tool wie markdown-lsp statt als gehosteter Endpunkt, da das Parsen auf der lokalen Festplatte schneller und kostengünstiger ist
  • Schreibzugriff, wenn du Konfigurationsänderungen möchtest
  • Ratenbegrenzung und Audit-Protokollierung

Etwa 4–6 Wochen Entwicklungszeit, wenn du so etwas noch nicht umgesetzt hast. Der MCP-Server von Docsbook wird mit dem Workspace bereitgestellt und verursacht keine Betriebskosten; markdown-lsp ist für die Lese-Tools des Dokumentationsgraphen kostenlos und quelloffen.

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

Kostenlos starten – keine Kreditkarte erforderlich

Nächste Schritte#

Updated

War diese Seite hilfreich?