Alla fine, una normale conversazione di Claude su claude.ai potrà aprire le Notes, le knowledge base e i Records di uno dei tuoi progetti osFoundry, rispondere a partire da questi contenuti e pubblicare nel canale di discussione di quel progetto. Con la tua approvazione potrà anche modificarli. Resti connesso a Claude come al solito. A ogni chiamata di uno strumento, osFoundry decide cosa può toccare quella chat, e ogni chiamata viene elencata in osFoundry nel Recent activity della connessione. ChatGPT si collega allo stesso modo, con lo stesso indirizzo del server.
Chi fa cosa
| Lato Claude | Lato osFoundry | |
|---|---|---|
| Login | Il tuo account Claude, invariato | Il tuo account osFoundry approva la connessione una volta, per un workspace |
| Cosa esegue il modello | Claude, nella chat che usi già | Niente. Su questo percorso non ci sono modelli né chiavi di provider |
| Dove girano gli strumenti | Claude invia la chiamata allo strumento | api.osfoundry.io la esegue e prima controlla l'accesso |
| Cosa può raggiungere | Quello che il server restituisce | I progetti a cui hai aggiunto la connessione, più i canali in cui l'hai invitata |
| Approvazioni | La richiesta di permesso per gli strumenti di Claude | Le modifiche a GitNest e Room attendono in "Needs your approval" |
| Dove restano i dati | La risposta resta nella tua chat di Claude | Notes, record e articoli restano in osFoundry. Gli elementi solo locali non lasciano mai il dispositivo |
Configurazione
1. Crea la connessione in osFoundry
In osFoundry, clicca sull'icona della chiave nell'header e apri la scheda Connected. Il pannello si intitola "Connected agents" e mostra in quale workspace ti trovi. Sotto "Connect in three steps":
- Assistant: scegli Claude
- Display name: un nome che riconoscerai in seguito, ad es.
Claude research - Clicca su Add assistant (aggiungi assistente)
La nuova connessione mostra "Setup pending. This assistant cannot read or change anything yet." Copia la Server address con il pulsante Copy accanto:
https://api.osfoundry.io/api/v1/external-mcp 
Esempio: La scheda Connected dopo Add assistant, con l'indirizzo del server e una connessione in attesa
2. Aggiungila a Claude come connettore personalizzato
In Claude, apri Customize → Connectors e aggiungi un connettore personalizzato con quell'URL. Con un piano Team o Enterprise, prima un owner dell'organizzazione lo aggiunge in Organization settings → Connectors, poi ogni membro si collega. I passaggi di Anthropic per i connettori MCP remoti sono nella guida ai connettori personalizzati di Claude.
Quando clicchi su Connect, Claude trova da solo l'accesso di osFoundry. Non devi incollare né un client ID né una chiave.
3. Approva un workspace
Il browser arriva su https://osfoundry.io/external-assistant-authorize, una pagina intitolata "Connect an agent". Mostra il client dell'assistente e l'host a cui ritorna, poi chiede:
- Workspace to connect: un solo workspace. Un secondo workspace richiede una connessione a parte.
- Requested capabilities, in parole semplici: "Read supported resources in projects you add", "Change supported resources where you have edit access", "Run sessions where you grant a runner role".
- Connection: scegli "Use pending: Claude research" per agganciarla alla connessione del passaggio 1, oppure lascia "Create a new connection".
- Spunta "I approve connecting this assistant to ", poi Connect.
Vieni rimandato a Claude. La connessione è attiva ma non vede ancora niente. Una connessione nuova parte con zero progetti.
4. Aggiungila a un progetto
Torna su icona della chiave → Connected e seleziona la connessione. Ora dice "Connected." In Projects, scegli un progetto e clicca su Add to project.
Esempio: La connessione aggiunta a un progetto, con la chat collegata sotto
Così ottiene accesso ai contenuti sincronizzati supportati di quel progetto: Notes, knowledge base, canali Record, Room cloud, i repository GitNest assegnati al progetto e il canale di discussione del progetto. Anche i contenuti che aggiungi al progetto in seguito sono inclusi. I normali canali Message sono separati. Usa Message channels → Choose a Message channel → Invite per ogni canale in cui la chat deve leggere e rispondere.
La sezione Tools dice "All supported tools are on by default." Togli la spunta a quelli che non vuoi dare a questa connessione e clicca su Save tools.
Esempio: La checklist Tools di una connessione Claude, tutti attivi di default
5. Attivala nella chat
In una conversazione di Claude, apri il menu + → Connectors e attiva il connettore osFoundry. Poi chiedi in linguaggio normale.
Un'esecuzione reale
Il prompt e la risposta qui sotto sono contenuti di esempio da un progetto demo. I nomi degli strumenti e degli argomenti sono quelli che il server in produzione dichiara in tools/list. In claude.ai le chiamate compaiono sotto il nome del connettore. Se aggiungi lo stesso URL a Claude Code come osfoundry, gli stessi strumenti compaiono come mcp__osfoundry__list_project_resources e così via.
Esempio Tu: Usando osFoundry, cosa è ancora aperto nella checklist del lancio Q3? Controlla se la KB del supporto contraddice qualcosa, poi segna il record "pricing page" come Ready. Claude → list_granted_resources {} ← 1 progetto collegato: "Launch Q3" (workspace) Claude → list_project_resources {"project_id": "…", "resource_type": "note", "search": "checklist"} ← Note "Q3 launch checklist" Claude → list_note_tabs {"note_id": "…"} ← schede: Note (testo), Sheet "Owners" Claude → read_note_tab {"note_id": "…", "tab_id": "…"} ← 9 voci, 3 non spuntate Claude → search_knowledge_base {"knowledge_base_id": "…", "query": "refund window"} ← articolo "Refund policy" (aggiornato 2 giorni fa) Claude → read_record_item {"record_channel_id": "…", "item_id": "…"} ← "pricing page", status Draft, version … Claude → edit_record_item {"record_channel_id": "…", "item_id": "…", "values": {"status": "Ready"}, "expected_version": "…", "idempotency_key": "…"} [Claude ti chiede di consentire questa chiamata → Allow] ← salvato, nuova version … Claude: Sono aperte tre voci: la data di embargo per la stampa, la traduzione delle FAQ e la riga sui rimborsi della pricing page. La checklist dice 14 giorni; l'articolo della KB "Refund policy" dice 30. Ho segnato il record della pricing page come Ready. Due dettagli di questa trascrizione sono voluti. edit_record_item richiede la version restituita da read_record_item, quindi un record cambiato nel frattempo viene rifiutato invece di essere sovrascritto. Un idempotency_key ripetuto restituisce il primo risultato, quindi una chiamata ritentata non scrive due volte.
Dov'è il confine
osFoundry non può aprire le tue chat di Claude. La connessione MCP permette a Claude di chiamare gli strumenti di osFoundry quando decide di farlo. osFoundry non ha nessuna API nella direzione opposta per elencare, leggere o avviare una conversazione personale. Lo strumento che collega una chat a un progetto (link_current_chat) riceve un'etichetta che la chat dichiara su se stessa, e osFoundry la tratta come un'indicazione di instradamento, non come un'identità verificata. Per lo stesso motivo Claude non riceve notifiche in background da osFoundry. Agisce quando apri la conversazione e chiedi.
I dati solo locali restano in locale. Lo dice il server stesso nella sua risposta a initialize: "Local-only data is unavailable to cloud clients." Le Room locali, le sessioni Graph locali e i contenuti mai sincronizzati non sono visibili alla connessione. La condivisione delle sessioni Graph del desktop è un interruttore separato nella stessa scheda, e l'app desktop deve essere aperta e con l'accesso effettuato.
L'accesso viene controllato a ogni chiamata, non a ogni login. Ogni chiamata viene verificata rispetto allo stato della connessione, al suo workspace, ai membri attuali del progetto, al progetto in cui si trova l'elemento in quel momento e al tuo ruolo su quell'elemento. Sposta una Note in un altro progetto, rimuovi il progetto o clicca su Revoke connection, e la chiamata successiva viene rifiutata. Le modifiche richiedono anche che tu, la persona che ha approvato la connessione, abbia ancora i permessi di modifica.
Alcune scritture diventano proposte. Il lavoro su GitNest, i change set, le importazioni di file, le pull request e le installazioni di app nelle Room passano dagli strumenti propose_…. Restano in attesa nella scheda Connected in "Needs your approval", dove vedi il repository o la Room di destinazione e i file prima di scegliere Approve o Decline. Claude non riceve mai il tuo token del provider Git né alcun valore segreto.
I canali Message richiedono un invito. Far parte di un progetto apre solo il canale di discussione di quel progetto. Ogni altro canale richiede un Invite esplicito, e per un canale privato serve l'invito del suo owner.
Prossimo passo
Aggiungi una knowledge base allo stesso progetto e fai a Claude una domanda a cui di solito risponderesti consultandola, ad es. "Cosa dice la nostra KB sui rimborsi, con il nome dell'articolo?". search_knowledge_base restituisce l'ID dell'articolo e quando è stato aggiornato l'ultima volta, così puoi verificare la fonte. Come sono organizzate le knowledge base di osFoundry è spiegato nella pagina delle knowledge base.
