MCP-Server

Der Docsbook MCP-Server ist ein Remote Model Context Protocol-Server, der Ihre Dokumentation und die gesamte Administrationsoberfläche einem KI-Agenten zur Verfügung stellt. Verbinden Sie Claude Code oder einen beliebigen MCP-kompatiblen Client mit einem Endpunkt und lesen Sie Ihre Seiten, committen Sie Änderungen, lesen Sie Analysen und ändern Sie Einstellungen, ohne den Editor zu verlassen.

Diese Seite ist das Referenzdokument dafür, was der Server bereitstellt und auf was ein Aufruf zugreift. Jedes hier aufgeführte Tool kann von jedem verbundenen Client aufgerufen werden; was ein gemessener Aufruf kostet, finden Sie auf der Docsbook-Preisseite und in jeder Zeile des jeweiligen Tools in Ihrem Administrationspanel.

Was ist der Docsbook-MCP-Server?#

Der Docsbook-MCP-Server stellt 310 Tools über das Model Context Protocol bereit, einen offenen Standard für die Übergabe von Tools, Ressourcen und Prompts an KI-Agenten über eine typisierte RPC-Schnittstelle. Von diesen Tools sind 18 Registrierungen für jeweils ein Webhook-Ereignis; 136 sind Aktionstools, die jeweils einen Schritt der Dokumentationsarbeit zu einem Thema ausführen und mit einer validierten JSON-Nutzlast antworten; 41 sind Agenten, je einer pro Ziel, deren Implementierung aus einer Route dieser Aktionen in der richtigen Reihenfolge besteht; 12 greifen auf einen externen Anbieter für Scraping zurück, um Dinge zu erreichen, die der eigene Crawler von Docsbook nicht erreichen kann; fünf sind Sammler, die die Belege zurückgeben, auf denen die Aktionen basieren, ohne sie zu bewerten; und vier starten und lesen Hintergrundprozesse. Die verbleibenden 94 sind individuell benannte Tools für Arbeitsbereichs-, Inhalts-, Chat-, Analyse- und Webhook-Operationen — darunter die beiden, die ein Repository oder eine Website als Quelle der Wahrheit verbinden und konfigurieren, sowie die beiden, die einen dauerhaft laufenden Agenten nach Zeitplan, Ereignis oder Commits eines verbundenen Repositorys finden und aktivieren.

Endpunkt#

Der Docsbook-MCP-Server wird für jeden Arbeitsbereich und jeden Client unter derselben URL bereitgestellt:

https://docsbook.io/api/mcp/server

Die Authentifizierung erfolgt über einen OAuth-Autorisierungscode-Flow mit PKCE. Der Client erhält ein undurchsichtiges Bearer-Token, das er bei jedem Aufruf übermittelt; es wird kein Refresh-Token ausgestellt, und das Token läuft nicht automatisch ab. Eine Rotation bedeutet daher, es im Panel zu widerrufen und die Autorisierung erneut durchzuführen. Es gibt keine nachzuschlagende MCP-URL pro Projekt: Der OAuth-Flow ist auf das angemeldete Konto beschränkt, und der Client wählt anschließend den Arbeitsbereich aus. Weitere Informationen zum Flow, zu den Scopes und zu den Lücken finden Sie unter Sicherheit des MCP-Servers.

Wie verbinde ich meinen KI-Client mit Docsbook?#

Richten Sie Ihren Client auf https://docsbook.io/api/mcp/server und schließen Sie die OAuth-Aufforderung im Browser ab. Der Docsbook-MCP-Server ist ein entfernter HTTP-Server mit OAuth, sodass sich jeder moderne MCP-Client über denselben Endpunkt und ohne lokal auszuführenden Prozess damit verbindet. Die folgenden Unterabschnitte enthalten den genauen Befehl oder die Konfigurationsdatei für jeden Client.

Sie können den Katalog auch in Ihrem eigenen Projekt durchsuchen: Öffnen Sie das Admin-Panel und wählen Sie MCP in der Seitenleiste aus. Wenn Sie den Bereich zum ersten Mal öffnen, wird ein Einschalten-Panel mit dem Installationsbefehl für Ihren Client angezeigt. So können Sie eine Verbindung herstellen, bevor Sie den Katalog lesen, und durch Betätigen der Schaltfläche wird direkt über der Tabelle eine kurze Anleitung gestartet. Dahinter befindet sich eine Tabelle mit jedem Tool, das der Server derzeit bereitstellt. Sie wird live vom Server und nicht aus einer schriftlich festgehaltenen Kopie gelesen und enthält für jedes Tool seine Abrechnungsklasse, den Preis pro Aufruf, die typische Dauer eines Aufrufs sowie die Information, ob Leser es ohne Token aufrufen können. Durchsuchen Sie die Tabelle, schränken Sie sie mit Filtern ein — den Abrechnungsklassen, die jeweils mit ihrem eigenen Preis angezeigt werden — oder sortieren Sie sie nach einer beliebigen Spalte. Wenn Sie den Mauszeiger über eine Zeile bewegen, wird eine Karte mit allen weiteren Informationen zu diesem Tool geöffnet: was es tut, was ein Aufruf kostet und wie lange er normalerweise geöffnet bleibt, wie viele Argumente es akzeptiert und wie viele davon erforderlich sind, wie viele funktionierende Beispiele es aufrufen und — in Ihrem eigenen Projekt — was es Sie bisher gekostet hat und wann Sie es zuletzt aufgerufen haben, einschließlich der aufrufbaren ID zum Kopieren. Wenn Sie auf eine Zeile klicken, wird die eigene Seite dieses Tools geöffnet. Die Seite hat eine Adresse: Die URL enthält das Tool, sodass Sie sie aktualisieren, als Lesezeichen speichern oder an einen Kollegen senden können und dieser beim selben Tool landet statt wieder bei einer Tabelle mit dreihundert Zeilen. Alles auf dieser Seite bezieht sich auf dieses eine Tool. Seine Argumente werden als Formular mit einer Ausführen-Schaltfläche angezeigt, die einen echten Aufruf für dieses Projekt ausführt, wobei die Schaltfläche den Preis anzeigt, bevor Geld bewegt wird. Darunter befindet sich der Aufrufverlauf, der von derselben Feeds-Tabelle stammt, die Sie überall sonst lesen, und auf dieses eine Tool eingeschränkt ist: eine Zeile pro Aufruf. Wenn Sie eine Zeile erweitern, wird der vollständige Aufruf angezeigt — was hineinging, was zurückkam, wer ihn angefordert hat (Ihr Ausführen-Aufruf, ein externer Agent, ein Zeitplan oder ein Ereignis), wie lange er gedauert hat, wie hoch sein Preis war und was tatsächlich von Ihrem Guthaben abgezogen wurde. Darunter sehen Sie, was das Tool unbeaufsichtigt ausführt: einen Zeitplan, ein Ereignis oder einen Ihrer gespeicherten Feeds, sodass ein Aufruf einen gesamten Feed statt nur eines einzelnen Ereignisnamens überwachen kann. Jede aktivierte Zeile zeigt, worauf sie bereits reagiert, damit Sie nie einen zuvor eingerichteten Lauf ersetzen, ohne es zu sehen. Am Ende der Seite stehen die Agents, die dieses Tool verwenden — die Karten aus dem Bereich Agents, deren Route es tatsächlich aufruft, wobei aktivierte Agents zuerst angezeigt werden. Jeder verfügt über einen eigenen Schalter, sodass Sie das Tool direkt von der Seite aus in einen Zeitplan aufnehmen können, auf der Sie gerade gelesen haben, was ein Aufruf kostet. Darunter befindet sich ein funktionierendes Beispiel zum Kopieren in Ihren eigenen Client. Was innerhalb von Docsbook ausgeführt wird, ist der Aufruf.

Claude Code#

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

Der erste Aufruf öffnet einen Browser-Tab für OAuth. Nach der Zustimmung stehen die Tools in Claude Code zur Verfügung.

Cursor#

Cursor hat keinen mcp add Befehl, aber es akzeptiert einen Ein-Klick-Installationslink:

cursor://anysphere.cursor-deeplink/mcp/install?name=docsbook&config=eyJ1cmwiOiJodHRwczovL2RvY3Nib29rLmlvL2FwaS9tY3Avc2VydmVyIiwidHlwZSI6Imh0dHAifQ==

Oder fügen Sie den Server zu ~/.cursor/mcp.json hinzu (oder verwenden Sie Einstellungen → MCP & Integrationen → Neuer MCP-Server):

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

Cursor neu laden — OAuth öffnet sich beim ersten Gebrauch im Browser.

Codex CLI#

codex mcp add docsbook --url https://docsbook.io/api/mcp/server

Oder bearbeite die Konfiguration direkt — Codex speichert MCP-Server in ~/.codex/config.toml:

[mcp_servers.docsbook]
url = "https://docsbook.io/api/mcp/server"

Windsurfen#

Bearbeiten Sie ~/.codeium/windsurf/mcp_config.json und aktualisieren Sie das Cascade-Panel:

{
  "mcpServers": {
    "docsbook": {
      "serverUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

Cline#

Öffnen Sie Cline → MCP-Server → MCP-Server konfigurieren und fügen Sie ein:

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server",
      "transportType": "http"
    }
  }
}

Gemini CLI#

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

Der Standardbereich ist das aktuelle Projekt — füge --scope user hinzu, um es global zu installieren. Oder füge es manuell zu ~/.gemini/settings.json hinzu (beachte, dass der Schlüssel httpUrl ist; url dort bedeutet SSE):

{
  "mcpServers": {
    "docsbook": {
      "httpUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

GitHub Copilot (VS Code)#

code --add-mcp '{"name":"docsbook","type":"http","url":"https://docsbook.io/api/mcp/server"}'

Oder erstellen Sie .vscode/mcp.json in Ihrem Arbeitsbereich und aktivieren Sie dann den Server über den Copilot Chat MCP Picker (beachten Sie, dass der Schlüssel servers ist, nicht mcpServers):

{
  "servers": {
    "docsbook": {
      "type": "http",
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

ChatGPT#

ChatGPT unterstützt remote MCP über Connectoren, in ChatGPTs eigenen kostenpflichtigen Plänen. Diese Anforderung stammt von OpenAI, nicht von Docsbook.

1. Öffnen Sie ChatGPT → Einstellungen → Connectoren → Erweitert → Entwicklermodus.
2. Klicken Sie auf Erstellen und fügen Sie die URL ein: https://docsbook.io/api/mcp/server.
3. Autorisieren Sie im Browser, wenn Sie dazu aufgefordert werden.

Wofür sind die Docsbook MCP-Tools?#

Die Docsbook MCP-Tools existieren, um eines von vier Dingen zu erreichen: mehr qualifizierte Leser kommen, mehr von ihnen verlassen die Seite mit dem, was sie gesucht haben, mehr kaufbereite Leser werden vom Assistenten weitergeleitet, und weniger Fragen erreichen eine Person. Alles unten ist nach dem gruppiert, was von diesen vier bedient wird.

Ihre Dokumentation ist kein Kostenfaktor. Sie ist ein Kanal mit drei Aufgaben: gefunden werden (durch Google und durch die KI-Assistenten, die Ihre Käufer jetzt anstelle von Google fragen), den Leser konvertieren (ein Besuch, der ohne Ergebnis endet, ist ein verlorener Kunde, der sich nie beschwert hat), und beweisen, was funktioniert hat (damit die nächste Bearbeitung eine Entscheidung und kein Rätsel ist).

Es gibt nur vier Möglichkeiten, wie ein Dokumentationswerkzeug Geld verdient, und jedes der unten aufgeführten Werkzeuge dient einer davon:

Ein Werkzeug, das keines dieser Ziele erreicht, liefert Kontext, nicht eine Entscheidung. Pageviews: 12,340 ist Kontext. 31% of your readers left with nothing ist eine Entscheidung.

Gefunden werden#

Käufer fragen zunehmend einen Assistenten, bevor sie einen Anbieter fragen. Wenn der Assistent aus den Dokumenten eines Mitbewerbers antwortet, kommst du nie auf die Shortlist und der Verlust erscheint in keinem Dashboard.

Den Leser nicht verlieren#

get_visit_outcomes ist die Überschriftnummer des gesamten Produkts: Sie klassifiziert jeden Besuch als Erfolg / Sackgasse / Absprung / teilweise und berichtet über die Sackgassenrate und die Selbstbedienungsauflösungsrate. Eine Sackgasse ist ein Leser, der gesucht, die KI gefragt oder mehrere Seiten geöffnet hat — und trotzdem mit nichts gegangen ist. Alles, was unten steht, beantwortet „…und wo genau?“

Nachfrage, die Sie nicht bedienen#

Jede Zeile hier ist ein Support-Ticket, das Sie durch das Schreiben einer Seite vorwegnehmen können.

Verkauf über den Assistenten#

Der Chat ist kein Support-Widget. Es ist der einzige Ort, an dem ein Interessent seinen Einwand in einfacher Sprache äußert.

Ein im Chat Ihrer Dokumentation geäußerter Preis-Einwand ist mehr wert als ein Seitenaufruf: der Leser hat sich selbst qualifiziert und Ihnen genau gesagt, was ihn am Kauf hindert.

Auf die Erkenntnis reagieren#

Eine Diagnose ohne Behebung ist nur ein Bericht. Diese schließen den Kreis innerhalb einer Verbindung.

Wissen ohne zu schauen#

Ein Dashboard funktioniert nur, wenn jemand es öffnet. Ein Webhook funktioniert immer. Die Registrierung eines Webhooks kostet einen Schreibaufruf; jede spätere Lieferung ist ein ausgehender Anruf aus dem Docsbook-Netzwerk.

Reichweite und Eigentum#

Die Kombinationen, die auszahlen#

Kein einzelnes Werkzeug oben ist das Produkt. Diese Schleifen sind es.

Schleife 1 — "Welche Seite kostet mir Kunden?"#

get_visit_outcomes      → the rate: 31% of visits end with nothing
get_dead_end_pages      → which pages those visits died on
get_rage_signals        → what the reader was trying to do there
get_change_history      → has this page been "fixed" before, and did it work?
search_docs → write_docs → ship the fix
get_page_diff_impact    → did the edited pages beat the pages you did not touch?

Die Rate allein ist nicht umsetzbar, die Seitenliste allein fehlt eine Ursache, und eine Lösung ohne get_change_history wiederholt eine fehlgeschlagene Bearbeitung mit vollem Vertrauen. Der letzte Schritt schließt die Schleife: Eine trendlinie über die gesamte Website bewegt sich aus einem Dutzend Gründen, daher ist "die Rate hat sich nach meinem Commit verbessert" nur ein Beweis, wenn die Seiten, die Sie bearbeitet haben, mehr verbessert haben als die, die Sie in Ruhe gelassen haben. Nur die Reihenfolge erzeugt eine Veränderung, die Sie verteidigen können.

Schleife 2 — "Lügt meine Navigation die Leser an?"#

get_route_patterns   → a frequent 3-page route that keeps ending badly
get_reverse_funnel   → the route successful readers actually take
update_navigation    → promote the working entry point
get_forward_funnel   → confirm completion on the declared route improved

Eine Route, die fehlschlägt, während ihre einzelnen Seiten gut abschneiden, ist ein Navigationsfehler — get_content_health würde für immer auf gesunde Seiten zeigen.

Schleife 3 — "Wo gehen die Deals verloren?"#

get_chat_intent          → 40 pricing-stage conversations, a competitor named in 12
get_chat_conversations   → those topics have near-zero click_through
set_chat_system_prompt   → handle that objection, route to a demo
write_docs               → a comparison page that answers it once and for all
get_chat_intent (later)  → did the objection stop recurring?

Die einzige Schleife in einem Dokumentenprodukt, die mit einem angegebenen Einwand beginnt und mit einer gelieferten Antwort endet. click_through ist das, was "der Assistent hat geantwortet" von "der Assistent hat verkauft" trennt.

Schleife 4 — "Bin ich für KI sichtbar und hat es jemanden gebracht?"#

update_geo + update_aeo   → structure content for citation
get_analytics (ai_bots)   → confirm crawlers are actually reading it
get_search_rankings       → track classic-search position alongside
get_analytics (referrers) → referrals arriving from AI assistants
get_visit_outcomes        → and whether those arrivals end in success

Der letzte Schritt ist der, den jeder überspringt. Verkehr von einer KI-Antwort, die ins Leere führt, ist schlimmer als kein Verkehr — Sie haben die Sichtbarkeit verdient und den Eindruck verbrannt.

Der selbstheilende Loop#

Führen Sie Loop 1 nach einem Zeitplan von CI aus:

weekly:  get_content_health  → take the worst 3
         get_change_history  → skip anything already tried and failed
         search_docs → write_docs → open a PR
         get_page_diff_impact → report on the PR whether the edited pages
                                beat the untouched ones, or say they did not

Dokumentation, die sich selbst repariert und ihre Arbeit zeigt — "sah das Problem" und "behebt das Problem", ohne die Verbindung zu verlieren.

Übergabe des gesamten Auftrags#

Jedes oben genannte Tool antwortet innerhalb des Anrufs, der danach gefragt hat. Vier tun dies nicht, und das ist der Punkt.

Eine Website zu prüfen, eine zu erstellen, sie umzugestalten oder die Überwachungsinstrumente einzurichten, die sie ehrlich halten, sind Minuten Arbeit — Seiten lesen, über Zahlen nachdenken, Dateien festschreiben. find_skill erledigt das, indem es die SKILL.md an deinen Agenten übergibt, was nur funktioniert, wenn dein Agent auch hier verbunden ist, einen Arbeitsbereich ausgewählt hat und zwanzig Tool-Anrufe dafür aufwenden wird. Diese vier führen die Fähigkeit stattdessen auf unserer Seite aus, gegen deinen Arbeitsbereich, mit dem vollständigen administrativen Werkzeugset, für das die Fähigkeit geschrieben wurde.

Ein Projekt zu starten und sein Ergebnis zu lesen, sind zwei separate Anrufe. Ein run_docs_* Anruf gibt { run_id, state: "queued" } zurück — niemals Ergebnisse, niemals Seiten. get_agent_run gibt den Zustand zurück, den aktuellen Fortschritt während des Ablaufs, und sobald es erfolgreich war, den Bericht, jede Aktion, die der Ablauf durchgeführt hat, und was sich geändert hat. list_agent_runs findet eine Lauf-ID, die du verloren hast; cancel_agent_run stoppt einen, der nicht beendet ist, ohne das, was er bereits festgeschrieben hat, rückgängig zu machen.

Die drei, die schreiben, benötigen ein Lesen-Schreiben Token. run_docs_analyze benötigt dies nicht, da es nicht schreiben kann.

Evidenz kaufen ohne die Meinung#

Ein Audit macht sieben Dinge in einem Anruf: sammelt, normalisiert, interpretiert, beurteilt, bewertet, rangiert, empfiehlt. Führen Sie die ersten beiden zweimal aus und Sie erhalten die gleiche Antwort, und jeder kann sie von Hand wiederholen und überprüfen. Ab judge ist die Antwort die des Modells. Beide Hälften wurden früher als ein Agentenlauf berechnet, was bedeutete, dass die Hälfte, die Sie überprüfen können, zum Preis der Hälfte verkauft wurde, der Vertrauen erfordert.

Fünf Sammler sind die erste Hälfte für sich, berechnet als probe anstelle eines Agentenlaufs:

Es gibt kein Modell im Pfad, also gibt es nichts, was man nicht glauben könnte — und die Nutzlast beweist es, anstatt es zu behaupten. Jede Antwort trägt einen reproduce Block: die genauen MCP-Aufrufe und die Argumente, mit denen sie pro Zeile gemacht wurden. Führen Sie sie selbst aus und Sie erhalten denselben Datensatz zurück, abgesehen vom Zeitstempel. Nichts, was ein Audit zurückgibt, kann das bieten, denn die Antwort eines Audits ist durch ein Modell gegangen.

Was Sie nicht erhalten, ist ein Urteil. Keine Ergebnisse, keine Bewertungen, kein Ranking, keine Empfehlung — das sind die Dinge, die der Preis eines Aktionswerkzeugs kauft, und ein Sammler, der stillschweigend eines einbezogen hat, wäre ein Agentenlauf zu einem Bruchteil des Preises.

Wenn das Günstige das Richtige ist. Ohne verbundenes Search Console bewertet measure_intent_match seine Rankingachsen als nicht gemessen und berechnet dennoch für den Lauf; collect_corpus_map benötigt keine Suchdaten, keinen Verkehr und keine Geschichte und gibt echte Zeilen auf einer Seite zurück, die heute Morgen hochgegangen ist. Dasselbe gilt, wenn Sie die Zahlen wollen, auf denen eine Aktion aufgebaut wurde, bevor Sie entscheiden, ob Sie deren Auswertung kaufen möchten.

Was fehlt, wird laut ausgesprochen. Eine Quelle, die nicht gelesen werden konnte, erscheint dreimal — in skipped, in unavailable mit dem, was es hinzugefügt hätte, und in ihrer eigenen reproduce Zeile mit dem Grund, warum sie fehlgeschlagen ist. Eine Rate ohne etwas, durch das man teilen könnte, kommt als null mit dem Grund zurück, niemals als null, und jede Rate trägt ihren Nenner.

Die Zahlen ehrlich lesen#

Jede Analyseantwort vom Docsbook MCP-Server trägt ihre eigenen Vorbehalte in einem metrics Feld. Drei Punkte sind wichtig genug, um sie zu wiederholen:

• Besucher sind gehashte IPs. Office NAT fasst mehrere Leser zu einem zusammen; mobile Netzwerke teilen einen Leser in viele auf. Berichten Sie über Trends, niemals über Kopfzahlen — get_retention ist am stärksten betroffen.
• Raten werden unter 30 Besuchen zurückgehalten, und dünne Tage werden thin markiert. Eine 100%ige Abbruchrate über vier Besuche ist Lärm.
• terminal_success ist kein Misserfolg. Eine Seite, von der Menschen nach dem Kopieren eines Snippets gehen, ist die beste Seite, die Sie haben. Jedes Ranking-Tool schließt diese aus — führen Sie den Fehler nicht manuell wieder ein.

Wie durchsuche und bearbeite ich Dokumentationsinhalte über einen Agenten?#

Es gibt zwei Möglichkeiten, mit einem Agenten an Ihren Dokumentationsinhalten zu arbeiten. Welche davon Sie verwenden möchten, hängt davon ab, ob der Agent das Repository auf der Festplatte hat:

• Gehostet über MCP-Token — search_docs (nur lesend; funktioniert mit jedem verbundenen Token unabhängig von dessen Berechtigungsumfang), get_doc_outline (nur lesend; listet vor dem Suchen oder Schreiben den Titel, die Anzahl der Überschriften und die Größe jeder Markdown-Seite auf) und write_docs (erfordert ein Token mit autorisiertem Read-Write-Berechtigungsumfang; führt einen oder mehrere Commits als einen einzigen atomaren Git-Commit aus). Diese Befehle greifen direkt auf das von Docsbook gehostete Repository zu, ohne dass ein lokaner Checkout erforderlich ist.
• Lokal über markdown-lsp — für einen Agenten, der direkt mit Ihren ausgecheckten Dateien arbeitet, beantwortet markdown-lsp umfangreichere Fragen zum Graphen (Workspace-Übersicht, unscharfe Überschriftensuche, Volltextsuche mit Kontext, eingehende und ausgehende Links, Linkauflösung) als Befehle, die der Agent ausführt — npx markdown-lsp <subcommand> ./docs — oder als Sprachserver. Es handelt sich nicht um einen MCP-Server und es wird kein Token benötigt. Unter Source of Truth finden Sie die Liste der Unterbefehle und die Begründung.

Verwenden Sie search_docs/write_docs, wenn der Agent nur über eine MCP-Verbindung verfügt (kein lokaler Checkout); verwenden Sie markdown-lsp, wenn der Agent das Repository bereits auf der Festplatte hat und eine umfassendere Navigation durch den Graphen benötigt.

Worauf greift ein Aufruf des Docsbook-MCP-Servers zurück?#

Jeder kostenpflichtig erfasste Aufruf des Docsbook-MCP-Servers wird dem Guthaben des Projekts belastet, auf das sich der Aufruf bezieht — demselben Guthaben, das durch eine Aufladung erhöht wird und aus dem auch die übrigen KI-Aktivitäten dieses Projekts bezahlt werden. Für MCP gibt es keinen separaten Zähler und kein monatliches Aufrufkontingent, das Sie einplanen müssen. Geld ist die einzige Begrenzung.

Ein Aufruf wird mit einem festen Betrag berechnet, der vor der Ausführung feststeht und unabhängig vom Umfang der Antwort ist. Derselbe Reporting-Aufruf belastet eine Website mit zehn Seiten genauso wie eine mit zehntausend Seiten. Entscheidend für den Betrag ist, was der Server durch die Verarbeitung des Aufrufs tun muss:

Der Preis eines Aktions-Tools wird anhand der von ihm deklarierten Arbeit festgelegt — also danach, wie viele Evidenzgruppen es liest, wie viele Modell-Roundtrips es möglicherweise ausführt, ob es Ihre Website verlässt und ob es ein Artefakt schreibt — und nicht anhand eines einzigen Pauschalbetrags für die gesamte Kategorie. Daher belastet eine begrenzte Beobachtung nur einen Bruchteil dessen, was ein umfangreicher Entwurf kostet, und die veröffentlichte Wartezeit (etwa 20 bis 70 s) unterscheidet sich entsprechend.

Der aktuelle Betrag für jede Kategorie und jedes einzelne Tool steht in der eigenen Zeile des Tools im Abschnitt MCP Ihres Adminbereichs. Er wird live vom Server gelesen und nicht aus einer schriftlich hinterlegten Kopie übernommen. Außerdem finden Sie ihn auf der Docsbook-Preisseite. Auf dieser Seite werden bewusst keine Preise genannt: Ein Preis, der in der Dokumentation kopiert wird, veraltet, ohne dass es jemand bemerkt.

Die Erkennung wird niemals berechnet. Den Server zu beschreiben, eine Fähigkeit oder ein Widget zu finden, Ihre Arbeitsbereiche aufzulisten und einen zu erstellen, kostet nichts — der Handshake und der Aufruf, der das berechnete Objekt erstellt, dürfen Ihnen nicht in Rechnung gestellt werden.

Welches Projekt zahlt, wird aus dem Aufruf selbst ermittelt — aus dem von Ihnen angegebenen Arbeitsbereich und dem Repository, auf das er beschränkt ist — und es ist immer nur ein Projekt, das Ihnen gehört. Ein Aufruf ohne Projektangabe wird ohne Berechnung ausgeführt. Wenn ein Tool anschließend KI-Arbeit ausführt, wird auch diese Arbeit berechnet; die beiden Beträge werden addiert und ersetzen einander nicht.

Wenn das Guthaben aufgebraucht ist, wird ein kostenpflichtiger Aufruf abgelehnt, bevor er ausgeführt wird. Die Ablehnung nennt das Projekt, dessen Guthaben aufgebraucht ist, den Betrag des Aufrufs, den verbleibenden Betrag und die Stelle, an der Sie dieses Projekt aufladen können. Ein Guthaben wird nicht nach einem Zeitplan gewährt. Sie können jedoch auf der Abrechnungsseite eine eigene monatliche Zahlung einrichten, die dasselbe Guthaben jeden Monat auffüllt. Die kostenlose Erkennung funktioniert weiterhin, sodass Ihr Agent nach wie vor herausfinden kann, was passiert ist.

Ein fehlgeschlagener Aufruf wird trotzdem berechnet — die Arbeit wurde ausgeführt, und die Antwort weist darauf hin. Ein Aufruf, den der Server überhaupt nicht ausführen konnte, wird nicht berechnet.

Sie können die Aufrufe Zeile für Zeile lesen. Jeder kostenpflichtig erfasste Aufruf erscheint im Feeds-Bereich des Projekts — welches Tool verwendet wurde, ob es erfolgreich war, wie lange es gedauert hat und welchen Betrag es belastet hat — und kann nach Abrechnungskategorie gefiltert werden. Aufrufe ohne Bezug zu einem einzelnen Projekt (den Server beschreiben, Ihre Projekte auflisten, eines erstellen) gehören zu Ihrem Konto und erscheinen in keinem Projekt-Feed; Erkennungsaufrufe hinterlassen überhaupt keine Zeile.

Nicht authentifizierter, auf ein Repository beschränkter Zugriff auf eine öffentliche Dokumentationswebsite wird niemals berechnet.

Was ein Token tun darf#

Der Zugriff auf den Docsbook-MCP-Server wird durch das Token festgelegt, nicht durch eine Stufe. Ein Token enthält einen Scope, und nur der Scope unterscheidet zwischen Lesen und Schreiben:

• Nur Lesen — alle Reporting-, Such- und Gliederungstools antworten. write_docs, create_issue, connect_source, configure_source, enable_agent und die drei schreibenden run_docs_*-Aufrufe werden abgelehnt und nennen den Grund. Diese acht Tools prüfen derzeit den Scope; die Einstellungs-, Webhook-, Ziel- und Übersetzungstools sind allein durch den Projektbesitz eingeschränkt. Ein Nur-Lesen-Token bedeutet also nicht, dass es "keine Änderungen" gibt — siehe Sicherheit des MCP-Servers.
• Lesen und Schreiben — alles, was das Konto tun kann: Seiten committen, Issues anlegen, Quellen verbinden, Agenten aktivieren und Einstellungen ändern.
• Überhaupt kein Token — bei einem Repository-bezogenen Endpunkt (docsbook.io/{owner}/{repo}/api/mcp/server) antworten get_info, find_skill, find_widget und list_content_widgets aus dem öffentlichen Katalog, und search antwortet über die eigene Dokumentation dieser Website — das einzige Tool hier, das ein Projekt liest, da es die veröffentlichte Website liest. Auf einer privaten Website, auf einer Website mit abgelaufenem Plan, bei einem nicht an eine Website gebundenen Endpunkt und wenn für das Projekt kein AI-Guthaben mehr vorhanden ist, wird es abgelehnt. Es akzeptiert kein Projektargument und kann daher immer nur die Website lesen, an die es gebunden ist. Jedes andere Tool erfordert ein gültiges Bearer-Token, das mit einem Docsbook-Konto verknüpft ist.

Wenn ein Aufruf abgelehnt wird, gibt der Server einen strukturierten Fehler zurück, der den Grund nennt, statt eines einfachen 403, sodass der Agent einem Benutzer sagen kann, was zu beheben ist. Siehe MCP-Server — Vertrauen & Sicherheit für den Authentifizierungsablauf und Informationen dazu, was der Server speichert.

Verwandte Inhalte#

• Referenz der MCP-Tools — jedes Tool mit seinen Parametern.
• Chat-Hooks — Konfigurieren Sie Pre-/Post-LLM-Hooks über MCP.
• Dokumentations-Skills — Ermitteln Sie SKILL.md-Dateien über find_skill oder lassen Sie eine für Sie ausführen mit run_docs_*.
• Webhooks — Registrieren Sie Event-Handler über MCP und überprüfen Sie deren Signaturen.
• Preise — worauf ein kostenpflichtiger Aufruf basiert, generiert aus den aktuellen Abrechnungskonstanten.