Quellen

Eine Docsbook-Quelle ist ein Repository, eine Website oder eine einzelne Seite, die der Assistent und die Agenten dieses Projekts abrufen dürfen. Verbinden Sie eine Quelle, und „Dokumentation aktualisieren“ oder „Ist diese Seite noch aktuell?“ beginnt mit dem Lesen statt mit einer Erinnerung.

Öffnen Sie den Abschnitt Quellen im Adminbereich Ihres Projekts, direkt unter MCP und Agenten.

Was Sie erhalten#

• Eine Adresse, die der Assistent aufrufen kann. Fragen Sie, wie viel Ihr Produkt kostet, und er ruft für diese Frage Ihre Preisseite auf, statt aus dem zu antworten, was er beim Training aufgenommen hat.
• Dieselbe Registrierung in Ihren eigenen Tools. Die beiden Tools, die das Feature ausmachen, list_sources und read_source, werden über den MCP-Endpunkt Ihres Projekts bereitgestellt. Eine Quelle, die Sie hier verbinden, bedeutet also dasselbe in Claude Code oder Cursor.
• Ein Satz von Ihnen, der an jede Quelle angehängt wird. Die Notiz, die Sie schreiben („der API-Server, den die Referenzseiten beschreiben“), wird von allem, was diese Quelle später liest, als Anweisung verstanden.
• Ein Lesen, das deutlich fehlschlägt. Ein nicht erreichbares Repository wird als Fehler mit einem Hinweis zurückgegeben, niemals als leere Liste, die wie ein leeres Repository wirkt.
• Keine Tarif-Schranke. Quellen sind bewusst in jedem Tarif enthalten: Eine Bezahlschranke würde hier die Möglichkeit verkaufen, die Wahrheit zu sagen.

Was kann ich als Quelle verbinden?#

Im Hintergrund gibt es vier Arten — Website, Seite, Repository und Repository-Ordner — und die Tabelle präsentiert sie als Katalog der benannten Dinge, nach denen Betreiber tatsächlich fragen, in fünf Gruppen: Ihr Projekt, Dokumentationsplattformen, Wissensdatenbanken, Code und APIs sowie Community. Eine veröffentlichte Dokumentationswebsite ist eine Website, unabhängig davon, wer sie erstellt hat. Daher muss für Mintlify, GitBook, ReadMe, Docusaurus, Read the Docs, MkDocs, Nextra, VitePress, Starlight, Redocly, Stoplight, Scalar und alle anderen Anbieter nichts Eigenes eingerichtet werden.

Die Tabelle führt jede Docsbook bekannte Art auf, unabhängig davon, ob sie verbunden ist oder nicht, und grenzt sie über ein Filter-Menü ein, statt sie in Abschnitte aufzuteilen. Jede Verbindung hat ihre eigene Zeile: Zwei verbundene Websites ergeben zwei Zeilen.

Grau bedeutet zwei verschiedene Dinge, und die Zeile gibt an, welches zutrifft:

• Nicht verbunden — die Zeile bietet eine Option zum Verbinden. Das Lesen funktioniert heute über denselben öffentlichen Abruf, den jede andere url-Zeile verwendet.
• Noch nicht verfügbar — die Zeile bietet keine Schaltfläche und gibt an, was dafür erforderlich wäre: eine einmalige Autorisierung (Notion-Arbeitsbereich, Confluence, Coda), ein Bot-Token (Telegram, Discord, Slack) oder einen Reader für einen Repository-Host, den Docsbook bisher noch nicht liest (GitLab, Bitbucket). Wo es eine Umgehungslösung gibt, nennt die Zeile sie — ein öffentliches Hilfezentrum kann heute als Website verbunden werden.

Eine Zeile ohne Schaltfläche ist beabsichtigt. Eine Zeile darf nur dann eine Option zum Verbinden anbieten, wenn read_source sie in ihrem aktuellen Zustand tatsächlich lesen kann; eine Verbindung, die nicht funktioniert, macht jede andere Zeile auf dem Bildschirm unzuverlässig.

Wie verbinde ich eine Quelle?#

Klicken Sie in einer Zeile auf Verbinden oder oberhalb der Tabelle auf Neue Quelle. In beiden Fällen gibt es ein Feld, und die Adresse entscheidet, was die Quelle ist – nicht die Zeile, auf die Sie geklickt haben. Die angeklickte Zeile legt lediglich den Platzhalter und die Überschrift fest. Wenn beides nicht übereinstimmt, weist der Dialog darauf hin, bevor Sie bestätigen.

Eine Dateiendung im Pfad unterscheidet eine Seite von einer Website. Ein aus einem Issue oder Pull Request eingefügter Link verbindet das Repository, nicht das Issue – würde /issues als Teilbaum gespeichert, bliebe die Quelle bei jeder Abfrage dauerhaft leer. Tracking-Parameter (utm_*, fbclid, gclid, ref, si…) werden entfernt, sodass dieselbe Seite, die aus einem Tweet und aus Ihrer Adressleiste eingefügt wurde, eine Quelle statt zwei ist. Ein Host ohne weiteren Pfad erhält https://; ein von Ihnen absichtlich eingegebenes http:// bleibt unverändert, da eine stille Aufrüstung bei einer Website ohne TLS zu einer Quelle führen würde, die 404 zurückgibt, ohne dass sich anhand der Zeile erkennen lässt, warum.

Für ein privates Repository benötigen Sie die Auswahlfunktion, nicht das Einfügen. GitHub gibt für „privat“ und „existiert nicht“ denselben 404-Fehler zurück. Eine eingefügte Adresse kann Docsbook daher nicht mitteilen, um welchen Fall es sich handelt, und eine manuell eingegebene private Adresse wird als öffentlich verbunden und liefert keine Daten. Verwenden Sie im Dialog Oder eines Ihrer GitHub-Repositories auswählen: Die Auswahlfunktion kennt den Unterschied, und eine als privat markierte Quelle speichert die GitHub-Autorisierung des verbindenden Kontos verschlüsselt im Ruhezustand, sodass ein geplanter Lauf ohne Browsersitzung dahinter das Repository weiterhin lesen kann. Diese Autorisierung verlässt niemals den Server – die API gibt has_token zurück, niemals das Token – und ein Token, das GitHub inzwischen abgelehnt hat, wird als „Dieses Repository erneut verbinden“ gemeldet, statt stillschweigend erneut versucht zu werden.

Zwei Einträge erscheinen, ohne dass Sie sie hinzufügen, und keiner davon kann hier umbenannt, pausiert oder entfernt werden:

• Repo dieser Website – das Repository, aus dem Ihre Dokumentation erstellt wird. Es wird bereits gelesen; Sie zum „Verbinden“ aufzufordern, würde bedeuten, dass dies nicht der Fall wäre.
• Aus Branding – die URL der Website-Quelle, sofern Ihr Arbeitsbereich eine festgelegt hat. Sie befindet sich weiterhin auf der Branding-Karte.

Wenn Sie eine bereits verbundene Adresse erneut einfügen, aktualisiert dies die betreffende Zeile, statt einen Fehler zu verursachen oder sie zu duplizieren. Beim erneuten Einfügen ohne Notiz wird die Notiz, die Sie beim ersten Mal eingegeben haben, nicht gelöscht.

Was liest eine verbundene Quelle?#

Drei Dinge und nichts anderes. Eine verbundene Quelle wird nicht nach einem Zeitplan gecrawlt, nicht zu Ihrer veröffentlichten Dokumentation hinzugefügt und nicht vom leserseitigen Chat auf Ihrer Dokumentationsseite durchsucht — dieser antwortet ausschließlich anhand Ihrer eigenen Seiten (Antwortqualität ist die von ihm verwendete Pipeline).

Der Assistent in Ihrem Admin-Panel. list_sources und read_source gehören zu seiner grundlegenden Werkzeugausstattung und sind nicht hinter einer Suche verborgen, denn eine Fähigkeit, deren Entdeckung einen zusätzlichen Roundtrip kostet, beantwortet das Modell stattdessen aus dem Gedächtnis — genau diesen Fehler sollen die Quellen verhindern.

Ihre eigenen MCP-Agenten. Dieselben beiden Tools über den MCP-Endpunkt Ihres Projekts sowie connect_source und configure_source, um einen solchen einzurichten, ohne einen Browser zu öffnen. Diese beiden benötigen ein Lese-Schreib-MCP-Token.

Hintergrundausführungen. Auch geplante Prompts und Agentenausführungen lesen sie, und genau hier ist das am wichtigsten: Niemand sitzt dort, um einen Link einzufügen.

Nicht jede automatisierte Ausführung erreicht eine Quelle. Daher zeigt das Panel, welche dies tun, anstatt anzudeuten, dass alle dazu in der Lage sind. Überall, wo Ausführungen aufgelistet werden, werden die Chips in drei Zuständen angezeigt:

• Beleuchtet — diese Ausführung ruft die Quelle ab: die Seiten Ihrer Website, die Dateien Ihres Repositorys.
• Unbeleuchtet — diese Ausführung weiß, dass die Quelle verbunden ist, und wird sie benennen, hat aber nie erklärt, dass sie die Eigenschaft verlässt, und wird sie daher nicht abrufen. Fragen Sie stattdessen den Assistenten; für ihn gibt es keine solche Schranke.
• Überhaupt nichts — diese Ausführung erreicht keine Quelle. Ein Schreiben in die Einstellungen hat keinen Grund, Ihr Repository zu lesen, und ein Chip an dieser Stelle würde das Gegenteil aussagen.

Wie wird eine Quelle abgerufen, und wie aktuell ist das Ergebnis?#

Es wird nichts vorab abgerufen und nichts gespiegelt. Ein Lesevorgang findet statt, wenn ein Tool ihn anfordert, und zwar gegen die Live-Adresse. Dabei gelten folgende Grenzen:

Code, Lockfiles und Build-Ausgaben werden aus der Auflistung herausgefiltert (node_modules, dist, build, .next, coverage und ähnliche), nicht aus den Lesevorgängen: read_source mit einem Pfad ruft jede Datei ab; der Filter bestimmt nur, was benannt wird, ohne dass danach gefragt wurde.

Die Eingrenzung der Sitemap wird an einer Pfadgrenze abgeglichen, nicht als Zeichenfolgenpräfix. Connect acme.com/docs und /docs-for-fintech bleibt davon ausgenommen. Für einen Abschnitt, unter dem die Sitemap nichts auflistet, wird nur die Einstiegsseite verwendet — niemals die gesamte Website — und das Ergebnis gibt an, welcher der drei Fälle eingetreten ist: Seiten stammen aus der Sitemap, die Website hat eine Sitemap, aber nichts unter Ihrem Abschnitt, oder es gibt überhaupt keine Sitemap. Ein knapper Lesevorgang darf niemals so gelesen werden, als handele es sich um eine knappe Website.

Jeder ausgehende Abruf durchläuft denselben Schutzmechanismus, den auch der übrige Web-Lesevorgang von Docsbook verwendet: robots.txt wird berücksichtigt, Weiterleitungen werden manuell verfolgt und die Adresse bei jedem von höchstens fünf Sprüngen erneut validiert, und private sowie link-lokale Bereiche werden abgelehnt, sodass eine öffentliche URL nicht zu einem Cloud-Metadaten-Endpunkt umgeleitet werden kann. Seiten, die ihren Inhalt mit JavaScript darstellen, werden mit einem Hinweis zurückgegeben, dass kein lesbarer Text gefunden wurde, statt als leere Seite.

Online, pausiert und was der grüne Punkt bedeutet#

Jede verbundene Quelle zeigt einen grünen Punkt und das Wort Online. Eine pausierte Quelle zeigt einen grauen Punkt und Pausiert.

Online bedeutet, dass die Quelle verbunden ist und Ihre Agents sie lesen dürfen. Es ist keine Zustandsprüfung. Niemand sendet eine Anfrage an den Host, und nichts prüft, ob das Repository noch existiert. Das verlässliche Signal ist die Spalte Zuletzt verwendet, die nur aktualisiert wird, wenn ein Tool die Quelle tatsächlich erfolgreich abgerufen hat — ein fehlgeschlagener Abruf aktualisiert sie nie.

Trennen behält die Zeile bei und verhindert, dass irgendetwas sie liest; drücken Sie die Schaltfläche erneut (sie lautet dann Verbinden), um fortzufahren. Entfernen löscht die Verbindung vollständig, einschließlich jeder damit verknüpften GitHub-Autorisierung. Öffnen ruft die Adresse auf. Die beiden Möglichkeiten, das Lesen einer Quelle zu beenden, unterscheiden sich absichtlich: „Das vorerst nicht mehr lesen“ sollte nicht dazu führen, dass Sie die Adresse später erneut eingeben müssen.

Was passiert, wenn eine Quelle nicht gelesen werden kann#

Jeder Fehler ist ein Satz mit einem nächsten Schritt, und keiner davon ist ein leeres Ergebnis:

Diese letzte Zeile ist der Kern des gesamten Designs. Der Fehlerfall, den eine Quelle verhindert, ist keine Fehlermeldung – sondern ein selbstsicherer Absatz über ein Repository, das niemand gelesen hat.

Was kostet das Lesen einer Quelle?#

Die Quellen selbst sind kostenlos zu verbinden und kostenlos aufzubewahren. Zwei der vier Tools werden bei Aufrufen über MCP nach Nutzung abgerechnet und nach den tatsächlichen Kosten ihrer Bereitstellung bepreist:

• list_sources liest Zeilen, die Docsbook bereits speichert, und wird wie ein gewöhnlicher Lesevorgang bepreist.
• read_source verlässt das Docsbook-Netzwerk in Richtung GitHub oder zur Website einer anderen Person — und eine Website-Quelle ruft mehrere Seiten in einem Aufruf ab — daher wird es als ausgehender Aufruf bepreist, in derselben Kategorie wie fetch_url.

Beide Beträge werden vom Guthaben des Projekts abgezogen, auf das sich der Aufruf bezieht. Die Beträge finden Sie auf der Preisseite.

Warum dies der richtige Weg ist (Belege)#

Einschränkungen#

• Eine Quelle wird bei Bedarf gelesen, nicht indiziert. Es gibt keinen Hintergrund-Crawl, keine gespeicherte Kopie und keine Aktualitätsgarantie zwischen den Aufrufen. Was ein Tool gesehen hat, ist das, was die Adresse zu diesem Zeitpunkt ausgeliefert hat.
• Der grüne Punkt ist keine Erreichbarkeitsprüfung. Siehe oben. Ein heute Morgen gelöschtes Repository wird als Online angezeigt, bis jemand versucht, es zu lesen.
• Ein manuell eingegebenes privates Repository wird als öffentlich verbunden und liest nichts. Docsbook kann anhand seiner Adresse nicht zwischen einem privaten und einem nicht vorhandenen Repository unterscheiden. Verwenden Sie die Repository-Auswahl, die dazu in der Lage ist.
• Nur GitHub-Repositories werden als Repositories gelesen. GitLab- und Bitbucket-Zeilen sind vorhanden und bieten keine Verbindung an; eine öffentliche Projektseite auf einer dieser Plattformen kann als Website verbunden werden. Dabei werden die gerenderten Seiten und nicht die Baumstruktur gelesen.
• Eine Website-Quelle ist kein Crawler. Pro Aufruf werden höchstens zehn Seiten gelesen, ausschließlich aus der Sitemap, ohne Rekursion und ohne das Folgen von Links. Eine große Dokumentationswebsite lässt sich besser als Repository verbinden.
• JavaScript-gerenderte Seiten bleiben leer. Der Abrufdienst führt keine Skripte aus. Das Ergebnis weist darauf hin, sodass die Leere niemals als Fehlen von Inhalten gemeldet wird – aber Sie haben dennoch keine Inhalte.
• Notizen sind Anweisungen, und es liegt an Ihnen, sie korrekt zu halten. Alles, was eine Quelle liest, verwendet Ihre Notiz als Orientierung. Eine veraltete Notiz („die v1-API, veraltet“) lenkt einen Agenten genauso effektiv wie eine korrekte.
• Wir veröffentlichen keine Messung darüber, in welchem Umfang Quellen falsche Antworten reduzieren. Der Mechanismus ist oben beschrieben und die Belege dafür stammen aus externen Quellen; eine Vorher-nachher-Zahl über Kundenkorpora haben wir bei Docsbook nicht ermittelt. Betrachten Sie „Quellen verbessern die Genauigkeit für Ihre Dokumentation“ als gut begründete Erwartung, nicht als eine von uns gemessene Kennzahl.

Verwandte Themen#

• KI-Chat — der Assistent auf Ihrer Dokumentationswebsite und die Inhalte, aus denen er möglicherweise Antworten erstellt.
• Antwortqualität — die Pipeline für Abruf und Grounding im vollständigen Überblick.
• Chat-Hooks — die andere Möglichkeit, einem Modell eine Tatsache zu übergeben, die es nicht lesen kann.
• MCP-Server — dieselben Tools für Ihre eigenen Agenten.
• MCP-Tools-Referenz — list_sources, read_source, connect_source, configure_source im vollständigen Überblick.
• Quelle der Wahrheit — eine andere Funktion mit einem ähnlichen Namen: ein lokaler Graph Ihrer eigenen Seiten, der auf dem Rechner des Agenten erstellt wird.
• Preise — worauf ein Quellenaufruf zurückgreift.