DEV Community

Cover image for आपकी मंज़ूरी के बाद Claude Code से osFoundry Room में छोटा ऐप कैसे जुड़वाएं
BBT for BBT हिन्दी

Posted on

आपकी मंज़ूरी के बाद Claude Code से osFoundry Room में छोटा ऐप कैसे जुड़वाएं

इस गाइड के आखिर तक, Claude Code आपकी मशीन पर एक छोटा इंटरनल टूल लिखता है (यहां एक standup timer: नामों की लिस्ट, हर व्यक्ति के लिए 90 सेकंड, और एक Next बटन) और उसे osFoundry के एक क्लाउड Room में प्रपोज़ करता है। अभी Room में कुछ भी नहीं दिखता। आप प्रपोज़ल खोलते हैं, दोनों सोर्स फ़ाइलें पढ़ते हैं, और Approve and create पर क्लिक करते हैं। इसके बाद timer Room के ऐप टैब बार में एक नए टैब के रूप में आ जाता है, जिसे Room का हर सदस्य खोल सकता है। Claude Code अंदाज़ा लगाने के बजाय status पढ़कर नतीजा चेक करता है।

कौन क्या करता है

Claude Code osFoundry
लॉगिन आपकी मशीन पर उसका अपना साइन-इन वह कनेक्शन जिसे आपने एक workspace के लिए एक बार मंज़ूरी दी थी, osfoundry:read और osfoundry:write scopes के साथ
कौन-सा Room सर्वर जो लिस्ट देता है, उसमें से एक चुनता है सिर्फ़ वे क्लाउड Rooms लिस्ट करता है जो उस प्रोजेक्ट में हैं जिसमें कनेक्शन जुड़ा है
कोड पूरी फ़ाइलें लोकल लिखता है और उन्हें एक files map में भेजता है प्रपोज़ल सेव करता है और owner को हर फ़ाइल पूरी दिखाता है
मंज़ूरी उसका अपना tool-permission प्रॉम्प्ट, क्योंकि propose टूल destructive मार्क हैं आप "Needs your approval" (आपकी मंज़ूरी चाहिए) के नीचे Approve and create पर क्लिक करते हैं। तब तक Room का टैब बार नहीं बदलता
ऐप चलाना उसे नहीं चलाता Room उसे टैब के रूप में चलाता है: डेस्कटॉप ऐप में sandboxed iframe, वेब पर ब्राउज़र के अंदर sandbox
वापस क्या पढ़ता है list_room_apps और read_room_app_status नाम, पहचान, launcher और लेटेस्ट build की स्थिति। ऐप config, secrets, फ़ाइलें, logs या database कंटेंट नहीं

सेटअप

1. Claude Code में osFoundry जोड़ें

--print देने पर osFoundry CLI वह कमांड प्रिंट करता है जो वह चलाएगा:

$ 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.
Enter fullscreen mode Exit fullscreen mode

इसे --print के बिना चलाएं, या claude mcp add वाली लाइन खुद पेस्ट करें। Claude Code में /mcp चलाएं, osfoundry चुनें और Authenticate पर जाएं। ब्राउज़र में osFoundry खुलता है, और वहां आप एक workspace चुनते हैं। इसके बाद टूल mcp__osfoundry__… के रूप में दिखने लगते हैं।

2. Room को किसी प्रोजेक्ट में डालें

कनेक्शन अपने आप कोई Room नहीं देखता। Room क्लाउड Room होना चाहिए (workspace में बना हुआ, सिर्फ़ इस डिवाइस पर रखा हुआ नहीं), और उसे किसी प्रोजेक्ट का हिस्सा होना चाहिए।

Room खोलें और उसके हेडर में गियर आइकन (Room settings) पर क्लिक करें। अगर Room का कोई प्रोजेक्ट नहीं है, तो Project फ़ील्ड में "Add to project" दिखता है। उसकी हेल्पर लाइन में लिखा है "Project-owned content is accessible to members of this project and its ancestors." (प्रोजेक्ट का कंटेंट इस प्रोजेक्ट और उसके ऊपर के प्रोजेक्ट्स के सदस्यों को दिखता है)। प्रोजेक्ट चुनें।

3. कनेक्शन को उसी प्रोजेक्ट में जोड़ें

की आइकन → Connected खोलें, Claude Code कनेक्शन चुनें, और Projects में वही प्रोजेक्ट चुनकर Add to project पर क्लिक करें। प्रोजेक्ट के Rooms अपने आप साथ आ जाते हैं, साथ में उसके Notes, knowledge bases और बाकी synced कंटेंट भी।

कनेक्शन को उस प्रोजेक्ट में जोड़ना जिसका Room हिस्सा है

उदाहरण: कनेक्शन को उस प्रोजेक्ट में जोड़ना जिसका Room हिस्सा है

उसी पैनल में Tools खोलें। "All supported tools are on by default." (सभी सपोर्टेड टूल डिफ़ॉल्ट रूप से चालू हैं)। Room वाले टूल underscore की जगह space के साथ लिस्ट होते हैं:

read room                 propose room snippet app
list room apps            propose room repo app
read room app status
Enter fullscreen mode Exit fullscreen mode

अगर आप चाहते हैं कि Claude Code Rooms को सिर्फ़ पढ़ सके, तो दोनों propose टूल अनटिक करें और Save tools पर क्लिक करें।

4. Claude Code से टूल बनवाएं

टूल के बारे में बताएं और यह भी कि उसे कहां जाना है। Claude Code बाकी कोड की तरह अपने working folder में फ़ाइलें लिखता है, फिर उन्हें प्रपोज़ करता है। Room टैब TypeScript के साथ React 18 पर चलता है। उसका entry src/App.tsx है, जिसमें default export हो। सिर्फ़ ये npm पैकेज मिलते हैं: dayjs, marked, clsx, lucide-react और recharts। डेटा ऐप SDK (docs, kv, db) से जाता है, localStorage से नहीं और बाहरी साइटों पर fetch से भी नहीं। यह बात अपने प्रॉम्प्ट में या CLAUDE.md में लिख दें, वरना Claude Code को पता नहीं चलेगा।

एक असली रन

टूल और arguments के नाम वही हैं जो osFoundry का सर्वर tools/list से लौटाता है। प्रोजेक्ट, Room, IDs और जवाब उदाहरण के लिए हैं। दोनों फ़ाइलें इसी गाइड की असली फ़ाइलें हैं (63 और 14 लाइनें)।

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".
Enter fullscreen mode Exit fullscreen mode

बीच वाला हिस्सा आपका है। घंटी में " proposes a Room app" दिखता है। की आइकन → Connected में, कनेक्शन के पैनल में "Needs your approval" सेक्शन होता है। कार्ड पर लिखा होता है:

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 ]
Enter fullscreen mode Exit fullscreen mode

Needs your approval के नीचे Room snippet app का प्रपोज़ल, दोनों फ़ाइलें खुली हुई

उदाहरण: Needs your approval के नीचे Room snippet app का प्रपोज़ल, दोनों फ़ाइलें खुली हुई

"Review all proposed files" खोलें। हर फ़ाइल पूरी दिखती है, सबसे ऊपर उसका path। पूरा review बस इतना ही है, क्योंकि snippet में न कोई build स्टेप होता है, न कोई manifest जिसे चेक करना पड़े। Approve and create टैब जोड़ देता है। Decline प्रपोज़ल हटा देता है।

मंज़ूर हुआ Standup timer, Room में एक नए टैब के रूप में

उदाहरण: मंज़ूर हुआ Standup timer, Room में एक नए टैब के रूप में

सीमा कहां है

लोकल Rooms तक पहुंच नहीं है, और read_room अपने डिस्क्रिप्शन में ही यह कहता है: "Local Rooms are unavailable." लोकल Room एक ही कंप्यूटर पर डेस्कटॉप ऐप के database की एक row है, और वह कभी sync नहीं होता। Claude Code जिस MCP सर्वर से बात करता है वह osFoundry के क्लाउड में चलता है, इसलिए उस Room को देखने का एकमात्र तरीका आपके डेस्कटॉप से होकर जाने वाला relay होगा, जो उसी डिवाइस और प्रोजेक्ट से बंधा हो। सर्वर का initialize जवाब सामान्य नियम बताता है: "Local-only data is unavailable to cloud clients." अगर टूल लोकल Room के लिए है, तो पहले उसे क्लाउड Room में रखें। लोकल टैब के ⋯ मेन्यू में "Move to cloud room…" भी होता है।

प्रपोज़ल इंस्टॉल नहीं है। Claude Code उतने प्रपोज़ल बना सकता है जितने आप करने दें, और हर एक किसी इंसान का इंतज़ार करता है। कार्ड कनेक्शन के अपने पैनल में आता है, उसमें Room का नाम, ऐप का नाम और हर फ़ाइल होती है, और उसकी एक expiry होती है। हर कॉल में एक idempotency_key (8 से 128 कैरेक्टर) भी होता है, इसलिए जवाब खो जाने के बाद Claude Code जो कॉल दोबारा करता है, उसे नया कार्ड नहीं बल्कि वही प्रपोज़ल माना जाता है।

propose_room_repo_app दूसरा रास्ता है। यह कॉल में भेजी गई फ़ाइलों की जगह, Room वाले प्रोजेक्ट के ही किसी GitNest repository के pinned वर्ज़न की ओर इशारा करता है। जो ऐप्स डेटा, secrets, databases, connectors या compute मांगते हैं, उन्हें यह टूल रिजेक्ट कर देता है, और उन्हें osFoundry में किसी इंसान को सेट करना होता है। इसके approval कार्ड पर लिखा होता है "This path does not build or deploy a bundle." और यह कि मंज़ूरी "may incur normal app-serving usage"।

Claude Code जो वापस पढ़ता है, वह जानबूझकर कम रखा गया है। list_room_apps ऐप config, secrets, फ़ाइलें और database कंटेंट शामिल नहीं करता, और read_room_app_status कोई config, फ़ाइलें, logs या secrets नहीं लौटाता। यानी वह पुष्टि कर सकता है कि timer launcher में है, लेकिन आपकी टीम ने उसमें जो नाम टाइप किए, उन्हें नहीं पढ़ सकता।

वे नाम वहीं रहते हैं जहां टाइप किए गए थे। Snippet टैब अपना डेटा उसी के डिवाइस पर रखता है जो उसे इस्तेमाल कर रहा है। डेस्कटॉप ऐप में टैब पर ड्राइव आइकन दिखता है, "On this device — data is saved on this computer only", इसलिए हर teammate की लिस्ट उसकी अपनी होती है। उस डेटा को workspace तक ले जाने के लिए टैब को ऐप के रूप में सेव करके Room से deploy करना पड़ता है। यह काम osFoundry में कोई इंसान करता है, और Claude Code के पास इसके लिए कोई टूल नहीं है।

अगली चीज़ जो आज़मानी चाहिए वह है repository वाला रास्ता: Claude Code से timer को उसी प्रोजेक्ट के किसी GitNest repository में push करवाएं, फिर उस वर्ज़न के साथ propose_room_repo_app कॉल करवाएं, ताकि Room पेस्ट की गई कॉपी के बजाय एक pinned, review करने लायक वर्ज़न चलाए। Room पेज पर टैब बार और settings दिखती हैं, और इंटरनल ऐप्स बताता है कि Room ऐप्स किस काम के लिए हैं।

Top comments (0)