Al final de esta guía, Claude Code escribe una pequeña herramienta interna en tu máquina (aquí, un temporizador para la standup: una lista de nombres, 90 segundos por persona y un botón Next) y la propone a una Room en la nube de osFoundry. Todavía no aparece nada en la Room. Abres la propuesta, lees los dos archivos fuente y haces clic en Approve and create. A partir de ahí, el temporizador vive en la barra de pestañas de apps de la Room como una pestaña nueva que cualquiera en la Room puede abrir. Claude Code comprueba el resultado leyendo el estado, en lugar de suponerlo.
Quién hace qué
| Claude Code | osFoundry | |
|---|---|---|
| Inicio de sesión | Su propio login en tu máquina | La conexión que aprobaste una vez para un workspace, con los scopes osfoundry:read y osfoundry:write
|
| Qué Room | Elige una de las que lista el servidor | Lista solo las Rooms en la nube asignadas a un proyecto en el que está la conexión |
| El código | Escribe los archivos completos en local y los envía como un único mapa files
|
Guarda la propuesta y le muestra al propietario cada archivo, entero |
| Aprobación | Su propio aviso de permisos de herramientas, porque las herramientas propose están marcadas como destructivas | Tú haces clic en Approve and create bajo "Needs your approval" (necesita tu aprobación). Hasta entonces, la barra de pestañas de la Room no cambia |
| Ejecutar la app | No la ejecuta | La Room la ejecuta como pestaña: un iframe aislado en la app de escritorio y un sandbox en el navegador en la web |
| Qué puede leer de vuelta |
list_room_apps y read_room_app_status
|
Nombre, identidad, launcher y estado de la última build. Nada de configuración de la app, secretos, archivos, logs ni contenido de la base de datos |
Configuración
1. Añade osFoundry a Claude Code
La CLI de osFoundry imprime el comando que ejecutaría si le pasas --print:
$ 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.
Ejecútalo sin --print, o pega tú mismo la línea claude mcp add. En Claude Code, ejecuta /mcp, elige osfoundry y selecciona Authenticate. El navegador abre osFoundry y ahí eliges un workspace. Después, las herramientas aparecen como mcp__osfoundry__….
2. Mete la Room en un proyecto
La conexión nunca ve una Room por sí sola. Tiene que ser una Room en la nube (creada en el workspace, no guardada en este dispositivo) y tiene que pertenecer a un proyecto.
Abre la Room y haz clic en el icono del engranaje de su cabecera (ajustes de la Room). El campo Project muestra "Add to project" cuando la Room no tiene ninguno. Su texto de ayuda dice "Project-owned content is accessible to members of this project and its ancestors." (el contenido del proyecto es accesible para los miembros de este proyecto y de sus proyectos superiores). Elige el proyecto.
3. Añade la conexión a ese proyecto
Abre el icono de la llave → Connected, selecciona la conexión de Claude Code y, en Projects, elige el mismo proyecto y haz clic en Add to project. Las Rooms del proyecto vienen incluidas, junto con sus Notes, bases de conocimiento y el resto del contenido sincronizado.
Ejemplo: Añadir la conexión al proyecto al que pertenece la Room
Abre Tools en el mismo panel. "All supported tools are on by default." (todas las herramientas compatibles están activadas por defecto). Las de Room aparecen con espacios en lugar de guiones bajos:
read room propose room snippet app
list room apps propose room repo app
read room app status
Si quieres que Claude Code solo pueda leer las Rooms, desmarca las dos herramientas propose y haz clic en Save tools.
4. Pídele la herramienta a Claude Code
Describe la herramienta y di dónde debe ir. Claude Code escribe los archivos en su carpeta de trabajo como cualquier otro código y luego los propone. Una pestaña de Room ejecuta React 18 con TypeScript. Su punto de entrada es src/App.tsx con un export por defecto. Los únicos paquetes npm disponibles son dayjs, marked, clsx, lucide-react y recharts. Los datos pasan por el SDK de apps (docs, kv, db), no por localStorage ni por fetch a sitios externos. Ponlo en tu prompt o en CLAUDE.md, porque Claude Code no lo sabe de otra forma.
Una ejecución real
Los nombres de las herramientas y de los argumentos son los que devuelve el servidor de osFoundry en tools/list. El proyecto, la Room, los IDs y las respuestas son contenido de ejemplo. Los dos archivos son los reales de esta guía (63 y 14 líneas).
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 del medio te toca a ti. La campana muestra " proposes a Room app". En el icono de la llave → Connected, el panel de la conexión tiene una sección "Needs your approval". La tarjeta 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 ]
Ejemplo: Propuesta de snippet app de Room en Needs your approval, con los dos archivos abiertos
Abre "Review all proposed files". Cada archivo se muestra entero, con la ruta primero. Esa es toda la revisión, porque un snippet no tiene paso de build ni manifiesto que comprobar. Approve and create añade la pestaña. Decline descarta la propuesta.
Ejemplo: El Standup timer aprobado como pestaña nueva en la Room
Dónde está el límite
Las Rooms locales quedan fuera de su alcance, y read_room lo dice en su propia descripción: "Local Rooms are unavailable." Una Room local es una fila en la base de datos de la app de escritorio en un solo ordenador, y nunca se sincroniza. El servidor MCP con el que habla Claude Code corre en la nube de osFoundry, así que la única forma de que viera esa Room sería un relay a través de tu escritorio, ligado a ese dispositivo y a ese proyecto. La respuesta initialize del servidor deja clara la regla general: "Local-only data is unavailable to cloud clients." Si la herramienta tiene que ir en una Room local, ponla primero en una Room en la nube. El menú ⋯ de una pestaña local también tiene "Move to cloud room…".
Una propuesta no es una instalación. Claude Code puede hacer tantas como le permitas, y cada una espera a que una persona la revise. La tarjeta aparece en el panel propio de la conexión, con el nombre de la Room, el nombre de la app y todos los archivos, y tiene fecha de caducidad. Cada llamada lleva además un idempotency_key (de 8 a 128 caracteres), así que si Claude Code reintenta una llamada tras perder la respuesta, se reconoce como la misma propuesta y no como una tarjeta nueva.
propose_room_repo_app es la otra vía de entrada. Apunta a una versión fijada de un repositorio de GitNest en el mismo proyecto que la Room, no a archivos dentro de la llamada. Esta herramienta rechaza las apps que piden datos, secretos, bases de datos, conectores o cómputo; esas las tiene que configurar una persona en osFoundry. Su tarjeta de aprobación dice "This path does not build or deploy a bundle." y que la aprobación "may incur normal app-serving usage".
Lo que Claude Code puede leer de vuelta es escaso a propósito. list_room_apps excluye la configuración de la app, los secretos, los archivos y el contenido de la base de datos, y read_room_app_status no devuelve configuración, archivos, logs ni secretos. Así que puede confirmar que el temporizador está en el launcher, pero no puede leer los nombres que tu equipo escribió en él.
Esos nombres se quedan donde se escribieron. Una pestaña de snippet guarda sus datos en el dispositivo de quien la usa. En la app de escritorio, la pestaña muestra un icono de disco, "On this device — data is saved on this computer only", así que la lista de cada compañero es solo suya. Para llevar esos datos al workspace hay que guardar la pestaña como app y desplegarla desde la Room. Eso lo hace una persona en osFoundry, y Claude Code no tiene ninguna herramienta para ello.
Lo siguiente que conviene probar es la vía del repositorio: pídele a Claude Code que suba el temporizador a un repositorio de GitNest en el mismo proyecto y luego llama a propose_room_repo_app con esa versión, para que la Room ejecute una versión fijada y revisable en lugar de una copia pegada. La página de Rooms muestra la barra de pestañas y los ajustes, y apps internas explica para qué sirven las apps de Room.



Top comments (0)