跳到正文
DEV Community· BBT·· 11 天前AI 評分51

Claude Code 如何在 osFoundry Room 中經批准後新增小型應用

Come far aggiungere a Claude Code una piccola app in una Room di osFoundry dopo la tua approvazione

AI 導讀

指南示範如何將 Claude Code 連接至 osFoundry,讓它編寫小型應用並提交至雲端 Room,待用戶審批後才新增應用分頁。Room 必須是雲端 Room 並屬於某個項目,而 Claude Code 的連接也須加入同一項目;用戶檢視完整原始碼並按「Approve and create」後,應用才會出現在 Room 分頁列。

正文

Alla fine di questa guida, Claude Code scrive un piccolo strumento interno sulla tua macchina (qui un timer per lo standup: una lista di nomi, 90 secondi a testa, un pulsante Next) e lo propone a una Room cloud in osFoundry. Nella Room, per ora, non compare niente. Apri la proposta, leggi entrambi i file sorgente e clicchi su Approve and create. A quel punto il timer compare nella barra delle schede app della Room come nuova scheda che chiunque nella Room può aprire. Claude Code verifica il risultato leggendo lo stato, invece di tirare a indovinare.

Chi fa cosa

Claude Code osFoundry
Login Il suo login sulla tua macchina La connessione che hai approvato una volta per un workspace, con gli scope osfoundry:read e osfoundry:write
Quale Room Ne sceglie una tra quelle elencate dal server Elenca solo le Room cloud assegnate a un progetto di cui fa parte la connessione
Il codice Scrive i file completi in locale e li invia come un'unica mappa files Salva la proposta e mostra al proprietario ogni file, per intero
Approvazione La sua richiesta di permesso per gli strumenti, perché i tool propose sono marcati come distruttivi Clicchi su Approve and create sotto "Needs your approval" (in attesa della tua approvazione). Fino ad allora la barra delle schede della Room non cambia
Esecuzione dell'app Non la esegue La Room la esegue come scheda: un iframe in sandbox nell'app desktop, una sandbox nel browser sul web
Cosa rilegge list_room_apps e read_room_app_status Nome, identità, launcher e stato dell'ultima build. Niente config dell'app, segreti, file, log o contenuto del database

Configurazione

1. Aggiungi osFoundry a Claude Code

Con --print, la CLI di osFoundry stampa il comando che eseguirebbe:

$ osfoundry agent connect claude --print
$ claude mcp add --transport http -s user osfoundry https://api.osfoundry.io/api/v1/external-mcp

Sign in: open Claude Code, run /mcp, pick "osfoundry", Authenticate.

Eseguilo senza --print, oppure incolla tu la riga claude mcp add. In Claude Code lancia /mcp, scegli osfoundry e poi Authenticate. Il browser apre osFoundry, dove scegli un workspace. Da lì gli strumenti compaiono come mcp__osfoundry__….

2. Metti la Room in un progetto

Da sola, la connessione non vede nessuna Room. Deve essere una Room cloud (creata nel workspace, non tenuta su questo dispositivo) e deve appartenere a un progetto.

Apri la Room e clicca sull'icona dell'ingranaggio nell'intestazione (impostazioni della Room). Il campo Project mostra "Add to project" quando la Room non ne ha uno. Il testo di aiuto dice "Project-owned content is accessible to members of this project and its ancestors." (il contenuto del progetto è accessibile ai membri di questo progetto e dei progetti superiori). Scegli il progetto.

3. Aggiungi la connessione a quel progetto

Apri l'icona della chiave → Connected, seleziona la connessione di Claude Code e, sotto Projects, scegli lo stesso progetto e clicca su Add to project. Le Room del progetto arrivano insieme, con le sue Notes, le knowledge base e gli altri contenuti sincronizzati.

Aggiungere la connessione al progetto a cui appartiene la Room

Esempio: Aggiungere la connessione al progetto a cui appartiene la Room

Apri Tools nello stesso pannello. "All supported tools are on by default." (tutti gli strumenti supportati sono attivi di default). Quelli delle Room sono elencati con spazi al posto dei trattini bassi:

read room                 propose room snippet app
list room apps            propose room repo app
read room app status

Per lasciare Claude Code in sola lettura sulle Room, togli la spunta ai due tool propose e clicca su Save tools.

4. Chiedi lo strumento a Claude Code

Descrivi lo strumento e di' dove deve andare. Claude Code scrive i file nella sua cartella di lavoro come qualsiasi altro codice e poi li propone. Una scheda di Room gira con React 18 e TypeScript. Il punto di ingresso è src/App.tsx con un export di default. Gli unici pacchetti npm sono dayjs, marked, clsx, lucide-react e recharts. I dati passano dall'SDK delle app (docs, kv, db), non da localStorage e nemmeno da fetch verso siti esterni. Scrivilo nel prompt o in CLAUDE.md, perché altrimenti Claude Code non lo sa.

Un'esecuzione reale

I nomi degli strumenti e degli argomenti sono quelli che il server di osFoundry restituisce da tools/list. Progetto, Room, ID e risposte sono contenuto di esempio. I due file sono quelli veri di questa guida (63 e 14 righe).

Example

You: Build a small standup timer for the Launch room in osFoundry. Names list,
     90 seconds each, a Next button, roster saved. Propose it as a Room app.

Claude Code → mcp__osfoundry__list_granted_resources {}
            ← project "Launch plan"
Claude Code → mcp__osfoundry__list_project_resources {"project_id": "…", "resource_type": "room"}
            ← Room "Launch room" (room_7f3c)
Claude Code → mcp__osfoundry__read_room {"room_id": "room_7f3c"}
            ← cloud Room "Launch room"
Claude Code → mcp__osfoundry__list_room_apps {"room_id": "room_7f3c"}
            ← 2 apps, no standup timer
Claude Code → Write src/App.tsx      (63 lines: roster in kv, 90 s countdown, Next/Finish)
Claude Code → Write src/styles.css   (14 lines)
Claude Code → mcp__osfoundry__propose_room_snippet_app
                {"room_id": "room_7f3c", "name": "Standup timer",
                 "files": {"src/App.tsx": "import { useEffect, useState } from 'react'\n…",
                           "src/styles.css": ":root { --bg: #fff; …"},
                 "idempotency_key": "snip-1c9e…"}
            ← proposal waiting for the owner

Claude Code: I proposed "Standup timer" to Launch room. It shows up in the Room
             once you approve it under Connected → Needs your approval.

             (you approve in osFoundry)

You: Approved. Is it there?

Claude Code → mcp__osfoundry__list_room_apps {"room_id": "room_7f3c"}
            ← 3 apps, including "Standup timer"
Claude Code → mcp__osfoundry__read_room_app_status {"room_id": "room_7f3c", "instance_id": "…"}
            ← on the Room launcher

Claude Code: It's in Launch room's tab bar as "Standup timer".

La parte in mezzo tocca a te. La campanella mostra " proposes a Room app". In icona della chiave → Connected, il pannello della connessione ha una sezione "Needs your approval". La card dice:

Create Room snippet app in Launch room
Standup timer
▸ Review all proposed files (2)
Approval makes this code available in the Room app launcher. Review the files before approving.
Expires …
[ Approve and create ]  [ Decline ]

Una proposta di snippet app per la Room sotto Needs your approval, con entrambi i file aperti

Esempio: Una proposta di snippet app per la Room sotto Needs your approval, con entrambi i file aperti

Apri "Review all proposed files". Ogni file è mostrato per intero, con il percorso in cima. Questa è tutta la revisione, perché uno snippet non ha né un passaggio di build né un manifest da controllare. Approve and create aggiunge la scheda. Decline scarta la proposta.

Lo Standup timer approvato come nuova scheda nella Room

Esempio: Lo Standup timer approvato come nuova scheda nella Room

Dove passa il confine

Le Room locali sono fuori portata, e read_room lo dice nella sua stessa descrizione: "Local Rooms are unavailable." Una Room locale è una riga nel database dell'app desktop su un solo computer, e non viene mai sincronizzata. Il server MCP con cui parla Claude Code gira nel cloud di osFoundry, quindi l'unico modo per vedere quella Room sarebbe un relay attraverso il tuo desktop, legato a quel dispositivo e a quel progetto. La risposta initialize del server enuncia la regola generale: "Local-only data is unavailable to cloud clients." Se lo strumento deve stare in una Room locale, mettilo prima in una Room cloud. Il menu ⋯ di una scheda locale ha anche "Move to cloud room…".

Una proposta non è un'installazione. Claude Code può farne quante gliene permetti, e ognuna aspetta una persona. La card arriva nel pannello della connessione stessa, con il nome della Room, il nome dell'app e tutti i file, e ha una scadenza. Ogni chiamata porta anche un idempotency_key (da 8 a 128 caratteri), così una chiamata che Claude Code ripete dopo una risposta persa viene riconosciuta come la stessa proposta invece di generare una nuova card.

propose_room_repo_app è l'altra strada. Punta a una versione fissata di un repository GitNest nello stesso progetto della Room, non a file inclusi nella chiamata. Le app che richiedono dati, segreti, database, connettori o compute vengono rifiutate da questo strumento e devono essere configurate in osFoundry da una persona. La sua card di approvazione dice "This path does not build or deploy a bundle." e che l'approvazione "may incur normal app-serving usage".

Quello che Claude Code rilegge è volutamente scarno. list_room_apps esclude config dell'app, segreti, file e contenuto del database, e read_room_app_status non restituisce config, file, log o segreti. Quindi può confermare che il timer è nel launcher, ma non può leggere i nomi che il tuo team ci ha scritto dentro.

Quei nomi restano dove sono stati scritti. Una scheda snippet tiene i suoi dati sul dispositivo di chi la usa. Nell'app desktop la scheda mostra un'icona a forma di disco, "On this device — data is saved on this computer only", quindi la lista di ogni collega è solo sua. Per portare quei dati nel workspace bisogna salvare la scheda come app e farne il deploy dalla Room. Lo fa una persona in osFoundry, e Claude Code non ha nessuno strumento per farlo.

La prossima cosa da provare è la strada del repository: chiedi a Claude Code di fare il push del timer in un repository GitNest nello stesso progetto, poi chiama propose_room_repo_app con quella versione, così la Room esegue una versione fissata e verificabile invece di una copia incollata. La pagina delle Room mostra la barra delle schede e le impostazioni, e app interne spiega a cosa servono le app delle Room.

來源:DEV Community · dev.to