Alla fine, una delle tue conversazioni di Claude avrà un ID di collegamento in osFoundry. Scrivi un'attività in osFoundry, apri quella chat di Claude, dici "controlla le tue attività di osFoundry", e Claude prende in carico l'attività, la svolge e rimanda indietro la risposta. osFoundry mostra l'attività che passa da "Waiting for Claude" a "Claimed by host chat" e poi a "Completed", con il risultato sotto. In tutta questa configurazione non compare nessuna chiave API di Anthropic. Il ragionamento arriva dalla conversazione di Claude che paghi già.
Chi fa cosa
| Lato Claude | Lato osFoundry |
|---|---|
| Tiene il tuo accesso a Claude e la conversazione stessa | Tiene il tuo accesso a osFoundry, il workspace e i progetti |
| Accede a osFoundry una sola volta tramite il connettore personalizzato (OAuth) | Rilascia la connessione e decide quali progetti può vedere |
Chiama link_current_chat, read_linked_chat_tasks, claim_linked_chat_task e submit_linked_chat_result quando glielo chiedi |
Salva l'attività, la presa in carico e il risultato, e verifica l'accesso al progetto a ogni chiamata |
| Ragiona, nella conversazione | Mostra lo stato dell'attività e ti permette di annullarla |
| Inizia a lavorare solo quando apri la chat e glielo chiedi | Non apre, non elenca e non legge mai le tue conversazioni di Claude |
È l'ultima riga a determinare tutto il resto. Un server MCP può rispondere alle chiamate degli strumenti. Non può avviare un turno nella conversazione personale di Claude di qualcuno, e Claude non ha un trigger di eventi generico che lo permetta. Quindi il passaggio di consegne è una cassetta della posta: osFoundry ci mette l'attività e la chat di Claude la svuota quando glielo dici tu.
Configurazione
- In osFoundry, fai clic sull'icona della chiave e apri la scheda "Connected". In "Assistant" scegli Claude, inserisci un nome visualizzato (ad esempio "Research assistant") e fai clic su "Add assistant" (aggiungi assistente). Il pannello mostra un "Server address" con un pulsante Copy. Nella build di produzione l'indirizzo è:
https://api.osfoundry.io/api/v1/external-mcp
Esempio: La scheda Connected dopo Add assistant, con l'indirizzo del server e una connessione in sospeso
In Claude, vai in Customize > Connectors, fai clic su "+ Add" e poi su "Add custom connector". Dagli un nome, incolla l'indirizzo del server, fai clic su "Continue" e accedi a osFoundry quando richiesto. Nei piani Team ed Enterprise, prima un proprietario aggiunge il connettore in Organization settings > Connectors, poi i membri fanno clic su "Connect".
Tornato in osFoundry, seleziona la nuova connessione. In "Projects" scegli un progetto e fai clic su "Add to project". Fino a questo passaggio la connessione non vede nulla, ed è voluto: una conversazione di Claude che non fa parte di un progetto non ha attività da prendere in carico né dati da leggere.
Esempio: La connessione aggiunta a un progetto, con la sua chat collegata sotto
- Apri la conversazione di Claude a cui vuoi passare il lavoro. Attiva il connettore per quella conversazione (il pulsante "+" in basso a sinistra, poi "Connectors") e chiedi:
Use osFoundry to link this chat to my project as an agent.
Claude chiama link_current_chat con il progetto e un'etichetta. In osFoundry la chat compare ora in "Linked chats" con la sua etichetta, il nome del progetto, "Project access active" e un "Link ID". Ogni conversazione ha il proprio collegamento, quindi puoi collegare una seconda chat per un tipo di lavoro diverso.
- In osFoundry, fai clic su "Tasks" accanto alla chat collegata. Scrivi il lavoro in "Task for this chat" e fai clic su "Assign task". L'attività mostra "Waiting for Claude", una scadenza a 24 ore e un pulsante "Cancel". La stessa casella è disponibile anche nella pagina dell'agente connesso in Message, sotto "Work with a linked chat" e "Send work to".
Esempio: Un'attività assegnata alla chat collegata, in attesa di Claude
- Apri la chat di Claude e chiedile di controllare le sue attività di chat collegata di osFoundry. Questo è il trigger. Finché non lo fai, in Claude non succede nulla.
Un'esecuzione reale
La trascrizione qui sotto è un esempio. I nomi degli strumenti e i campi degli argomenti sono quelli del connettore; gli ID, il testo dell'attività e la risposta sono illustrativi.
Esempio
Tu: Controlla le tue attività di chat collegata di osFoundry e fai quello che è in attesa.
Claude → read_linked_chat_tasks { "chat_link_id": "5b1e…a07" }
← [ { "id": "c39d…41f", "status": "queued",
"goal": "Leggi la nota di lancio di questo progetto ed elenca
ogni domanda aperta, una per riga." } ]
Claude → claim_linked_chat_task { "chat_link_id": "5b1e…a07", "task_id": "c39d…41f" }
← { "claim_id": "e8a2…9c0", … }
(Claude legge la nota tramite il connettore e scrive l'elenco)
Claude → submit_linked_chat_result { "chat_link_id": "5b1e…a07", "task_id": "c39d…41f",
"claim_id": "e8a2…9c0", "status": "completed",
"result": "1. Chi approva i testi dei prezzi?\n2. …" }
← { "ok": true }
Claude: Fatto. Ho trovato quattro domande aperte nella nota di lancio
e le ho rimandate a osFoundry.
In osFoundry la scheda passa da "Waiting for Claude" a "Claimed by host chat" e poi a "Completed". Espandi "Result" per leggere il testo. Se Claude ha allegato anche un file, "Show returned files" lo elenca con tipo e dimensione.
Due dettagli del contratto degli strumenti sono utili da sapere. Prendere in carico due volte dalla stessa chat restituisce la stessa presa in carico finché l'attività è attiva, quindi un turno di Claude che ritenta non crea un secondo esecutore. E un invio porta con sé l'ID della presa in carico, così una risposta può finire solo sull'attività per cui è stata presa in carico.
Dove passa il confine
osFoundry non vede la tua conversazione di Claude. L'etichetta e il riferimento alla conversazione sono ciò che Claude dichiara al momento del collegamento; il pannello lo dice ("Labels are self reported"). Ciò che Claude riceve è quello che la scheda dell'attività elenca sotto "Shared with this linked chat": il testo dell'attività, più eventuali immagini o azioni dell'editor allegate a quell'attività.
Claude non riceve il tuo workspace. Ogni presa in carico e ogni risultato vengono verificati rispetto alla connessione OAuth e al progetto a cui appartiene il collegamento. Rimuovi la connessione dal progetto e la casella smette di caricare attività per essa; "Unlink" ritira una chat; "Revoke connection" le chiude tutte.
Claude non può eseguire azioni di osFoundry di propria iniziativa. Quando un'attività offre azioni dell'editor, Claude può richiedere solo quelle offerte, e osFoundry le esegue con i permessi e le approvazioni già esistenti.
Il lavoro ha dei limiti. Un'attività contiene fino a 100.000 caratteri, un risultato fino a 20.000, i file restituiti fino a 8 MiB ciascuno e 8 per attività, e un'attività non presa in carico o non completata scade dopo 24 ore. Un'attività annullata non può più essere completata, nemmeno da un turno di Claude che ci stava già lavorando.
E i tempi li decidi tu. Poiché Claude non ha un trigger di eventi per questo, un'attività aspetta finché non apri la chat. Il pannello lo dice chiaramente quando non c'è nessuna sottoscrizione attiva: "Open the host conversation to start each task."
Come passo successivo, prova un'attività che restituisce un file invece di testo, ad esempio un breve brief in Markdown: chiedi a Claude di caricarlo prima dell'invio, poi apri "Show returned files" sulla scheda completata. Per vedere come gli agenti di osFoundry usano gli stessi strumenti all'interno dell'app, consulta gli agenti in osFoundry; il protocollo del connettore in sé è spiegato in cos'è MCP.
Top comments (0)