Al terminar, un chat de Claude lanza uno de tus Graphs guardados de osFoundry, esos programas de agentes de varios pasos que se ramifican, se reparten en paralelo y reintentan, y la ejecución ocurre en tu propio escritorio, no en Claude ni en un servidor. Claude recibe un ticket al instante, va consultando su estado mientras el escritorio trabaja y responde con el resultado del Graph. Si a mitad de camino cambias de idea, Claude puede cancelarlo.
Quién hace qué
| Lado de Claude | Lado de osFoundry | |
|---|---|---|
| Inicio de sesión | Tu cuenta de Claude, sin cambios | La conexión que aprobaste, añadida a un proyecto |
| Qué puede ver | Nombre, descripción, slug, versión y estado de cada sesión de Graph compartida | El programa del Graph, sus agentes y tus archivos se quedan en el escritorio |
| Qué Graphs | Elige entre los de list_graph_sessions | Solo las sesiones que marcaste para ese proyecto en la app de escritorio |
| Dónde se ejecuta | En ninguna parte. Claude solo encola y lee | En tu escritorio, que recoge la ejecución encolada y la corre en local |
| Espera | Llama a get_graph_run hasta que el estado es definitivo | Informa un único resultado acotado cuando termina la ejecución |
| Aprobaciones | El aviso de herramienta del propio Claude antes de run_graph_session | Las herramientas configuradas para preguntar siempre se rechazan dentro de la ejecución; no hay nadie para hacer clic |
Configuración
Se da por hecho que el conector de Claude ya existe (icono de llave → Connected → Add assistant, y luego https://api.osfoundry.io/api/v1/external-mcp añadido como conector personalizado en Claude).
1. Ten una sesión de Graph guardada en el escritorio
Los Graphs viven en el dispositivo. Los escribes o editas con Maestro, con un agente o con osStudio, y cada uno guardado recibe un ID de sesión con la forma gs_ más 32 caracteres hexadecimales. La pantalla Graph de la app de escritorio los lista. Un Graph que solo has visto en el navegador no se puede compartir, porque el navegador no puede ejecutarlo.
Ejemplo: la pantalla Graph de la app de escritorio con sesiones de Graph guardadas
2. Añade la conexión de Claude a un proyecto
En icono de llave → Connected, selecciona la conexión de Claude. En Projects, elige un proyecto y haz clic en Add to project (añadir al proyecto). Ese proyecto es el único sitio donde Claude buscará Graphs.
Ejemplo: La sección Projects de una conexión de Claude, con un proyecto añadido
3. Comparte la sesión de Graph en ese proyecto
Más abajo en la misma pestaña Connected, solo en la app de escritorio, hay una sección llamada Share desktop Graph sessions (compartir sesiones de Graph del escritorio). Aparecen todos tus proyectos, con las sesiones de Graph guardadas en este dispositivo como casillas:
Share desktop Graph sessions Choose the saved Graph sessions to share with each project, then enable that project. Your desktop must be open and signed in. Launch plan · workspace [ Share selected Graphs ] [x] Weekly KPI digest [ ] Release notes draft 
Ejemplo: Share desktop Graph sessions con una sesión marcada para un proyecto
Primero marca las sesiones y luego haz clic en Share selected Graphs. Si no hay nada marcado, la app te frena con "Choose at least one Graph session for this project first." Compartir un proyecto no comparte todos los Graphs del dispositivo. Cada sesión es una decisión aparte, por proyecto.
4. Deja el escritorio abierto
La app de escritorio revisa el proyecto en busca de ejecuciones encoladas cada 20 segundos, y al momento cuando cambias lo que está compartido. Si la app está cerrada, la petición de Claude espera en la cola hasta que se vuelva a abrir.
5. Pídeselo a Claude
In osFoundry, run the Weekly KPI digest Graph in the Launch plan project for week 2026-W45, and tell me the three biggest changes. Una ejecución real
El proyecto, el Graph y las cifras de abajo son datos de ejemplo. Los nombres de las herramientas y de los argumentos son los que el servidor real lista en tools/list. En Claude Code las mismas herramientas aparecen como mcp__osfoundry__run_graph_session y similares.
Ejemplo Claude → list_granted_resources {} ← projects: Launch plan Claude → list_graph_sessions {"project_id": "<Launch plan>"} ← Weekly KPI digest (gs_3f…, weekly-kpi-digest v3, ready) Release notes draft no aparece: nunca se marcó Claude → run_graph_session {"graph_session_id": "gs_3f…", "arguments": {"week": "2026-W45"}, "idempotency_key": "kpi-2026-w45-a"} [Claude te pide permitir esta llamada a la herramienta → Allow] ← command_id "8c1e…", status queued Claude → get_graph_run {"command_id": "8c1e…"} ← queued (el escritorio aún no ha consultado) Claude → get_graph_run {"command_id": "8c1e…"} ← running Claude → get_graph_run {"command_id": "8c1e…"} ← completed result: {"execution_id": "GR-0007L", "status": "completed", "result": {...}, "total_tokens": 18412, "reported_cost": 0.07} Claude: Semana 45: registros +18%, la conversión de prueba a pago baja del 9.1% al 7.4%, y los tickets de soporte se duplicaron tras el lanzamiento del martes. Que el primer get_graph_run diga queued no es un retraso por parte de Claude. Nada empuja trabajo a tu escritorio. Es el escritorio el que le pide trabajo al servidor, y hasta su siguiente consulta la ejecución simplemente espera. En cuanto la recoge, el escritorio ejecuta el Graph con el mismo comando que usa la pantalla Graph y luego devuelve el resultado. Lo último que lee Claude es ese resultado ya enviado, no un stream en vivo.
La ejecución también queda archivada bajo el proyecto Launch plan en el escritorio. El contexto del proyecto y la búsqueda en el historial de chats dentro de la ejecución usan ese proyecto y nada más amplio.
Para detenerla, Claude llama a cancel_graph_run con el mismo command_id. Una ejecución que sigue en cola se cancela directamente y nunca arranca. Una que ya está corriendo recibe una solicitud de cancelación, que el escritorio revisa cada 3 segundos y pasa al Graph en marcha.
Dónde está el límite
El Graph no sale del dispositivo. list_graph_sessions solo devuelve metadatos: nombre, descripción, slug, versión y estado. Claude nunca ve el script, los agentes a los que llama ni los archivos que tocan. Por eso también Claude pasa arguments sin ver ningún esquema. Si quieres que Claude los rellene bien, describe las entradas en la descripción del Graph.
La ejecución le toca al escritorio porque los agentes del Graph, los modelos locales, las carpetas y la configuración de aprobaciones viven allí. El servidor solo guarda la cola y el resultado final. Si el escritorio está desconectado, las ejecuciones encoladas lo esperan. Claude no puede mandarlas a ningún otro sitio.
Dentro de la ejecución no hay nadie mirando. Las herramientas configuradas para preguntar siempre se rechazan en lugar de mostrar el aviso, porque un aviso que nadie responde retendría la ejecución durante minutos y fallaría igualmente. Las herramientas que no preguntan se ejecutan con normalidad. Si un Graph depende de una herramienta que apruebas a mano, ejecuta ese Graph tú mismo desde la pantalla Graph.
Lo que vuelve está acotado. El resultado es el ID de la ejecución, el estado, el resultado, el número de tokens y el coste informado, y solo si cabe en 100,000 caracteres de JSON. Un resultado más grande vuelve como el ID y el estado con result_truncated: true, y el registro completo se queda en el historial de ejecuciones del escritorio. Los errores se cortan a los 2,000 caracteres.
Solo el agente que inició una ejecución puede leerla o cancelarla. Otra conexión que pida el mismo command_id recibe "Graph run not found or access removed", la misma respuesta que para un ID que no existe.
Puedes deshacer el uso compartido en cualquier momento antes de que arranque la ejecución. Si desmarcas la sesión o haces clic en Stop sharing (dejar de compartir) mientras una ejecución está en cola, el escritorio vuelve a comprobarlo antes de ejecutar y la cancela con "Graph session is no longer shared with this project".
Siguiente paso
Comparte un Graph pequeño, pide a Claude que lo ejecute, luego haz clic en Stop sharing mientras sigue en cola y mira cómo Claude informa de la cancelación. Cómo reparte osFoundry el trabajo entre agentes está en la página de orquestación de Maestro, y la lista de conexiones en la página Connected.
