Alla fine, una conversazione di Claude fa la sua ricerca, apre una delle tue Notes di osFoundry, aggiunge una nuova scheda Slides accanto alle presentazioni già presenti, la riempie con una breve presentazione e mette ogni pagina che ha usato nella scheda Sources della Note. Le presentazioni che il tuo team ha già fatto restano com'erano. Le fonti stanno nella Note, non nella chat, così la prossima persona che apre la presentazione può controllare da dove viene ogni numero.

Chi fa cosa

Lato Claude Lato osFoundry
Ricerca La ricerca web e il ragionamento di Claude stesso, nella tua chat di Claude Niente finché Claude non scrive
Quale Note Claude la sceglie tra quelle che il server elenca Solo Notes nei progetti a cui è stata aggiunta la connessione
Quale presentazione Claude deve inviare un ID di scheda esatto list_note_tabs restituisce ogni istanza di scheda, quindi due schede Slides sono due ID
Nuova presentazione Claude invia la scaletta, fino a 20 slide per chiamata create_note_tab aggiunge una scheda Slides e restituisce il suo nuovo ID
Fonti Claude invia un titolo e un URL HTTP o HTTPS add_note_source aggiunge una riga alla scheda Sources
Approvazioni La richiesta di permesso degli strumenti di Claude prima di ogni scrittura I tuoi permessi di modifica attuali sulla Note, verificati a ogni chiamata
Registro La trascrizione della chat Il Recent activity della connessione, una riga per chiamata a strumento

Configurazione

Si dà per scontato che il connettore personalizzato di Claude esista già: icona della chiave → Connected → Add assistant in osFoundry, poi https://api.osfoundry.io/api/v1/external-mcp aggiunto come connettore in Claude, e la connessione aggiunta a un progetto.

1. Metti la Note nel progetto collegato

Apri la Note, apri il pannello di destra e vai su Config → Settings. Se il campo Project mostra "Add to project", scegli il progetto a cui appartiene la connessione di Claude. Una Note che esiste solo su questo dispositivo non ha una copia nel cloud, quindi la connessione non può vederla.

2. Lascia attivi i tre strumenti di scrittura

In icona della chiave → Connected, seleziona la connessione di Claude e guarda Tools. Per questa guida a Claude servono questi:

read list_note_tabs read_note_tab list_note_attachments write create_note_tab edit_note_tab add_note_source

Tutti gli strumenti supportati sono attivi per impostazione predefinita. Se togli la spunta agli strumenti di scrittura e fai clic su Save tools, Claude può ancora leggere la Note e l'elenco delle Sources, ma non può aggiungere una presentazione né una fonte.

3. Nomina la Note, la presentazione e la scheda Sources nel prompt

Claude converte da solo i nomi in ID di scheda, ma chiedergli di creare una nuova scheda, invece di "aggiornare la presentazione", lo tiene lontano dalle presentazioni che ci sono già.

Fai una ricerca su come sono cambiati in questo trimestre i prezzi delle API dei modelli linguistici di grandi dimensioni. Poi, in osFoundry, apri la Note "Q4 pricing research". Leggi prima la scheda Research notes e le Sources già presenti. Aggiungi una NUOVA scheda Slides chiamata "API price cuts" con circa cinque slide, chiudila con una slide Sources e aggiungi alla scheda Sources della Note ogni pagina su cui ti sei basato. Non toccare le presentazioni Pricing e Launch status.

Un'esecuzione reale

La Note, le pagine e la risposta di Claude sono dati di esempio. I nomi degli strumenti e degli argomenti sono quelli che il server in produzione elenca in tools/list. In Claude Code, gli stessi strumenti compaiono come mcp__osfoundry__create_note_tab e così via.

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" è una nuova scheda Slides in Q4 pricing research, sei slide compresa una slide finale Sources. Le tre pagine che ho usato sono nella scheda Sources, ognuna con una nota sulla slide che supporta. Pricing e Launch status non sono stati modificati.

La barra delle schede della Note con le due presentazioni esistenti e la nuova presentazione API price cuts aperta

Esempio: La barra delle schede della Note con le due presentazioni esistenti e la nuova presentazione API price cuts aperta

Nella Note c'erano già due presentazioni, entrambe di tipo slides. Se Claude avesse chiesto "la scheda slides", non ci sarebbe stata una risposta giusta. list_note_tabs restituisce un ID per istanza, create_note_tab restituisce l'ID della scheda che ha creato, e ogni modifica successiva indica quell'ID. Per questo la slide finale è finita nella nuova presentazione e non in Pricing, che è la prima della barra.

La scaletta è partita con la chiamata di creazione. Una sola scrittura ha creato la scheda e le sue cinque slide. La slide Sources è arrivata dopo, come modifica alla presentazione ormai esistente. slide_add aggiunge una slide alla presentazione a cui punta e il suo schema non ha un campo di posizione, quindi se l'ordine conta, metti le slide nella scaletta.

La scheda Sources dopo l'esecuzione, con le tre pagine aggiunte da Claude sotto quella già presente

Esempio: La scheda Sources dopo l'esecuzione, con le tre pagine aggiunte da Claude sotto quella già presente

Ogni fonte è una riga della scheda Sources con un titolo, il link, il nome host e la descrizione di una riga scritta da Claude. Lì puoi aprirle, modificarle, aggiornarle o rimuoverle come qualsiasi fonte aggiunta da una persona. Passando il mouse su una riga, il pulsante di copia ti dà un link diretto a quel record della fonte, che puoi incollare nel testo di una slide.

Recent activity della connessione di Claude, una riga per chiamata a strumento

Esempio: Recent activity della connessione di Claude, una riga per chiamata a strumento

Il Recent activity della connessione, in icona della chiave → Connected, elenca ogni chiamata con la sua decisione e l'ora, così vedi cosa ha fatto Claude nella Note senza leggere la chat.

Dov'è il limite

La ricerca resta dal lato di Claude. osFoundry non vede le ricerche di Claude né le pagine che ha letto. Riceve solo ciò che Claude sceglie di scrivere: le slide e, per ogni fonte, un titolo, un URL e una descrizione. Se un'affermazione su una slide non ha una riga in Sources, lo si vede nella Note, ed è proprio questo il motivo per chiedere lì le fonti.

Claude può aggiungere una presentazione, non prenderne il controllo. create_note_tab crea solo nuove schede Slides o Sheet, quindi una scaletta non può sovrascrivere una presentazione fatta da qualcun altro. slide_add e slides_add_outline lavorano sull'unica presentazione di cui Claude indica l'ID, e ogni scrittura porta con sé la versione della Note che Claude ha letto per ultima: se nel frattempo una persona ha modificato la presentazione, la scrittura viene rifiutata finché Claude non rilegge.

Le fonti entrano, i file restano chiusi. add_note_source accetta solo link HTTP e HTTPS. list_note_attachments elenca Files e Sources come metadati, al massimo 50 per pagina, senza contenuto dei file e senza link di download. Un link di download incollato in una chat potrebbe essere inoltrato ovunque e continuerebbe a funzionare dopo aver revocato la connessione. Modificare o rimuovere fonti e file resta compito delle persone nell'app desktop, perché edit_note_tab non tocca né le une né gli altri.

Le slide da un connettore sono semplici. Ogni slide della scaletta ha un titolo, un corpo e le note del relatore. Temi, immagini e layout spettano a chi apre poi la presentazione in osFoundry.

I nuovi tentativi sono sicuri. Ogni scrittura porta una idempotency_key. Se la risposta a Claude va persa e lui richiama con la stessa chiave, osFoundry restituisce il primo risultato, così ottieni una sola scheda "API price cuts" e una riga per fonte, non due.

L'accesso finisce alla chiamata successiva, appena lo cambi. Sposta la Note fuori dal progetto, rimuovi il progetto dalla connessione o fai clic su Revoke connection, e la lettura successiva di Claude viene rifiutata.

Prossimo passo

Chiedi a Claude di leggere la presentazione Pricing con read_note_tab, confrontarla con la nuova presentazione API price cuts e aggiungere le sue correzioni come terza scheda Slides con le sue fonti, così l'originale resta intatto per la revisione. Cosa contiene la scheda Sources e come una persona ci aggiunge qualcosa a mano è spiegato nella pagina della scheda Sources, mentre l'editor delle presentazioni è nella pagina di Note Slides.