Alla fine di questa guida, Claude (una chat di claude.ai con il connettore, oppure Claude Code nel tuo terminale) risponde a domande di supporto e di prodotto partendo da una delle tue knowledge base di osFoundry. Ogni affermazione della risposta rimanda a un ID di articolo e all'ora in cui quell'articolo è stato aggiornato l'ultima volta. Il giorno dopo, Claude può chiedere a osFoundry cosa è cambiato da allora e dirti quali risposte di ieri si basano su un articolo che nel frattempo qualcuno ha riscritto. Quando è l'articolo stesso a essere sbagliato, Claude può correggerlo, ma solo a partire dalla versione esatta che ha letto e solo dopo che hai autorizzato la chiamata.
Chi fa cosa
| Lato Claude | Lato osFoundry | |
|---|---|---|
| Accesso | Il tuo account Claude o la tua installazione di Claude Code, invariati | Una connessione approvata verso un solo workspace |
| Cosa può cercare | Quello che restituisce il server | Gli articoli pubblicati nelle knowledge base dei progetti a cui è stata aggiunta la connessione |
| La citazione | Claude la tiene accanto a ogni affermazione | Ogni lettura restituisce l'ID dell'articolo e l'ora del suo ultimo aggiornamento |
| Aggiornamento | Claude chiede le modifiche a partire da un numero di sequenza | poll_resource_events mantiene un log ordinato per ogni knowledge base |
| Modifica | La richiesta di permesso di Claude prima di ogni scrittura | expected_version deve corrispondere, e i tuoi permessi di modifica vengono controllati a ogni chiamata |
| Registro | La trascrizione di Claude | Ogni chiamata compare in Recent activity della connessione |
Configurazione
1. Collega Claude
Crea prima la connessione in osFoundry: icona della chiave → Connected → Assistant: Claude → Add assistant. Copia l'indirizzo del server che viene mostrato:
https://api.osfoundry.io/api/v1/external-mcp In claude.ai aggiungi quell'URL come connettore personalizzato. In Claude Code aggiungilo dalla shell e autenticati dall'interno di una sessione:
claude mcp add --transport http osfoundry https://api.osfoundry.io/api/v1/external-mcp # then, in Claude Code: /mcp # pick osfoundry → Authenticate In entrambi i casi il browser apre la pagina "Connect an agent" di osFoundry. Scegli il workspace, spunta la casella di approvazione e collega. In Claude Code gli strumenti compaiono poi come mcp__osfoundry__search_knowledge_base e così via.
2. Aggiungi la connessione al progetto della knowledge base
Una connessione nuova non vede niente. In icona della chiave → Connected selezionala, scegli il progetto sotto Projects e fai clic su Add to project.
Esempio: La sezione Projects di una connessione, con un progetto aggiunto
Se la knowledge base non è ancora in quel progetto, aprila, vai nel pannello a destra → Settings e scegli il progetto nel campo Project. Il campo si salva appena selezioni.
Esempio: La scheda Settings della knowledge base con il campo Project impostato
3. Pubblica gli articoli da cui Claude deve rispondere
Seleziona un articolo e apri la scheda Publishing nel pannello a destra. Lo stato indica Published o Draft. Fai clic su Publish Article per ogni articolo che Claude deve vedere. La nota del pannello spiega cosa significa: "Published articles are used by this workspace's AI assistant and search. They are not visible outside the workspace." In pratica gli articoli pubblicati vengono usati dall'assistente AI e dalla ricerca del workspace, ma non sono visibili al di fuori. Le bozze restano di proposito fuori dalla portata di Claude, così un articolo scritto a metà non finisce mai citato.
Esempio: La scheda Publishing di un articolo con Status: Published e la nota che è visibile solo nel workspace
4. Lascia attivi gli strumenti della knowledge base
In Tools della connessione questi sono attivi di default, insieme a tutto il resto:
read search_knowledge_base read_knowledge_article poll_resource_events write edit_knowledge_article 
Esempio: La checklist Tools di una connessione Claude, con gli strumenti della knowledge base spuntati
Se vuoi solo risposte, togli la spunta a edit knowledge article e fai clic su Save tools. Ricerca, lettura e polling continuano a funzionare.
5. Chiedi le citazioni nel prompt
Claude cita in modo più affidabile quando gli dici com'è fatta una citazione:
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. Un'esecuzione reale
Gli articoli, gli ID e le date qui sotto sono contenuti di esempio. I nomi degli strumenti e gli argomenti sono quelli che il server reale elenca in tools/list, così come li mostra Claude Code.
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]. La mattina dopo, nella stessa conversazione:
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 Qui succedono tre cose che in una chat normale non capitano.
La citazione porta l'ora, non solo l'ID. L'ID da solo ti dice quale articolo ha usato Claude. L'ora di aggiornamento ti dice in quale stato. È questo che permette a Claude di rispondere a "è ancora vero?" senza rileggere tutti gli articoli che ha mai citato.
Il polling costa poco perché è un log. Claude doveva ricordarsi un solo numero da ieri, l'ultima sequenza di eventi che aveva visto. Una sola chiamata a poll_resource_events ha restituito cosa era cambiato da allora, e Claude ha riletto solo l'articolo che si era mosso.
La modifica indica una versione. edit_knowledge_article sostituisce il contenuto dell'articolo (e il titolo, se ne passi uno) solo se l'articolo è ancora a expected_version. Claude ha letto le FAQ pochi secondi prima di scrivere, quindi la versione corrispondeva. Se qualcuno avesse salvato le FAQ nel frattempo, osFoundry avrebbe rifiutato la scrittura e Claude le avrebbe rilette. Riutilizzare la versione di una citazione di ieri è il modo tipico per farsi rifiutare, quindi un buon prompt dice "rileggi prima di modificare".
Dov'è il limite
Si possono cercare solo articoli attuali e pubblicati. Ricerca e lettura lavorano entrambe sull'articolo così com'è adesso. Se ritiri la pubblicazione di un articolo, sparisce dai risultati di Claude alla chiamata successiva, e una risposta che lo citava non troverà nulla quando controlla. È proprio questo il senso di avere la pubblicazione come passaggio: è il workspace a decidere cosa conta come risposta, non il modello.
Solo knowledge base di un progetto collegato. Claude non può cercare in una knowledge base che non è stata data alla connessione, e spostare la knowledge base in un altro progetto, rimuovere il progetto dalla connessione o fare clic su Revoke connection blocca la chiamata successiva. Un token ottenuto prima non tiene aperto l'accesso.
Una modifica è una sostituzione completa, protetta due volte. Lo strumento riceve il contenuto intero, quindi osFoundry non unisce una copia vecchia a una più recente. La rifiuta e lascia che Claude rifaccia la modifica partendo da quello che c'è adesso. Lato Claude, lo strumento è marcato come una scrittura che modifica contenuti condivisi (readOnlyHint: false, destructiveHint: true), ed è per questo che Claude Code si ferma a chiedere. Lato osFoundry, la chiamata viene eseguita con i permessi di modifica della persona che ha approvato la connessione. Se una chat di Claude collegata modifica direttamente dalla schermata Knowledge Base di osFoundry, osFoundry chiede l'approvazione a ogni chiamata edit_knowledge_article, e quell'approvazione non si può estendere al resto della sessione.
Ogni chiamata è visibile. Recent activity della connessione elenca il nome di ogni strumento, la decisione e l'ora, così puoi vedere quali articoli ha letto Claude prima di rispondere.
Esempio: Recent activity di una connessione Claude con le chiamate agli strumenti della knowledge base
Prossimo passo
Prendi dieci domande reali a cui il tuo team ha risposto la settimana scorsa, chiedi a Claude di rispondere dalla knowledge base con le citazioni e conserva la conversazione. Domani chiedigli quali risposte non sono più aggiornate. Gli articoli che segnala sono quelli che il tuo team ha cambiato, e le citazioni mostrano esattamente da quale versione viene ogni risposta. Cosa contiene una knowledge base e come vengono versionati i suoi articoli è spiegato nella pagina della Knowledge Base.
