DEV Community

Cover image for Wie Claude seine Recherche in deiner osFoundry Note zu einem Foliensatz macht
BBT for BBT Deutsch

Posted on

Wie Claude seine Recherche in deiner osFoundry Note zu einem Foliensatz macht

Am Ende recherchiert eine Claude-Unterhaltung selbst, öffnet eine deiner osFoundry Notes, legt neben den vorhandenen Foliensätzen einen neuen Slides-Tab an, füllt ihn mit einem kurzen Foliensatz und trägt jede Seite, die es verwendet hat, in den Sources-Tab der Note ein. Die Foliensätze, die dein Team schon gebaut hat, bleiben unverändert. Die Quellen stehen in der Note statt im Chat, sodass die nächste Person, die den Foliensatz öffnet, nachprüfen kann, woher jede Zahl kommt.

Wer macht was

Claudes Seite osFoundrys Seite
Recherche Claudes eigene Websuche und Überlegungen, in deinem Claude-Chat Nichts, bis Claude schreibt
Welche Note Claude wählt sie aus dem, was der Server auflistet Nur Notes in Projekten, zu denen die Verbindung hinzugefügt wurde
Welcher Foliensatz Claude muss eine exakte Tab-ID senden list_note_tabs liefert jede Tab-Instanz, zwei Slides-Tabs sind also zwei IDs
Neuer Foliensatz Claude sendet die Gliederung, bis zu 20 Folien pro Aufruf create_note_tab legt einen Slides-Tab an und liefert seine neue ID
Quellen Claude sendet einen Titel und eine HTTP- oder HTTPS-URL add_note_source fügt dem Sources-Tab eine Zeile hinzu
Freigaben Claudes Tool-Berechtigungsabfrage vor jedem Schreibvorgang Deine aktuellen Bearbeitungsrechte an der Note, bei jedem Aufruf geprüft
Protokoll Das Chat-Transkript Die Recent activity der Verbindung, eine Zeile pro Tool-Aufruf

Einrichtung

Vorausgesetzt ist, dass der benutzerdefinierte Claude-Connector schon existiert: Schlüssel-Symbol → Connected → Add assistant in osFoundry, dann https://api.osfoundry.io/api/v1/external-mcp als Connector in Claude hinzugefügt und die Verbindung einem Projekt zugeordnet.

1. Die Note ins verbundene Projekt legen

Öffne die Note, öffne das rechte Seitenpanel und geh zu Config → Settings. Wenn das Feld Project "Add to project" zeigt, wähle das Projekt, zu dem die Claude-Verbindung gehört. Eine Note, die nur auf diesem Gerät existiert, hat keine Cloud-Kopie, also kann die Verbindung sie nicht sehen.

2. Die drei Schreib-Tools aktiviert lassen

Wähle unter Schlüssel-Symbol → Connected die Claude-Verbindung aus und sieh dir Tools an. Für diese Anleitung braucht Claude diese hier:

read   list_note_tabs   read_note_tab   list_note_attachments
write  create_note_tab  edit_note_tab   add_note_source
Enter fullscreen mode Exit fullscreen mode

Alle unterstützten Tools sind standardmäßig aktiv. Wenn du die Schreib-Tools abwählst und auf Save tools klickst, kann Claude die Note und die Sources-Liste weiterhin lesen, aber keinen Foliensatz und keine Quelle hinzufügen.

3. Note, Foliensatz und Sources-Tab im Prompt nennen

Claude löst Namen selbst in Tab-IDs auf. Wenn du ausdrücklich einen neuen Tab verlangst statt "aktualisiere den Foliensatz", bleibt Claude von den vorhandenen Foliensätzen fern.

Recherchiere, wie sich die API-Preise für große Sprachmodelle in diesem Quartal verändert haben.
Öffne dann in osFoundry die Note "Q4 pricing research". Lies zuerst den Tab
Research notes und die vorhandenen Sources. Lege einen NEUEN Slides-Tab namens
"API price cuts" mit etwa fünf Folien an, schließ ihn mit einer Sources-Folie ab und
trag jede Seite, auf die du dich gestützt hast, in den Sources-Tab der Note ein. Lass die
Foliensätze Pricing und Launch status unangetastet.
Enter fullscreen mode Exit fullscreen mode

Ein echter Durchlauf

Die Note, die Seiten und Claudes Antwort sind Beispieldaten. Die Tool- und Argumentnamen sind die, die der Live-Server in tools/list auflistet. In Claude Code erscheinen dieselben Tools als mcp__osfoundry__create_note_tab usw.

Example

[Claude runs its own web searches and reads three pages]

Claude → list_note_tabs {"note_id": "…"}
       ← version "…12:41.118Z"
         Research notes (markdown)  id "markdown"
         Pricing        (slides)    id "slides-3-mh1q…"
         Launch status  (slides)    id "slides-5-mh4c…"
         … plus Files and Sources
Claude → read_note_tab {"note_id": "…", "tab_id": "markdown"}
       ← the team's notes, 1,240 characters
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
       ← 1 source: "Vendor pricing page (Q3 snapshot)"
Claude → create_note_tab {"note_id": "…", "tab_type": "slides",
                          "label": "API price cuts",
                          "slides": [{"title": "API prices this quarter", "body": "…"},
                                     {"title": "Who cut, by how much", "body": "…"},
                                     {"title": "Cached input pricing", "body": "…"},
                                     {"title": "What it means for our plan", "body": "…",
                                      "notes": "Pause here for questions"},
                                     {"title": "Open questions", "body": "…"}],
                          "expected_version": "…12:41.118Z",
                          "idempotency_key": "deck-api-price-cuts"}
       [Claude asks you to allow this tool call → Allow]
       ← tab ID "slides-9-mh8z…"
Claude → read_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…"}
       ← 5 slides, version "…13:02.540Z"
Claude → edit_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…",
                        "operation": "slide_add", "title": "Sources",
                        "body": "Three pages, listed in the Sources tab",
                        "expected_version": "…13:02.540Z",
                        "idempotency_key": "deck-api-price-cuts-sources-slide"}
       ← saved, 6 slides
Claude → list_note_tabs → add_note_source {"title": "…", "url": "https://…",
                                           "description": "Price table, used on slide 2",
                                           "expected_version": "…",
                                           "idempotency_key": "src-…"}
       (three times, one page each, a fresh version before each)
       ← source IDs
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
       ← 4 sources

Claude: "API price cuts" ist ein neuer Slides-Tab in Q4 pricing research,
        sechs Folien einschließlich einer abschließenden Sources-Folie. Die drei
        Seiten, die ich verwendet habe, stehen im Sources-Tab, jeweils mit einem
        Hinweis, welche Folie sie stützen. Pricing und Launch status wurden nicht geändert.
Enter fullscreen mode Exit fullscreen mode

Die Tab-Leiste der Note mit den zwei vorhandenen Foliensätzen und dem neuen, geöffneten Foliensatz API price cuts

Beispiel: Die Tab-Leiste der Note mit den zwei vorhandenen Foliensätzen und dem neuen, geöffneten Foliensatz API price cuts

In der Note lagen schon zwei Foliensätze, beide vom Typ slides. Hätte Claude nach "dem Slides-Tab" gefragt, hätte es keine richtige Antwort gegeben. list_note_tabs liefert eine ID pro Instanz, create_note_tab gibt die ID des angelegten Tabs zurück, und jede spätere Bearbeitung nennt genau diese ID. Deshalb ist die Abschlussfolie im neuen Foliensatz gelandet und nicht in Pricing, das in der Leiste ganz vorn steht.

Die Gliederung ging mit dem Create-Aufruf mit. Ein einziger Schreibvorgang hat den Tab und seine fünf Folien angelegt. Die Sources-Folie kam danach, als Bearbeitung des nun vorhandenen Foliensatzes. slide_add fügt dem Foliensatz, auf den es zeigt, eine Folie hinzu, und sein Schema hat kein Positionsfeld. Wenn die Reihenfolge wichtig ist, gehören die Folien also in die Gliederung.

Der Sources-Tab nach dem Durchlauf, mit den drei von Claude hinzugefügten Seiten unter der vorhandenen

Beispiel: Der Sources-Tab nach dem Durchlauf, mit den drei von Claude hinzugefügten Seiten unter der vorhandenen

Jede Quelle ist eine Zeile im Sources-Tab mit Titel, Link, Hostname und Claudes einzeiliger Beschreibung. Du kannst sie dort öffnen, bearbeiten, aktualisieren oder entfernen wie jede Quelle, die eine Person hinzugefügt hat. Fährst du mit der Maus über eine Zeile, liefert der Kopier-Button einen direkten Link zu diesem Quelleneintrag, den du in den Text einer Folie einfügen kannst.

Recent activity der Claude-Verbindung, eine Zeile pro Tool-Aufruf

Beispiel: Recent activity der Claude-Verbindung, eine Zeile pro Tool-Aufruf

Die Recent activity der Verbindung unter Schlüssel-Symbol → Connected listet jeden Aufruf mit Entscheidung und Uhrzeit. So siehst du, was Claude in der Note getan hat, ohne den Chat zu lesen.

Wo die Grenze liegt

Die Recherche bleibt auf Claudes Seite. osFoundry sieht weder Claudes Suchen noch die Seiten, die es gelesen hat. Es bekommt nur, was Claude zu schreiben beschließt: die Folien sowie Titel, URL und Beschreibung pro Quelle. Hat eine Aussage auf einer Folie keine Zeile in Sources, sieht man das in der Note, und genau darum geht es, wenn man die Quellen dort verlangt.

Claude kann einen Foliensatz hinzufügen, aber keinen übernehmen. create_note_tab legt nur neue Slides- oder Sheet-Tabs an, eine Gliederung kann also keinen Foliensatz überschreiben, den jemand anders gebaut hat. slide_add und slides_add_outline arbeiten auf dem einen Foliensatz, dessen ID Claude nennt, und jeder Schreibvorgang trägt die Note-Version, die Claude zuletzt gelesen hat. Hat eine Person den Foliensatz zwischendurch geändert, wird der Schreibvorgang abgewiesen, bis Claude neu liest.

Quellen kommen rein, Dateien bleiben zu. add_note_source nimmt nur HTTP- und HTTPS-Links an. list_note_attachments listet Files und Sources als Metadaten, höchstens 50 pro Seite, ohne Dateiinhalt und ohne Download-Links. Ein in einen Chat eingefügter Download-Link ließe sich überallhin weiterleiten und würde auch nach dem Widerruf der Verbindung noch funktionieren. Quellen und Dateien bearbeiten oder entfernen bleibt den Menschen in der Desktop-App überlassen, denn edit_note_tab fasst beides nicht an.

Folien aus einem Connector sind schlicht. Jede Folie der Gliederung hat einen Titel, einen Textteil und Sprechernotizen. Themes, Bilder und Layout sind Sache der Person, die den Foliensatz danach in osFoundry öffnet.

Wiederholungen sind sicher. Jeder Schreibvorgang trägt einen idempotency_key. Geht Claudes Antwort verloren und ruft es mit demselben Key erneut auf, liefert osFoundry das erste Ergebnis. Du bekommst also einen Tab "API price cuts" und eine Zeile pro Quelle, nicht zwei.

Der Zugriff endet beim nächsten Aufruf, sobald du ihn änderst. Nimm die Note aus dem Projekt, entferne das Projekt aus der Verbindung oder klick auf Revoke connection, und Claudes nächster Lesezugriff wird abgewiesen.

Wie es weitergeht

Lass Claude den Foliensatz Pricing mit read_note_tab lesen, ihn mit dem neuen Foliensatz API price cuts vergleichen und seine Korrekturen als dritten Slides-Tab mit eigenen Quellen hinzufügen, damit das Original für die Prüfung unangetastet bleibt. Was der Sources-Tab enthält und wie eine Person von Hand etwas hinzufügt, steht auf der Seite zum Sources-Tab, und der Folieneditor selbst auf der Seite zu Note Slides.

Top comments (0)