Claude 如何從 osFoundry 知識庫回答問題,並為每項陳述提供文章依據
So beantwortet Claude Fragen aus deiner osFoundry Knowledge Base und belegt jede Aussage mit dem passenden Artikel
Claude 可透過 osFoundry 的 MCP 連接器或 Claude Code,根據已發佈的知識庫文章回答支援及產品問題,並在每項陳述旁列出文章 ID 和最近更新時間。
Am Ende beantwortet Claude (ein claude.ai-Chat mit dem Connector oder Claude Code in deinem Terminal) Support- und Produktfragen aus einer deiner osFoundry Knowledge Bases. Jede Aussage in der Antwort verweist auf eine Artikel-ID und den Zeitpunkt, zu dem dieser Artikel zuletzt aktualisiert wurde. Am nächsten Tag kann Claude osFoundry fragen, was sich seitdem geändert hat, und dir sagen, welche Antworten von gestern auf einem Artikel beruhen, den inzwischen jemand umgeschrieben hat. Ist ein Artikel selbst falsch, kann Claude ihn korrigieren, aber nur ausgehend von genau der Version, die es gelesen hat, und erst nachdem du den Aufruf erlaubt hast.
Wer macht was
| Claudes Seite | osFoundrys Seite | |
|---|---|---|
| Anmeldung | Dein Claude-Konto oder deine Claude-Code-Installation, unverändert | Eine freigegebene Verbindung zu genau einem Workspace |
| Was durchsucht werden kann | Was der Server zurückgibt | Veröffentlichte Artikel in Knowledge Bases der Projekte, denen die Verbindung hinzugefügt wurde |
| Der Beleg | Claude hält ihn neben jeder Aussage fest | Jedes Lesen liefert die Artikel-ID und den Zeitpunkt der letzten Aktualisierung |
| Aktualität | Claude fragt nach Änderungen seit einer Sequenznummer |
poll_resource_events führt pro Knowledge Base ein geordnetes Log |
| Bearbeiten | Claudes Berechtigungsabfrage vor jedem Schreibvorgang |
expected_version muss passen, und deine Bearbeitungsrechte werden bei jedem Aufruf geprüft |
| Protokoll | Claudes eigenes Transkript | Jeder Aufruf erscheint unter Recent activity der Verbindung |
Einrichtung
1. Claude verbinden
Leg die Verbindung zuerst in osFoundry an: Schlüssel-Symbol → Connected → Assistant: Claude → Add assistant. Kopiere die angezeigte Serveradresse:
https://api.osfoundry.io/api/v1/external-mcp
Füge diese URL in claude.ai als Custom Connector hinzu. In Claude Code fügst du sie über die Shell hinzu und meldest dich dann innerhalb einer Session an:
claude mcp add --transport http osfoundry https://api.osfoundry.io/api/v1/external-mcp
# then, in Claude Code:
/mcp # pick osfoundry → Authenticate
In beiden Fällen öffnet der Browser die Seite "Connect an agent" von osFoundry. Wähle den einen Workspace, setz den Haken bei der Freigabe und verbinde. In Claude Code tauchen die Tools dann als mcp__osfoundry__search_knowledge_base usw. auf.
2. Die Verbindung dem Projekt der Knowledge Base hinzufügen
Eine neue Verbindung sieht nichts. Wähle sie unter Schlüssel-Symbol → Connected aus, such dir unter Projects das Projekt aus und klick auf Add to project.
Beispiel: Der Bereich Projects einer Verbindung, mit einem hinzugefügten Projekt
Liegt die Knowledge Base noch nicht in diesem Projekt, öffne sie, geh im rechten Panel zu Settings und wähle das Projekt im Feld Project. Das Feld speichert direkt bei der Auswahl.
Beispiel Der Settings-Tab der Knowledge Base mit gesetztem Feld Project
3. Die Artikel veröffentlichen, aus denen Claude antworten soll
Wähle einen Artikel aus und öffne im rechten Panel den Tab Publishing. Der Status zeigt Published oder Draft. Klick bei jedem Artikel, den Claude sehen soll, auf Publish Article. Der Hinweis im Panel sagt, was das bedeutet: "Published articles are used by this workspace's AI assistant and search. They are not visible outside the workspace." Veröffentlichte Artikel nutzen also der KI-Assistent und die Suche dieses Workspaces, außerhalb davon sind sie nicht sichtbar. Entwürfe bleiben absichtlich außerhalb von Claudes Reichweite, damit nie ein halb fertiger Artikel zitiert wird.
Beispiel Der Publishing-Tab eines Artikels mit Status: Published und dem Hinweis, dass er nur im Workspace sichtbar ist
4. Die Knowledge-Base-Tools aktiviert lassen
Unter Tools der Verbindung sind diese standardmäßig aktiv, zusammen mit allem anderen:
read search_knowledge_base read_knowledge_article poll_resource_events
write edit_knowledge_article
Beispiel: Die Tools-Checkliste einer Claude-Verbindung, mit angehakten Knowledge-Base-Tools
Soll Claude nur antworten, entferne den Haken bei edit knowledge article und klick auf Save tools. Suchen, Lesen und Polling funktionieren weiter.
5. Im Prompt nach Belegen fragen
Claude belegt zuverlässiger, wenn du sagst, wie ein Beleg aussehen soll:
Answer from the "Support" knowledge base in osFoundry only.
After each claim, add [article_id · updated_at] from read_knowledge_article.
If no published article covers it, say so instead of guessing.
Ein echter Durchlauf
Die Artikel, IDs und Daten unten sind Beispielinhalte. Die Tool-Namen und Argumente sind die, die der Live-Server in tools/list auflistet, so wie Claude Code sie anzeigt.
Example
You: A customer on a monthly plan asks how long they have to request a
refund, and whether SSO users get the same window.
● mcp__osfoundry__list_project_resources
{"project_id": "…", "resource_type": "knowledge_base"}
← "Support" (knowledge base)
● mcp__osfoundry__search_knowledge_base
{"knowledge_base_id": "…", "query": "refund window monthly plan", "limit": 5}
← 5 results, each with article_id and updated time
"Refund policy" updated 2026-11-03 09:41
"SSO and billing owners" updated 2026-10-28 16:02
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"}
← "Refund policy", citation 9c1e… · 2026-11-03T09:41:12.408211Z
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "4b70…"}
← "SSO and billing owners", citation 4b70… · 2026-10-28T16:02:55.019874Z
Claude: Monthly plans can be refunded within 14 days of the charge
[9c1e… · 2026-11-03T09:41:12Z]. SSO doesn't change that: refund
requests go through the billing owner, not the SSO account
[4b70… · 2026-10-28T16:02:55Z].
Am nächsten Morgen, in derselben Unterhaltung:
You: Are any of the answers you gave yesterday out of date?
● mcp__osfoundry__poll_resource_events
{"resource_type": "knowledge_base", "resource_id": "…", "after_sequence": 1182}
← 3 events; one touches 9c1e…
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"}
← "Refund policy", citation 9c1e… · 2026-11-04T08:15:30.112054Z
now says 30 days for monthly plans
Claude: One answer changed. "Refund policy" was updated this morning and
now gives 30 days, not 14 [9c1e… · 2026-11-04T08:15:30Z]. The SSO
part still stands; that article hasn't changed.
You: The FAQ article still says 14 days. Fix it to match.
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "e27a…"}
← "Refund FAQ", version 2026-11-01T10:03:44.250911Z
● mcp__osfoundry__edit_knowledge_article
{"knowledge_base_id": "…", "article_id": "e27a…", "content": "…30 days…",
"expected_version": "2026-11-01T10:03:44.250911Z",
"idempotency_key": "faq-refund-30d"}
[Claude Code asks: allow this tool? → Yes]
← saved, version 2026-11-04T08:22:09.871530Z
Drei Dinge passieren hier, die es in einem normalen Chat nicht gibt.
Der Beleg enthält die Zeit, nicht nur die ID. Die ID allein sagt dir, welchen Artikel Claude verwendet hat. Der Aktualisierungszeitpunkt sagt dir, in welchem Stand. Genau das erlaubt Claude, die Frage "Stimmt das noch?" zu beantworten, ohne jeden jemals zitierten Artikel neu zu lesen.
Polling ist günstig, weil es ein Log ist. Claude musste sich von gestern nur eine Zahl merken, nämlich die letzte Event-Sequenz, die es gesehen hat. Ein einziger poll_resource_events-Aufruf lieferte, was sich seitdem geändert hat, und Claude las nur den Artikel neu, der sich bewegt hatte.
Die Bearbeitung nennt eine Version. edit_knowledge_article ersetzt den Inhalt des Artikels (und seinen Titel, wenn du einen mitgibst) nur, wenn der Artikel noch auf expected_version steht. Claude hat das FAQ Sekunden vor dem Schreiben gelesen, die Version passte also. Hätte jemand das FAQ zwischendurch gespeichert, hätte osFoundry den Schreibvorgang abgelehnt und Claude es neu gelesen. Wer die Version aus einem Beleg von gestern wiederverwendet, wird in der Regel abgelehnt. Ein guter Prompt sagt deshalb "vor dem Bearbeiten neu lesen".
Wo die Grenze liegt
Nur aktuelle, veröffentlichte Artikel sind durchsuchbar. Suchen und Lesen arbeiten beide auf dem Artikel, wie er jetzt ist. Nimmst du einen Artikel aus der Veröffentlichung, verschwindet er beim nächsten Aufruf aus Claudes Ergebnissen, und eine Antwort, die ihn zitiert hat, findet bei der Prüfung nichts mehr. Genau dafür ist das Veröffentlichen ein eigener Schritt: Der Workspace entscheidet, was als Antwort zählt, nicht das Modell.
Nur Knowledge Bases in einem verbundenen Projekt. Claude kann keine Knowledge Base durchsuchen, die der Verbindung nicht freigegeben wurde. Verschiebst du die Knowledge Base in ein anderes Projekt, entfernst das Projekt aus der Verbindung oder klickst auf Revoke connection, scheitert schon der nächste Aufruf. Ein früher ausgestelltes Token hält den Zugang nicht offen.
Eine Bearbeitung ist ein vollständiger Ersatz, doppelt abgesichert. Das Tool nimmt den kompletten Inhalt, also führt osFoundry keine veraltete Kopie mit einer neueren zusammen. Es lehnt sie ab und lässt Claude die Änderung auf dem aktuellen Stand neu machen. Auf Claudes Seite ist das Tool als Schreibvorgang markiert, der geteilte Inhalte ändert (readOnlyHint: false, destructiveHint: true), deshalb hält Claude Code an und fragt. Auf osFoundrys Seite läuft der Aufruf mit den Bearbeitungsrechten der Person, die die Verbindung freigegeben hat. Bearbeitet ein verknüpfter Claude-Chat direkt aus dem Knowledge-Base-Bildschirm von osFoundry heraus, fragt osFoundry bei jedem edit_knowledge_article-Aufruf nach einer Freigabe, und diese Freigabe lässt sich nicht auf den Rest der Session ausweiten.
Jeder Aufruf ist sichtbar. Recent activity der Verbindung listet jeden Tool-Namen, die Entscheidung und die Uhrzeit, sodass du siehst, welche Artikel Claude gelesen hat, bevor es geantwortet hat.
Beispiel Recent activity einer Claude-Verbindung mit den Aufrufen der Knowledge-Base-Tools
Als Nächstes
Nimm zehn echte Fragen, die dein Team letzte Woche beantwortet hat, lass Claude sie mit Belegen aus der Knowledge Base beantworten und behalte die Unterhaltung. Frag morgen, welche Antworten veraltet sind. Die Artikel, die es markiert, sind genau die, die dein Team geändert hat, und die Belege zeigen, aus welcher Version jede Antwort stammt. Was eine Knowledge Base enthält und wie ihre Artikel versioniert werden, steht auf der Seite zur Knowledge Base.
來源:DEV Community · dev.to




