Custom connector से Claude chat को अपने osFoundry projects से कैसे जोड़ें

इस guide के आख़िर तक, claude.ai पर एक साधारण Claude conversation आपके किसी osFoundry project के Notes, knowledge bases और Records खोल सकेगी, उन्हीं के आधार पर जवाब दे सकेगी, और उस project के discussion channel में post कर सकेगी। आपकी approval के साथ वह इन्हें edit भी कर सकती है। Claude में आप हमेशा की तरह signed in रहते हैं। हर tool call पर osFoundry तय करता है कि वह chat किन चीज़ों को छू सकती है, और हर call osFoundry में connection के Recent activity में दर्ज होता है। ChatGPT भी इसी तरह, इसी server address से जुड़ता है।

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

Setup

1. osFoundry में connection बनाएँ

osFoundry में header के key icon पर click करें और Connected tab खोलें। Panel का title "Connected agents" है और यह दिखाता है कि आप किस workspace में हैं। "Connect in three steps" के नीचे:

• Assistant: Claude चुनें
• Display name: कोई भी नाम जिसे आप बाद में पहचान सकें, जैसे Claude research
• Add assistant (assistant जोड़ें) पर click करें

नए connection पर "Setup pending. This assistant cannot read or change anything yet." दिखता है। उसके बगल वाले Copy button से Server address copy करें:

https://api.osfoundry.io/api/v1/external-mcp

उदाहरण: Add assistant के बाद Connected tab, server address और pending connection के साथ

2. इसे Claude में custom connector के रूप में जोड़ें

Claude में Customize → Connectors खोलें और उस URL से एक custom connector जोड़ें। Team या Enterprise plan पर, पहले organization owner इसे Organization settings → Connectors में जोड़ता है, फिर हर member connect करता है। Remote MCP connectors के लिए Anthropic के steps Claude की custom connector guide में हैं।

Connect पर click करते ही Claude osFoundry का sign-in अपने आप ढूंढ लेता है। आपको कोई client ID या key paste नहीं करनी पड़ती।

3. एक workspace approve करें

आपका browser https://osfoundry.io/external-assistant-authorize पर पहुँचता है, जिस page का title "Connect an agent" है। यह assistant client और वह host दिखाता है जहाँ वह वापस जाएगा, फिर ये चीज़ें पूछता है:

• Workspace to connect: एक workspace। दूसरे workspace के लिए अलग connection चाहिए।
• Requested capabilities, आसान शब्दों में: "Read supported resources in projects you add", "Change supported resources where you have edit access", "Run sessions where you grant a runner role"।
• Connection: "Use pending: Claude research" चुनें ताकि यह step 1 वाले connection से जुड़ जाए, या "Create a new connection" रहने दें।
• "I approve connecting this assistant to " पर tick करें, फिर Connect।

आप वापस Claude पर भेज दिए जाते हैं। Connection live है, लेकिन अभी उसे कुछ नहीं दिखता। नया connection zero projects से शुरू होता है।

4. इसे किसी project में जोड़ें

फिर से key icon → Connected में जाकर connection चुनें। अब वहाँ "Connected." लिखा है। Projects के नीचे कोई project चुनें और Add to project पर click करें।

उदाहरण: Project में जोड़ा गया connection, नीचे उसकी linked chat के साथ

इससे उस project के supported synced content तक access मिल जाता है: Notes, knowledge bases, Record channels, cloud Rooms, उस project को assign की गई GitNest repositories, और project का discussion channel। बाद में project में जोड़ा गया content भी इसमें शामिल होता है। साधारण Message channels अलग हैं। जिस-जिस channel में chat को पढ़ना और जवाब देना हो, उसके लिए Message channels → Choose a Message channel → Invite इस्तेमाल करें।

Tools section में लिखा है "All supported tools are on by default."। जो tools आप इस connection को नहीं देना चाहते, उनका tick हटाएँ और Save tools पर click करें।

उदाहरण: Claude connection की Tools checklist, default में सब on

5. Chat में इसे on करें

किसी Claude conversation में + menu → Connectors खोलें और osFoundry connector enable करें। फिर सीधी भाषा में पूछें।

एक असली run

नीचे का prompt और जवाब एक demo project का Example content है। Tool names और argument names वही हैं जो live server tools/list में बताता है। claude.ai में calls connector के नाम के नीचे दिखती हैं। अगर आप यही URL Claude Code में osfoundry नाम से जोड़ते हैं, तो वही tools mcp__osfoundry__list_project_resources वगैरह के रूप में दिखते हैं।

उदाहरण

आप: osFoundry से बताओ, Q3 launch checklist में अभी क्या-क्या बाकी है?
     Support KB में कुछ उससे उल्टा लिखा हो तो check करो, फिर
     "pricing page" record को Ready mark कर दो।

Claude → list_granted_resources {}
       ← 1 connected project: "Launch Q3" (workspace)
Claude → list_project_resources {"project_id": "…", "resource_type": "note", "search": "checklist"}
       ← Note "Q3 launch checklist"
Claude → list_note_tabs {"note_id": "…"}
       ← tabs: Note (text), Sheet "Owners"
Claude → read_note_tab {"note_id": "…", "tab_id": "…"}
       ← 9 items, 3 unchecked
Claude → search_knowledge_base {"knowledge_base_id": "…", "query": "refund window"}
       ← article "Refund policy" (2 दिन पहले update हुआ)
Claude → read_record_item {"record_channel_id": "…", "item_id": "…"}
       ← "pricing page", status Draft, version …
Claude → edit_record_item {"record_channel_id": "…", "item_id": "…",
                           "values": {"status": "Ready"},
                           "expected_version": "…", "idempotency_key": "…"}
       [Claude आपसे यह tool call allow करने को कहता है → Allow]
       ← saved, नया version …

Claude: तीन items बाकी हैं: press embargo की तारीख, FAQ translation,
        और pricing page पर refund वाली line। Checklist में 14 दिन
        लिखा है; KB article "Refund policy" में 30। Pricing page
        record को मैंने Ready mark कर दिया है।

उस transcript की दो बातें जान-बूझकर रखी गई हैं। edit_record_item को वह version चाहिए जो read_record_item ने लौटाया था, इसलिए अगर बीच में record बदल गया हो तो वह overwrite होने के बजाय reject हो जाता है। दोबारा भेजा गया वही idempotency_key पहला result लौटाता है, इसलिए retry किया गया call दो बार write नहीं करता।

सीमा कहाँ है

osFoundry आपकी Claude chats नहीं खोल सकता। MCP connection Claude को osFoundry tools तब call करने देता है जब Claude ऐसा तय करे। उल्टी दिशा में osFoundry के पास कोई API नहीं है जिससे वह किसी personal conversation को list करे, पढ़े या शुरू करे। Chat को project से link करने वाला tool (link_current_chat) वह label लेता है जो chat अपने बारे में ख़ुद बताती है, और osFoundry उसे verified identity नहीं, बल्कि routing hint मानता है। इसी वजह से Claude को osFoundry से कोई background notification नहीं मिलता। वह तभी काम करता है जब आप conversation खोलकर कुछ पूछते हैं।

Local-only data local ही रहता है। Server अपने initialize reply में ख़ुद यह कहता है: "Local-only data is unavailable to cloud clients."। Local Rooms, local Graph sessions और कभी sync न हुआ content connection को नहीं दिखता। Desktop Graph sessions share करना उसी tab में एक अलग switch है, और इसके लिए desktop app खुला और signed in होना चाहिए।

Access हर call पर check होता है, हर sign-in पर नहीं। हर call को connection के status, उसके workspace, project की मौजूदा membership, item इस समय किस project में है, और उस item पर आपके अपने role से मिलाया जाता है। किसी Note को दूसरे project में move करें, project हटा दें, या Revoke connection पर click करें, तो अगला call refuse हो जाता है। Edits के लिए यह भी ज़रूरी है कि आपके पास, यानी connection approve करने वाले व्यक्ति के पास, अब भी edit rights हों।

कुछ writes proposals बन जाते हैं। GitNest work, change sets, file imports, pull requests और Room app installs propose_… tools से होकर जाते हैं। ये Connected tab में "Needs your approval" के नीचे इंतज़ार करते हैं, जहाँ Approve या Decline चुनने से पहले आप target repository या Room और files देख सकते हैं। Claude को आपका Git provider token या कोई secret value कभी नहीं मिलती।

Message channels के लिए invitation ज़रूरी है। किसी project में होने से सिर्फ़ उसी project का discussion channel खुलता है। बाक़ी हर channel के लिए अलग से Invite चाहिए, और private channel में उसके owner को invite करना होता है।

आगे क्या

उसी project में एक knowledge base जोड़ें और Claude से ऐसा सवाल पूछें जिसका जवाब आप आम तौर पर उसी से देते हैं, जैसे "हमारी KB refunds के बारे में क्या कहती है, article के नाम के साथ?"। search_knowledge_base article ID और उसके last update का समय लौटाता है, ताकि आप source check कर सकें। osFoundry की knowledge bases कैसे organised हैं, यह knowledge bases page पर है।