@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/mcp-apps.md

@@ -0,0 +1,147 @@
+---
+title: "MCP ऐप्स"
+description: "लेखक और इंटरैक्टिव MCP ऐप UI को Claude, ChatGPT और अन्य संगत होस्ट के अंदर एम्बेड करें - वास्तविक ऐप रूट, एंबेड ब्रिज और होस्ट ब्रिज API का उपयोग करके।"
+---
+
+# MCP ऐप्स
+
+**यह पृष्ठ: Claude/ChatGPT में इनलाइन UIs।** MCP ऐप संसाधनों और एंबेड ब्रिज का लेखन जो एक संगत होस्ट की चैट के अंदर एक वास्तविक ऐप रूट प्रस्तुत करता है। यह पेज **क्लाइंट सपोर्ट मैट्रिक्स** ([below](#client-support)) के लिए एकल होम भी है।
+
+| यदि आप चाहते हैं…                                               | पढ़ें                                    |
+| --------------------------------------------------------------- | ---------------------------------------- |
+| किसी बाहरी एजेंट/होस्ट को अपने ऐप से कनेक्ट करें                | [External Agents](/docs/external-agents) |
+| अपने एजेंट को अधिक टूल दें (अन्य MCP सर्वर का उपभोग करें)       | [MCP Clients](/docs/mcp-clients)         |
+| इनलाइन UI बनाएं जो Claude/ChatGPT में प्रस्तुत हों              | **यह पृष्ठ** — MCP ऐप्स                  |
+| निचले स्तर का MCP सर्वर संदर्भ (प्रमाणीकरण, उपकरण, कस्टम माउंट) | [MCP Protocol](/docs/mcp-protocol)       |
+
+MCP ऐप्स आधिकारिक `io.modelcontextprotocol/ui` एक्सटेंशन हैं जो संगत होस्ट - Claude, Claude डेस्कटॉप, ChatGPT, VS कोड GitHub कोपायलट, गूज़, पोस्टमैन, MCPJam और कर्सर - को चैट में इंटरैक्टिव UIs इनलाइन प्रस्तुत करने देता है। एजेंट-नेटिव ऐप्स में, प्रत्येक MCP ऐप एक **वास्तविक React रूट** है, न कि एक अलग सादा-HTML विजेट।
+
+Agent-Native ऐप की अपनी चैट के अंदर, टेबल, चार्ट, टाइप किए गए परिणाम और अनुमोदन व्यय जैसे प्रथम-पक्ष विजेट के लिए [native chat renderers](/docs/native-chat-ui) को प्राथमिकता दें। Claude, ChatGPT, Copilot, कर्सर और अन्य संगत होस्ट में बाहरी/क्रॉस-होस्ट इनलाइन UI के लिए MCP ऐप्स का उपयोग करें, एक्शन `link` के साथ यूनिवर्सल डीप-लिंक फ़ॉलबैक के रूप में।
+
+## संलेखन: वैकल्पिक MCP ऐप्स UI {#mcp-apps}
+
+उन होस्टों के लिए जो MCP ऐप्स एक्सटेंशन का समर्थन करते हैं, एक कार्रवाई `mcpApp` के साथ एक इनलाइन UI संसाधन का विज्ञापन भी कर सकती है। यह प्रवाह के लिए एक प्रगतिशील वृद्धि है जहां बाहरी एजेंट को उपयोगकर्ता को केवल पाठ के बजाय एक इंटरैक्टिव सतह सौंपनी चाहिए - उदाहरण के लिए ईमेल ड्राफ्ट की समीक्षा करना, कैलेंडर आमंत्रण संपादित करना, या जेनरेट किए गए डैशबोर्ड वेरिएंट के बीच चयन करना।
+
+जब भी उपयोगकर्ता को UI की आवश्यकता हो तो `embedRoute()` या `embedApp()` के साथ वास्तविक React ऐप का उपयोग करें। मानसिक मॉडल सरल है: कार्रवाई का `link` लक्ष्य MCP ऐप एम्बेड लक्ष्य भी है। ऑपरेशन को एक सामान्य क्रिया/टूल के रूप में प्रदर्शित करें, `link` के साथ एक केंद्रित डीप लिंक लौटाएं, और `mcpApp.resource = embedApp(...)` जोड़ें ताकि सक्षम होस्ट एक नया टैब खोलने के बजाय उसी रूट इनलाइन को लोड करें। जब दोनों को एक ही मार्ग से बनाया जाना चाहिए, तो `embedRoute({ title, openLabel, path })` को प्राथमिकता दें: यह सुविधा रैपर है जो एक कॉल से मिलान वाले `link` और `mcpApp` फ़ील्ड लौटाता है, जबकि `embedApp(...)` निचले स्तर का संसाधन है जिसे आप सीधे `mcpApp.resource` को असाइन करते हैं।
+
+इसका मतलब है कि फुल-ऐप एंबेड कुछ भी कर सकता है जो रूट एक बार खोलने के बाद कर सकता है: ईमेल ड्राफ्ट की समीक्षा करें या संपादित करें, एक फ़िल्टर किया गया इनबॉक्स/खोज दिखाएं, एक कैलेंडर ईवेंट या ईवेंट ड्राफ्ट खोलें, एक एक्सटेंशन पेज लोड करें, एक पूर्ण एनालिटिक्स डैशबोर्ड या सहेजे गए विश्लेषण का निरीक्षण करें, स्लाइड संपादक में एक डेक जारी रखें, या एक डिज़ाइन प्रोजेक्ट/संपादक खोलें। MCP ऐप्स के लिए दूसरे राज्य प्रोटोकॉल का आविष्कार करने के बजाय URL/डीप-लिंक पैरामीटर और मौजूदा `/_agent-native/open` नेविगेशन/ऐप-स्टेट ब्रिज को प्राथमिकता दें।
+
+दुर्लभ अवसरों पर सही लक्ष्य एक केंद्रित ऐप रूट होता है जो संपूर्ण ऐप शेल के बजाय एक साझा React घटक प्रस्तुत करता है। एनालिटिक्स का `/chart` रूट मॉडल है: यह URL में एक कॉम्पैक्ट `SqlPanel` पेलोड लेता है और डैशबोर्ड द्वारा उपयोग किए जाने वाले समान चार्ट घटक को प्रस्तुत करता है। यह अभी भी एक ऐप एंबेड है, कोई साधारण HTML MCP ऐप नहीं। इसे सामान्य क्रिया के माध्यम से उजागर करें या कॉल करें / `open_app({ path, embed: true })`, URL को नियतात्मक रखें, और `embedApp()` को उस रूट को इनलाइन रेंडर करने दें।
+
+उत्पाद UI के लिए एकमुश्त सादे HTML MCP ऐप्स को हाथ से न लिखें; यदि कार्रवाई के लिए एक कस्टम सतह की आवश्यकता है, तो पहले एक वास्तविक ऐप रूट/घटक जोड़ें या पुन: उपयोग करें और उस रूट को एम्बेड करें।
+
+```an-diagram title="MCP App embed round-trip" summary="The action's link target is also the embed target. Capable hosts load the same signed app route inline; everyone else falls back to the deep link."
+{
+  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">exchanges one-time SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">real React route</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">no MCP Apps support</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
+"css": ".diagram-embed{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-embed .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:140px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .diagram-fallback{display:flex;flex-direction:column;align-items:center;gap:6px;margin-inline-start:8px}"
+}
+
+```
+
+```ts
+import { embedApp } from "@agent-native/core";
+
+export default defineAction({
+  // ...description, schema, run, link...
+  mcpApp: {
+    resource: embedApp({
+      title: "Review draft",
+      description: "Open the generated draft in the real Mail compose UI.",
+      iframeTitle: "Agent-Native Mail",
+      openLabel: "Open in Mail",
+    }),
+  },
+});
+```
+
+```an-annotated-code title="The mcpApp resource config"
+{
+  "filename": "actions/review-draft.ts",
+  "language": "ts",
+  "code": "import { embedApp } from \"@agent-native/core\";\n\nexport default defineAction({\n  // ...description, schema, run, link...\n  mcpApp: {\n    resource: embedApp({\n      title: \"Review draft\",\n      description: \"Open the generated draft in the real Mail compose UI.\",\n      iframeTitle: \"Agent-Native Mail\",\n      openLabel: \"Open in Mail\",\n    }),\n  },\n});",
+  "annotations": [
+    { "lines": "6", "label": "Progressive enhancement", "note": "`mcpApp.resource` advertises an inline UI for hosts that support the MCP Apps extension. Keep the action's `link` builder too — CLI-only and older hosts ignore the UI metadata and still need the deep link." },
+    { "lines": "7", "label": "Embed = the link target", "note": "`embedApp()` uses the action's `link` as its launch target: it calls `create_embed_session`, exchanges a one-time SQL ticket at `/_agent-native/embed/start`, and navigates the MCP App frame to the same signed app route." },
+    { "lines": "11", "label": "Universal fallback label", "note": "`openLabel` is the visible `\"Open in … →\"` text used as the deep-link escape hatch when a host does not render the inline iframe." }
+  ]
+}
+```
+
+MCP सर्वर एक्सटेंशन `io.modelcontextprotocol/ui` का विज्ञापन करता है, `tools/list` में `_meta.ui.resourceUri` प्लस `_meta["ui/resourceUri"]` जोड़ता है, और ChatGPT ऐप्स SDK संगतता मेटाडेटा (`openai/outputTemplate`, विजेट CSP/विवरण/पहुंच-योग्यता) भी उत्सर्जित करता है। यह MIME `text/html;profile=mcp-app` का उपयोग करके `resources/list`, `resources/templates/list` और `resources/read` के माध्यम से HTML को उजागर करता है। stdio प्रॉक्सी उन संसाधन संचालकों को लाइव ऐप से अग्रेषित करता है, इसलिए डेस्कटॉप और CLI क्लाइंट HTTP क्लाइंट के समान संसाधन देखते हैं।
+
+`mcpApp` जोड़ते समय भी मौजूदा `link` बिल्डर को रखें। CLI-केवल क्लाइंट, पुराने होस्ट और कोई भी होस्ट जो MCP ऐप्स को प्रस्तुत नहीं करता है, UI मेटाडेटा को अनदेखा कर देगा और फिर भी `"Open in … →"` लिंक की आवश्यकता होगी। `embedApp()` उस लिंक को अपने लॉन्च लक्ष्य के रूप में उपयोग करता है, केवल ऐप `create_embed_session` हेल्पर को कॉल करता है, `/_agent-native/embed/start` पर एक बार SQL टिकट का आदान-प्रदान करता है, और MCP ऐप फ्रेम को एक अल्पकालिक ब्राउज़र सत्र के साथ लक्ष्य मार्ग पर नेविगेट करता है और समान-मूल फ़ेच के लिए एक बियरर फ़ॉलबैक देता है। `open_app({ app, path, embed: true })` पूर्ण डैशबोर्ड, फ़िल्टर किए गए इनबॉक्स, कैलेंडर ड्राफ्ट दृश्य, विश्लेषण और एक्सटेंशन पेज जैसे मार्गों के लिए सामान्य एस्केप हैच है, और इसका उपयोग उदारतापूर्वक तब किया जाना चाहिए जब पूर्ण ऐप सबसे स्पष्ट समीक्षा/संपादन सतह हो।
+
+`embedApp()` में संसाधन CSP में MCP अनुरोध मूल शामिल है ताकि लॉन्चर ला सके और, जब स्पष्ट रूप से अनुरोध किया जाए, तो हस्ताक्षरित प्रथम-पक्ष ऐप रूट को फ्रेम कर सके। डिस्पैच अपने `open_app` संसाधन में दिए गए ऐप्स के सटीक मूल को जोड़ता है ताकि एक एकल डिस्पैच कनेक्टर प्रत्येक HTTPS मूल की अनुमति दिए बिना मेल, कैलेंडर, स्लाइड और बाकी को इनलाइन कर सके। कस्टम MCP ऐप के लिए केवल अतिरिक्त फ़्रेम या संसाधन डोमेन पास करें जो वास्तव में एक तृतीय-पक्ष प्लेयर को एम्बेड करता है या तृतीय-पक्ष संपत्तियों को लोड करता है।
+
+उन `embedApp()` मार्गों के अंदर, `sendToAgentChat()` एम्बेड-जागरूक है। ऑटो-सबमिट किए गए संकेत MCP होस्ट को `ui/update-model-context` प्लस `ui/message` के रूप में रिले करते हैं, इसलिए एम्बेडेड ऐप में एक बटन जानबूझकर चयनित ऐप स्थिति से Claude/ChatGPT वार्तालाप जारी रख सकता है। छिपे हुए संदर्भ को मॉडल संदर्भ के रूप में भेजा जाता है; दृश्यमान उपयोगकर्ता मोड़ केवल ऐप का संकेत रहता है, जो आंतरिक ऐप-स्टेट फ़ाइल पथों के आसपास डरावनी होस्ट सहमति से बचाता है। `submit: false` स्थानीय प्रीफ़िल/समीक्षा व्यवहार बना हुआ है।
+
+## प्रथम श्रेणी MCP ऐप ब्रिज {#mcp-app-bridge}
+
+MCP ऐप एम्बेड रूट एम्बेड हैं, अलग-अलग मिनी-उत्पाद नहीं। `embedApp()` कार्रवाई के `link` लक्ष्य से शुरू होता है, एक अल्पकालिक एम्बेड सत्र बनाता है, और उस हस्ताक्षरित ऐप रूट को लॉन्च करता है। मानक MCP ऐप्स होस्ट MCP ऐप फ़्रेम को स्वयं नेविगेट कर सकते हैं जब होस्ट सीधे रूट को हाइड्रेट कर सकता है।
+
+```an-diagram title="Two host bridge paths, one signed route" summary="Claude transplants the hydrated route and uses the direct ui/_bridge; ChatGPT gets a controlled iframe via window.openai and relays host actions over postMessage. Both point at the same signed app route."
+{
+  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">hydrates signed app HTML in Claude's iframe, then direct`ui/_` host bridge</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">normal route + React components</small></div></div>",
+"css": ".diagram-bridge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-bridge .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-bridge .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;max-width:300px}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}.diagram-bridge .diagram-box{padding:16px 18px;text-align:center}"
+}
+
+```
+
+Claude वेब एक सिंगल-फ्रेम ट्रांसप्लांट पथ का उपयोग करता है: संसाधन दस्तावेज़ हस्ताक्षरित ऐप HTML को लाता है और इसे Claude के MCP ऐप आईफ्रेम के अंदर हाइड्रेट करता है क्योंकि Claude विश्वसनीय रूप से ऐप के स्वामित्व वाले चाइल्ड आईफ्रेम या बाहरी फ्रेम नेविगेशन की अनुमति नहीं देता है। ChatGPT वेब को एक नियंत्रित रूट आईफ्रेम मिलता है क्योंकि इसका ऐप्स ब्रिज हमें स्थिर `window.openai` होस्ट APIs और सीमित ऊंचाई नियंत्रण देता है। सभी पथ एक ही हस्ताक्षरित ऐप रूट पर इंगित करते हैं और सामान्य रूट और React घटकों को प्रस्तुत करते हैं। एम्बेडेड मार्गों को डिज़ाइन करें ताकि समान हस्ताक्षरित URL के साथ पुनः लोड करने पर समान दृश्य का पुनर्निर्माण हो सके।
+
+समान-ऐप `open_app({ embed: true })` के लिए, फ्रेमवर्क मूल टूल कॉल के दौरान एंबेड-स्टार्ट टिकट को मिंट करता है और हस्ताक्षरित स्टार्ट URL को छिपे हुए टूल मेटाडेटा में संग्रहीत करता है। कस्टम actions उसी तेज़ पथ के लिए `embedStartUrl` लौटा सकता है; MCP परत मॉडल-दृश्य `structuredContent` और सामान्य ओपन-लिंक मेटाडेटा से टिकट-असर URL को अलग करती है। जब कोई एम्बेड स्टार्ट URL मौजूद नहीं होता है, तो संसाधन केवल ऐप `create_embed_session` हेल्पर पर वापस आ जाता है। यह उत्पादन होस्ट को बनाए रखता है जो एक बार के ऐप सत्र URLs को ट्रांसक्रिप्ट में लीक किए बिना सीधे रूट पर आईफ्रेम-आरंभित टूल कॉल को प्रतिबंधित करता है। यदि कोई उपयोगकर्ता एक बार के प्रारंभ टिकट की समय सीमा समाप्त होने के बाद पुरानी चैट को फिर से खोलता है, तो प्रारंभ मार्ग एक छोटा ताज़ा पृष्ठ लौटाता है और रैपर पर `agentNative.embedSessionExpired` पोस्ट करता है; `embedApp()` पुरानी शुरुआत URL को साफ़ करता है और `create_embed_session` के माध्यम से एक नया टिकट बनाता है जब उसके पास अभी भी मूल ऐप रूट होता है।
+
+ChatGPT को `window.openai` के माध्यम से एक समर्पित संगतता पथ मिलता है: लॉन्च दस्तावेज़ सीधे `toolInput`, `toolOutput`, और `toolResponseMetadata` पढ़ता है, फिर `window.openai.callTool(...)` के माध्यम से `create_embed_session` को कॉल करता है। मानक MCP ऐप्स होस्ट `ui/*` JSON-RPC ब्रिज का उपयोग करते हैं। सीधे हाइड्रेटेड मार्ग होस्ट ब्रिज हेल्पर्स के माध्यम से `ui/update-model-context`, `ui/message`, `ui/open-link` और `ui/request-display-mode` को कॉल कर सकते हैं। Claude का प्रत्यारोपित मार्ग जलयोजन के बाद उसी प्रत्यक्ष `ui/*` होस्ट ब्रिज का उपयोग करता है। जब ChatGPT या स्पष्ट डायग्नोस्टिक iframe पथ का उपयोग किया जाता है, तो रैपर `agentNative.mcpHost.*` पोस्टमैसेज अनुरोधों पर उसी होस्ट actions को रिले करता है। दोनों पथों के लिए परिणाम का आकार समान रखें: एक केंद्रित `link` और संक्षिप्त संरचित सामग्री लौटाएं।
+
+किसी ऐप URL पर मानक `_meta.ui.domain` सेट न करें। MCP ऐप्स उस फ़ील्ड को होस्ट-विशिष्ट मानते हैं: Claude `{hash}.claudemcpcontent.com`-शैली सैंडबॉक्स डोमेन को मान्य करता है, जबकि ChatGPT अपने स्वयं के `openai/widgetDomain` मेटाडेटा का उपयोग करता है। `ui.domain` को तब तक छोड़ें जब तक कि आप जानबूझकर होस्ट-विशिष्ट मान उत्सर्जित नहीं कर रहे हों; होस्ट एक डिफ़ॉल्ट सैंडबॉक्स मूल का चयन करेगा।
+
+एक्सटेंशन पेज दूसरे रूट आईफ्रेम पर नेविगेट किए बिना अपने सैंडबॉक्स को MCP चैट एम्बेड में रखते हैं। सामान्य ऐप उपयोग `/_agent-native/extensions/:id/render` को सैंडबॉक्स्ड चाइल्ड आईफ्रेम के रूप में प्रस्तुत करता है। MCP चैट ब्रिज मोड में फ्रेमवर्क रूट आईफ्रेम के अंदर सैंडबॉक्स किए गए `srcDoc` के समान एक्सटेंशन दस्तावेज़ प्रस्तुत करता है, `sandbox="allow-scripts allow-forms"` को संरक्षित करते हुए होस्ट `frame-ancestors` / `X-Frame-Options` विफलताओं से बचता है।
+
+संसाधन शेल बाहरी होस्ट आकार का स्वामी है। `embedApp({ height })` डिफ़ॉल्ट रूप से `560px` पर सेट होता है, शेल को `320-900px` पर क्लैंप करता है, और छोटे टूलबार के लिए `44px` को आरक्षित करता है, इसलिए रूट व्यूपोर्ट `height - 44px` है। एम्बेडेड ऐप रूट को आंतरिक रूप से स्क्रॉल करने योग्य रखें और लॉन्चर को पूर्ण दस्तावेज़ ऊंचाई के बजाय आंतरिक ऊंचाई की रिपोर्ट करने दें; अन्यथा होस्ट स्वतः-आकार एक सामान्य ऐप पेज को बहुत लंबे चैट आर्टिफैक्ट में बदल सकता है। बदला हुआ शेल केवल नए MCP ऐप संसाधनों और नए टूल कॉल को प्रभावित करता है। पुराने ChatGPT/Claude वार्तालाप फ़्रेम पिछले संसाधन व्यवहार को बनाए रख सकते हैं, इसलिए किसी समाधान का निर्णय लेने से पहले एक ताज़ा इनलाइन रेंडर के साथ आकार को सत्यापित करें।
+
+### एम्बेड मोड {#embed-modes}
+
+Claude डिफ़ॉल्ट रूप से सिंगल-फ़्रेम ट्रांसप्लांट पथ का उपयोग करता है। होस्ट मॉड्यूल-लोडिंग व्यवहार को डीबग करते समय आप इसे `embedMode: "transplant"` या `frame: "transplant"` के साथ अन्य होस्ट में भी लागू कर सकते हैं। आप नेस्टेड डायग्नोस्टिक iframe को `embedMode: "iframe"`, `renderMode: "iframe"`, `nested: true`, या `frame: "iframe"` के साथ बाध्य कर सकते हैं। यदि आईफ्रेम अवरुद्ध है, तो `embedApp()` इसे एक ओपन-ऐप फ़ॉलबैक के साथ बदल देता है: उपयोगकर्ता इनलाइन पुनः प्रयास कर सकता है, होस्ट के माध्यम से एक ताज़ा निर्मित एम्बेड सत्र खोल सकता है, या दृश्यमान मार्ग URL का उपयोग कर सकता है। कार्रवाई के `link` लक्ष्य को अपने आप में उपयोगी रखें क्योंकि यह अभी भी सार्वभौमिक पलायन हैच है।
+
+ngrok के माध्यम से Claude का परीक्षण करते समय, एक प्रोडक्शन बिल्ड (`npx @agent-native/core@latest build` फिर `npx @agent-native/core@latest start`) या एक तैनात पूर्वावलोकन/उत्पादन URL का उपयोग करें। Claude का सिंगल-फ्रेम ट्रांसप्लांट पथ उत्पादन परिसंपत्ति खंडों के साथ काम करता है; `/app/root.tsx` जैसे कच्चे Vite डेव मॉड्यूल को ऐप ऑथ द्वारा संरक्षित किया जा सकता है और Claude संसाधन मूल से गतिशील आयात को विफल किया जा सकता है।
+
+## मेजबान पुल API {#host-bridge}
+
+मेज़बान पुल जानबूझकर छोटा है:
+
+| मोड                    | संदेश प्रकार                          | इसके लिए इसका उपयोग करें                        |
+| ---------------------- | ------------------------------------- | ----------------------------------------------- |
+| प्रत्यक्ष होस्ट मार्ग  | `ui/update-model-context`             | होस्ट मॉडल के लिए छिपा हुआ संदर्भ               |
+| प्रत्यक्ष होस्ट मार्ग  | `ui/message`                          | एक दृश्यमान उपयोगकर्ता को होस्ट में पोस्ट करें  |
+| प्रत्यक्ष होस्ट मार्ग  | `ui/open-link`                        | होस्ट के माध्यम से एक बाहरी या ऐप URL खोलें     |
+| प्रत्यक्ष होस्ट मार्ग  | `ui/request-display-mode`             | `inline`, `fullscreen`, या `pip` का अनुरोध करें |
+| Claude प्रत्यारोपण     | `ui/*`                                | हाइड्रेशन के बाद वही डायरेक्ट होस्ट ब्रिज       |
+| ChatGPT / iframe मार्ग | `agentNative.mcpHostContext`          | थीम, स्थान, होस्ट प्लेटफ़ॉर्म, आयाम             |
+| ChatGPT / iframe मार्ग | `agentNative.embeddedAppReady`        | आईफ्रेम लोड किए गए रूट की पुष्टि करें           |
+| ChatGPT / iframe मार्ग | `agentNative.mcpHost.*` / `.response` | होस्ट अनुरोधों के लिए रैपर रिले                 |
+
+एम्बेडेड रूट `@agent-native/core/client` से `updateMcpAppModelContext()`, `openMcpAppHostLink()`, `requestMcpAppDisplayMode()`, `getMcpAppHostContext()` और `useMcpAppHostContext()` का उपयोग कर सकते हैं। `sendToAgentChat()` स्वतः सबमिट किए गए संकेतों के लिए पूर्ण-ऐप एम्बेड से समान पथ का उपयोग करता है।
+
+डिस्प्ले मोड सर्वोत्तम प्रयास है। इन-ऐप `McpAppRenderer` वर्तमान में एक इनलाइन वेब होस्ट संदर्भ और एक इनलाइन-केवल डिस्प्ले मोड की रिपोर्ट करता है; बाहरी होस्ट बड़े प्रदर्शन अनुरोधों का सम्मान कर सकते हैं, उन्हें अनदेखा कर सकते हैं, या असमर्थित-मोड त्रुटि के साथ उत्तर दे सकते हैं। इनलाइन रूट को हमेशा प्रयोग योग्य रखें।
+
+## क्लाइंट समर्थन और कैशिंग {#client-support}
+
+वर्तमान आधिकारिक MCP ऐप्स क्लाइंट सूची में Claude, Claude डेस्कटॉप, VS कोड GitHub कोपायलट, गूज़, पोस्टमैन, MCPJam, ChatGPT और कर्सर शामिल हैं; होस्ट समर्थन अभी भी योजना, रिलीज़ चैनल और क्लाइंट संस्करण के अनुसार भिन्न होता है, इसलिए [MCP extension support matrix](https://modelcontextprotocol.io/extensions/client-matrix) की जाँच करें। ChatGPT कस्टम MCP ऐप्स ChatGPT वेब पर बिजनेस और एंटरप्राइज/एजु वर्कस्पेस के लिए डेवलपर मोड के माध्यम से उपलब्ध हैं; OpenAI के [developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-apps-in-chatgpt-beta) नोट्स देखें।
+
+Claude कोड, Codex, और अन्य CLI/कोड-एडिटर क्लाइंट अभी भी वही संसाधन और मेटाडेटा प्राप्त करते हैं जब वे MCP ऐप्स का समर्थन करते हैं, लेकिन उन्हें लिंक-आउट होस्ट के रूप में मानें जब तक कि आपने उस सटीक सतह में इनलाइन आईफ्रेम रेंडरिंग को सत्यापित नहीं किया हो। जब कोई होस्ट किसी आईफ्रेम को रेंडर नहीं करने का विकल्प चुनता है तो डीप लिंक विश्वसनीय फ़ॉलबैक बना रहता है। व्यवहार में, प्रत्येक एजेंट-नेटिव ऐप को दोनों के साथ लिखा जाना चाहिए: सक्षम होस्ट में इनलाइन समीक्षा/संपादन के लिए MCP ऐप्स, और पूर्ण ऐप पर यूनिवर्सल राउंड-ट्रिपिंग के लिए `link`।
+
+Claude और ChatGPT मौजूदा कस्टम कनेक्टर के लिए टूल और संसाधन मेटाडेटा को कैश कर सकते हैं। MCP ऐप मेटाडेटा बदलने के बाद, एक नए टूल कॉल से सत्यापित करें; यदि होस्ट अभी भी पुराने डिस्क्रिप्टर का उपयोग करता है, तो Claude कनेक्टर को फिर से कनेक्ट करें या ChatGPT कनेक्टर को फिर से स्कैन/समीक्षा करें ताकि यह कैटलॉग को ताज़ा कर सके। यदि Claude तैनाती के बाद टूल डिस्क्रिप्टर पर रहने वाले `_meta.ui.csp` या `_meta.ui.permissions` के बारे में चेतावनी लॉग करता है, तो वह कनेक्टर पुराने मेटाडेटा का उपयोग कर रहा है: Claude कनेक्टर को हटाएं/पुनः कनेक्ट करें और एक नई चैट शुरू करें।
+
+## परीक्षण {#testing}
+
+`embedApp()` और `McpAppRenderer` के आसपास हल्के फिक्स्चर के साथ MCP ऐप्स का परीक्षण करें; वे वास्तविक बाहरी होस्ट की आवश्यकता के बिना CSP, होस्ट संदर्भ, ऐप लॉन्च और ब्रिज संदेश व्यवहार को कवर करते हैं। ChatGPT या Claude वेब को मान्य करते समय, शेल परिवर्तन के बाद एक नया टूल कॉल ट्रिगर करें और दृश्यमान आईफ्रेम को मापें। उसी वार्तालाप में पहले रेंडर किए गए फ़्रेम अभी भी कैश्ड ऊंचाई या लॉन्च व्यवहार दिखा सकते हैं।
+
+## संबंधित {#related}
+
+- [External Agents](/docs/external-agents) - Claude, ChatGPT, Codex और कर्सर को होस्ट किए गए ऐप्स से कनेक्ट करना; MCP ऐप्स संगतता मैट्रिक्स; कैटलॉग स्तर; गहरे लिंक.
+- [MCP Protocol](/docs/mcp-protocol) - ऑटो-माउंटेड MCP सर्वर, ऑथ, टूल्स और `ask-agent`।
+- [Actions](/docs/actions) - `defineAction`, `link` बिल्डर, `publicAgent`।
+
+```
+
+```

package/corpus/core/docs/content/locales/hi-IN/mcp-clients.md

@@ -0,0 +1,330 @@
+---
+title: "MCP ग्राहक"
+description: "अपने एजेंट-नेटिव ऐप को स्थानीय MCP सर्वर (क्लाउड-इन-क्रोम, फ़ाइल सिस्टम, प्लेराइट इत्यादि) से कनेक्ट करें ताकि एजेंट को उनके टूल प्राप्त हो सकें।"
+---
+
+# MCP ग्राहक
+
+**यह पेज: अपने एजेंट को अधिक टूल दें।** एक एजेंट-नेटिव ऐप को MCP सर्वर - स्थानीय या रिमोट - पर इंगित करें ताकि उनके टूल एजेंट चैट में दिखाई दें। यह _क्लाइंट_ दिशा है, [MCP Protocol](/docs/mcp-protocol) की दर्पण छवि (जो आपके ऐप को MCP _सर्वर_ बनाती है)।
+
+| यदि आप चाहते हैं…                                               | पढ़ें                                    |
+| --------------------------------------------------------------- | ---------------------------------------- |
+| किसी बाहरी एजेंट/होस्ट को अपने ऐप से कनेक्ट करें                | [External Agents](/docs/external-agents) |
+| अपने एजेंट को अधिक टूल दें (अन्य MCP सर्वर का उपभोग करें)       | **यह पृष्ठ** — MCP ग्राहक                |
+| इनलाइन UI बनाएं जो Claude/ChatGPT में प्रस्तुत हों              | [MCP Apps](/docs/mcp-apps)               |
+| निचले स्तर का MCP सर्वर संदर्भ (प्रमाणीकरण, उपकरण, कस्टम माउंट) | [MCP Protocol](/docs/mcp-protocol)       |
+
+एक कॉन्फ़िगरेशन फ़ाइल के साथ, आपके कार्यक्षेत्र में प्रत्येक एजेंट-नेटिव ऐप आपकी मशीन पर MCP सर्वर द्वारा प्रदान किए गए टूल तक पहुंच प्राप्त करता है: ब्राउज़र स्वचालन के लिए `claude-in-chrome`, फ़ाइलों को पढ़ने के लिए `@modelcontextprotocol/server-filesystem`, ब्राउज़र परीक्षण के लिए `@playwright/mcp`, और कुछ भी जो MCP बोलता है।
+
+आप कॉन्फ़िगरेशन फ़ाइल को संपादित किए बिना भी [connect remote (HTTP) MCP servers at runtime](#remote-via-ui) - व्यक्तिगत उपयोगकर्ता या संपूर्ण संगठन - कर सकते हैं।
+
+प्रत्येक स्रोत एक रनटाइम **MCP प्रबंधक** में हल हो जाता है, और प्रत्येक उपकरण जिसे वह सीखता है वह टकराव-प्रूफ `mcp__<server-id>__<tool>` उपसर्ग के तहत एजेंट की टूल रजिस्ट्री में लैंड करता है - जिसे `tool-search` के माध्यम से इरादे से खोजा जा सकता है।
+
+```an-diagram title="Client direction: many sources, one tool registry" summary="Config files, env, and runtime UI all merge into the MCP manager; its tools appear prefixed and tool-searchable alongside your app's actions. This is the mirror of the server direction."
+{
+  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">shared across apps</small></div><div class=\"diagram-box\" data-rough>App-root <code>mcp.config.json</code><br><small class=\"diagram-muted\">per-app override</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / production</small></div><div class=\"diagram-box\" data-rough>Remote via settings UI<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP manager</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent tool registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">discover by intent</small></div></div></div>",
+  "css": ".mcp-merge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-merge .diagram-col{display:flex;flex-direction:column;gap:8px}.mcp-merge .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-merge .diagram-arrow{font-size:22px;line-height:1}.mcp-merge code{font-size:.85em}"
+}
+```
+
+> विपरीत दिशा - _अपने_ ऐप को एक MCP सर्वर बनाना जिसका अन्य होस्ट उपभोग करते हैं - [MCP Protocol](/docs/mcp-protocol) और [External Agents](/docs/external-agents) में रहता है।
+
+## अंतर्निहित ब्राउज़र और कंप्यूटर-उपयोग क्षमताएं {#built-in-capabilities}
+
+एजेंट-नेटिव में सामान्य stdio MCP सर्वर के लिए स्थानीय-विकास टॉगल शामिल हैं।
+वे डिफ़ॉल्ट रूप से बंद हैं और केवल प्रति उपयोगकर्ता या प्रति संगठन सक्षम किए जा सकते हैं
+जब ऐप स्थानीय रूप से चल रहा हो। उत्पादन और होस्ट किए गए सर्वर रहित रनटाइम छोड़ें
+ये बिल्ट-इन भले ही पुरानी सेटिंग्स पंक्तियाँ मौजूद हों, और वर्कस्पेस संसाधन
+पेड़ उन्हें डिफ़ॉल्ट `mcp-servers/*.json` संसाधनों के रूप में नहीं दिखाता है।
+
+| क्षमता            | सर्वर आईडी        | कमांड                                                                   |
+| ----------------- | ----------------- | ----------------------------------------------------------------------- |
+| क्रोम डेवटूल्स    | `chrome-devtools` | `npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics` |
+| नाटककार ब्राउज़र  | `playwright`      | `npx -y @playwright/mcp@latest`                                         |
+| कंप्यूटर का उपयोग | `computer-use`    | `npx -y computer-use-mcp@latest`                                        |
+
+एक समय में एक दायरे में केवल एक ब्राउज़र क्षमता सक्षम की जा सकती है। Chrome DevTools को सक्षम करने से उसी उपयोगकर्ता या संगठन के लिए Playwright अक्षम हो जाता है, और Playwright को सक्षम करने से Chrome DevTools अक्षम हो जाता है।
+
+कंप्यूटर का उपयोग केवल macOS के लिए है। अन्य प्लेटफ़ॉर्म पर इसे अनुपलब्ध के रूप में सूचीबद्ध किया गया है और पुरानी सेटिंग पंक्ति में इसे शामिल करने पर भी इसे छोड़ दिया गया है।
+
+Chrome DevTools डिफ़ॉल्ट रूप से `--autoConnect` का उपयोग करता है। यह एक योग्य चल रहे क्रोम इंस्टेंस से जुड़ जाता है; यह आपके लिए एक अलग ब्राउज़र प्रोफ़ाइल नहीं बनाता है या उपयोगकर्ता की नियमित प्रोफ़ाइल में साइन इन नहीं करता है। इसके लिए रिमोट डिबगिंग सक्षम के साथ Chrome 144+ की आवश्यकता है। मैन्युअल `browser-url` कॉन्फ़िगरेशन को बाद में जोड़ा जा सकता है जब किसी परिनियोजन को एक विशिष्ट डिबगिंग एंडपॉइंट की आवश्यकता होती है।
+
+व्यक्तिगत टॉगल के लिए `u:<email>:mcp-builtin-capabilities` और टीम टॉगल के लिए `o:<orgId>:mcp-builtin-capabilities` के तहत फ्रेमवर्क की `settings` तालिका में बिल्ट-इन मौजूद हैं। सक्षम होने पर, वे दूरस्थ सर्वर के समान स्कोप दृश्यता प्रारूप के साथ रनटाइम MCP प्रबंधक में विलय हो जाते हैं, उदाहरण के लिए `mcp__user_<emailhash>_playwright__*` या `mcp__org_<orgId>_chrome-devtools__*`।
+
+### उपयोगकर्ता-सामना वाले सेटअप नोट्स
+
+संवेदनशील बिल्ट-इन के लिए संक्षिप्त, स्पष्ट सेटअप प्रतिलिपि का उपयोग करें:
+
+- **Chrome DevTools** चल रहे Chrome डिबगिंग लक्ष्य से जुड़ जाता है। उपयोगकर्ताओं को बताएं
+  यह ब्राउज़र परीक्षण और लॉग-इन सत्यापन के लिए है, और यह
+  उपकरण प्रदर्शित होने से पहले Chrome रिमोट डिबगिंग को सक्षम करने की आवश्यकता हो सकती है।
+- **नाटककार** ने एक अलग ब्राउज़र लॉन्च किया। नियतिवादी
+  क्यूए जब उपयोगकर्ता की लाइव क्रोम प्रोफ़ाइल की आवश्यकता नहीं है।
+- **कंप्यूटर का उपयोग** स्थानीय ऐप्स संचालित कर सकता है। इसे डिफ़ॉल्ट रूप से बंद रखें, समझाएं
+  macOS स्क्रीन रिकॉर्डिंग और एक्सेसिबिलिटी संकेत देती है, और लेने से पहले पूछें
+  संवेदनशील actions जैसे खरीदारी, वित्तीय परिवर्तन, या खाता परिवर्तन।
+
+### अंतर्निहित समापनबिंदु
+
+| विधि | मार्ग                        | उद्देश्य                                                                         |
+| ---- | ---------------------------- | -------------------------------------------------------------------------------- |
+| GET  | `/_agent-native/mcp/builtin` | अंतर्निहित क्षमताओं, सक्षम स्कोप, मर्ज किए गए आईडी और लाइव स्थिति की सूची बनाएं। |
+| POST | `/_agent-native/mcp/builtin` | एक दायरा अद्यतन करें. बॉडी: `{ scope, enabledIds }` या `{ scope, id, enabled }`. |
+
+## एक स्थानीय MCP सर्वर जोड़ना {#adding-a-server}
+
+अपने वर्कस्पेस रूट पर (या एक व्यक्तिगत ऐप रूट पर `mcp.config.json` बनाएं - दोनों मौजूद होने पर वर्कस्पेस रूट जीत जाता है):
+
+```jsonc
+{
+  "$schema": "https://agent-native.com/schema/mcp.config.json",
+  "servers": {
+    "claude-in-chrome": {
+      "command": "claude-in-chrome-mcp",
+      "args": [],
+      "env": { "LOG_LEVEL": "info" },
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"],
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem@latest",
+        "/Users/me/projects",
+      ],
+    },
+  },
+}
+```
+
+आकार छोटा है: सर्वर आईडी द्वारा कुंजीबद्ध एक `servers` मानचित्र, जहां प्रत्येक प्रविष्टि या तो एक stdio लॉन्चर (`command` + `args` + वैकल्पिक `env`) या एक दूरस्थ `{ "type": "http", "url", "headers" }` प्रविष्टि है।
+
+```an-annotated-code title="mcp.config.json, annotated"
+{
+  "filename": "mcp.config.json",
+  "language": "jsonc",
+  "code": "{\n  \"$schema\": \"https://agent-native.com/schema/mcp.config.json\",\n  \"servers\": {\n    \"claude-in-chrome\": {\n      \"command\": \"claude-in-chrome-mcp\",\n      \"args\": [],\n      \"env\": { \"LOG_LEVEL\": \"info\" }\n    },\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem@latest\", \"/Users/me/projects\"]\n    }\n  }\n}",
+  "annotations": [
+    { "lines": "3", "label": "Server id", "note": "The key becomes the tool prefix: this server's tools surface as `mcp__claude-in-chrome__*` in the agent's registry, so they can't collide with your template's actions." },
+    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` spawn a local binary. Stdio servers are intended for **local development** — they are a no-op in edge runtimes." },
+    { "lines": "6", "label": "Process env", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
+  ]
+}
+```
+
+अगले ऐप प्रारंभ पर आप देखेंगे:
+
+```
+[mcp-client] loaded config from /path/to/mcp.config.json (3 server(s))
+[mcp-client] connected to claude-in-chrome: 12 tools
+[mcp-client] connected to playwright: 9 tools
+[mcp-client] connected to filesystem: 4 tools
+```
+
+उपकरण एजेंट की टूल रजिस्ट्री में उपसर्ग `mcp__<server-id>__<tool-name>` के साथ पंजीकृत हैं ताकि वे आपके टेम्पलेट के actions से टकरा न सकें। वे `tool-search` में भी शामिल हैं, इसलिए एजेंट सामने सटीक नाम जोड़ने की आवश्यकता के बजाय इरादे से नई कनेक्टेड MCP क्षमताओं की खोज कर सकते हैं।
+
+## कॉन्फ़िगर प्राथमिकता {#precedence}
+
+MCP कॉन्फ़िगरेशन को इस क्रम में हल किया गया है, पहला मैच जीतता है:
+
+1. **वर्कस्पेस रूट `mcp.config.json`** - `package.json` में `agent-native.workspaceCore` के माध्यम से पता लगाया गया। कार्यक्षेत्र में प्रत्येक ऐप पर साझा किया गया।
+2. **ऐप-रूट `mcp.config.json`** - यदि आप नहीं चाहते कि प्रत्येक ऐप में MCP सर्वर उपलब्ध हो तो प्रति-ऐप ओवरराइड।
+3. **`MCP_SERVERS` env var** - समान आकार वाली JSON स्ट्रिंग, CI/उत्पादन के लिए जहां फ़ाइल का कोई मतलब नहीं है।
+
+## उत्पादन परिनियोजन: `MCP_SERVERS` {#mcp-servers-env}
+
+उत्पादन परिनियोजन के लिए, दूरस्थ HTTP MCP सर्वर को प्राथमिकता दें और पूर्ण कॉन्फ़िगरेशन सेट करें
+एक पर्यावरण चर के रूप में आकार (या आंतरिक सर्वर मानचित्र):
+
+```bash
+MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/mcp","headers":{"Authorization":"Bearer paste-token-value-here"}}}}'
+```
+
+`MCP_SERVERS` को JSON के रूप में पार्स किया गया है, इसलिए `${...}` प्लेसहोल्डर्स का विस्तार नहीं किया गया है
+स्ट्रिंग के अंदर। यदि आप टोकन को किसी अन्य गुप्त स्थान पर संग्रहीत करते हैं, तो पहले उसका विस्तार करें
+अंतिम JSON मान लिखना।
+
+Stdio MCP सर्वर स्थानीय बायनेरिज़ उत्पन्न करते हैं और स्थानीय विकास के लिए अभिप्रेत हैं।
+MCP उपकरण केवल नोड रनटाइम में सक्रिय होते हैं - क्लाउडफ्लेयर वर्कर्स और अन्य एज
+लक्ष्य चुपचाप MCP को छोड़ दें और बाकी ऐप के साथ काम करना जारी रखें
+सामान्यतः।
+
+## स्वतः पता लगाएं: `claude-in-chrome` {#autodetect}
+
+यदि आपके पास **नहीं** `mcp.config.json` है और `claude-in-chrome-mcp` बाइनरी `PATH` पर है (या प्रसिद्ध इंस्टॉल स्थान `~/.claude-in-chrome/bin/claude-in-chrome-mcp` में है), तो एजेंट-नेटिव इसे डिफ़ॉल्ट MCP सर्वर के रूप में स्वचालित रूप से पंजीकृत करता है। ऑप्ट आउट करने के लिए `AGENT_NATIVE_DISABLE_MCP_AUTODETECT=1` सेट करें।
+
+इसका मतलब है कि जिन उपयोगकर्ताओं ने क्लाउड-इन-क्रोम एक्सटेंशन इंस्टॉल किया है, उन्हें बिना किसी कॉन्फिग बदलाव के उनके द्वारा खोले जाने वाले प्रत्येक एजेंट-नेटिव ऐप पर ब्राउज़र नियंत्रण मिलता है।
+
+## सेटिंग्स UI के माध्यम से दूरस्थ MCP सर्वर {#remote-via-ui}
+
+MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर आपके एजेंट को नई क्षमताएं देते हैं - जैसे जैपियर, क्लाउडफ्लेयर, कंपोज़ियो या आपकी कंपनी के आंतरिक टूल से कनेक्ट करना। एक बार कनेक्ट होने के बाद, एजेंट उन टूल्स का उपयोग अपने बिल्ट-इन टूल्स की तरह ही कर सकता है।
+
+### दूरस्थ MCP सर्वर कैसे कनेक्ट करें
+
+1. **सर्वर नाम** — आपके स्वयं के संदर्भ के लिए एक संक्षिप्त लेबल (उदाहरण के लिए "ज़ैपियर", "स्लैक-टूल्स")।
+2. **URL** - MCP सर्वर प्रदाता द्वारा आपको दिया गया HTTPS एंडपॉइंट (उदाहरण के लिए `https://mcp.zapier.com/s/abc123/mcp`)। यह आमतौर पर प्रदाता के डैशबोर्ड या एकीकरण दस्तावेज़ों में पाया जाता है।
+3. **विवरण** (वैकल्पिक) - यह सर्वर क्या करता है इसके बारे में एक नोट।
+4. **हेडर** - सर्वर को प्रमाणीकरण क्रेडेंशियल की आवश्यकता होती है, प्रति पंक्ति एक। अधिकांश सर्वरों को `Authorization` हेडर की आवश्यकता होती है। उदाहरण: `Authorization: Bearer sk-your-key-here`. प्रदाता के दस्तावेज़ आपको बताएंगे कि यहां क्या डालना है।
+
+सहेजने से पहले कनेक्शन सत्यापित करने के लिए **परीक्षण** पर क्लिक करें। यदि यह सफल होता है, तो आप उपलब्ध टूल की संख्या देखेंगे। इसे जोड़ने के लिए **कनेक्ट** पर क्लिक करें।
+
+### व्यक्तिगत बनाम संगठन का दायरा
+
+दो दायरे समर्थित हैं:
+
+- **व्यक्तिगत** - केवल साइन-इन उपयोगकर्ता को ही उपकरण मिलते हैं। उपयोगकर्ता-क्षेत्र सेटिंग के रूप में संग्रहीत।
+- **टीम** - सक्रिय संगठन में सभी को उपकरण मिलते हैं। स्वामी और व्यवस्थापक जोड़ सकते हैं; सदस्य सूची को केवल पढ़ने के लिए देखते हैं। एक ऑर्ग-स्कोप सेटिंग के रूप में संग्रहीत।
+
+चल रहे MCP प्रबंधक में हॉट-रीलोड जोड़ता और हटाता है - कोई प्रक्रिया पुनरारंभ नहीं होती, और कोई सर्वर पुनरारंभ नहीं होता। नए `mcp__<scope>-<name>__*` उपकरण अगले संदेश पर एजेंट को दिखाई देते हैं और `tool-search` के माध्यम से खोजे जा सकते हैं।
+
+HTTPS URLs हर जगह स्वीकार किए जाते हैं; विकास के दौरान केवल `localhost` के लिए सादे `http://` की अनुमति है। वैकल्पिक प्रमाणीकरण एक बियरर टोकन के रूप में जाता है जो प्रत्येक अनुरोध पर `Authorization: Bearer …` के माध्यम से भेजा जाता है।
+
+हुड के तहत ये सर्वर फ्रेमवर्क की `settings` तालिका में कुंजी `u:<email>:mcp-servers-remote` (व्यक्तिगत) या `o:<orgId>:mcp-servers-remote` (टीम) के तहत बने रहते हैं और स्टार्टअप पर `mcp.config.json` के साथ विलय हो जाते हैं।
+
+### HTTP समापन बिंदु
+
+| विधि   | मार्ग                                                 | उद्देश्य                                                                          |
+| ------ | ----------------------------------------------------- | --------------------------------------------------------------------------------- |
+| GET    | `/_agent-native/mcp/servers`                          | वर्तमान उपयोगकर्ता के व्यक्तिगत + ऑर्ग सर्वर को लाइव स्थिति के साथ सूचीबद्ध करें। |
+| POST   | `/_agent-native/mcp/servers`                          | एक सर्वर जोड़ें. बॉडी: `{ scope, name, url, headers?, description? }`.            |
+| DELETE | `/_agent-native/mcp/servers/:id?scope=user\|org`      | Remove a server and reconfigure the manager.                                      |
+| POST   | `/_agent-native/mcp/servers/:id/test?scope=user\|org` | Dry-run the existing server's connect + list-tools.                               |
+| POST   | `/_agent-native/mcp/servers/test`                     | जारी रखने से पहले एक मनमाना URL को ड्राई-रन करें। बॉडी: `{ url, headers? }`.      |
+
+Stdio सर्वर अभी भी नोड रनटाइम के बाहर एक नो-ऑप हैं, लेकिन दूरस्थ HTTP MCP सर्वर `fetch` के साथ किसी भी वातावरण में काम करते हैं - जिसमें डेस्कटॉप उत्पादन बिल्ड भी शामिल है।
+
+## एक हब के माध्यम से साझा MCP सर्वर {#hub}
+
+यदि आपका कार्यक्षेत्र कई एजेंट-नेटिव ऐप्स (उदाहरण के लिए डिस्पैच + मेल + क्लिप) चलाता है, तो आप **एक** ऐप को हब के रूप में कॉन्फ़िगर कर सकते हैं और अन्य को इसके ऑर्ग-स्कोप MCP सर्वर को स्वचालित रूप से खींचने के लिए कह सकते हैं। URLs और बियरर टोकन की कोई प्रति-ऐप कॉपी-पेस्ट नहीं। डिस्पैच वर्कस्पेस MCP संसाधनों का उपयोग करके विहित दृष्टिकोण के लिए [Multi-App Workspace](/docs/multi-app-workspace) देखें।
+
+डिस्पैच पारंपरिक हब है - यह पहले से ही सभी ऐप्स में समन्वय करता है।
+
+```an-diagram title="Hub model: one app serves org-scope MCP servers" summary="Dispatch holds the org-scope MCP servers; consumer apps pull and merge them as mcp__hub_<orgId>_<name>__*. Only org-scope rows are shared — personal credentials stay put."
+{
+  "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">org-scope MCP servers</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></div><div class=\"diagram-col arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">pull + merge each ~60s</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
+  "css": ".mcp-hub{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-hub .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-hub .diagram-col{display:flex;flex-direction:column;gap:10px}.mcp-hub .arrows .diagram-arrow{font-size:22px;line-height:1}.mcp-hub .note{margin:8px 0 0;font-size:.85em}.mcp-hub code{font-size:.85em}"
+}
+```
+
+नए कार्यस्थान सेटअप के लिए, **जब आप कार्यस्थान MCP संसाधन भेजें** को प्राथमिकता दें
+कार्यस्थान skills द्वारा उपयोग किया जाने वाला समान ऑल-ऐप बनाम चयनित-ऐप अनुदान मॉडल चाहते हैं,
+निर्देश, और संदर्भ संसाधन। इसके साथ एक कार्यस्थान संसाधन जोड़ें:
+
+```json
+{
+  "type": "http",
+  "url": "https://example.com/mcp",
+  "headers": {
+    "Authorization": "Bearer ${keys.MCP_SERVER_TOKEN}"
+  },
+  "description": "Shared MCP tools for workspace apps"
+}
+```
+
+इसे `mcp-server` के साथ `mcp-servers/<name>.json` के अंतर्गत सहेजें। ऑल-ऐप
+संसाधन प्रत्येक कार्यक्षेत्र ऐप द्वारा लोड किए जाते हैं; चयनित संसाधन केवल
+सक्रिय डिस्पैच अनुदान वाले ऐप्स। गुप्त प्लेसहोल्डर ऐप से हल होते हैं
+गुप्त भंडार, इसलिए कच्चे वाहक टोकन को डिस्पैच वॉल्ट में रखें और उनका संदर्भ लें
+उन्हें संसाधन निकाय में संग्रहीत करने के बजाय `${keys.NAME}` के साथ।
+
+ऐप्स अपने मर्ज किए गए MCP कॉन्फिगरेशन को लगभग एक मिनट में एक बार रीफ्रेश करते हैं, इसलिए केंद्रीय संसाधन
+संपादन, अनुदान परिवर्तन और निष्कासन बिना परिनियोजन के प्रभावी होते हैं। सेट करें
+`AGENT_NATIVE_MCP_CONFIG_REFRESH_MS=0` उस बैकग्राउंड रिफ्रेश को अक्षम करने के लिए, या
+अंतराल को ट्यून करने के लिए इसे कम से कम `5000` मिलीसेकंड के मान पर सेट करें।
+
+नीचे दिया गया पुराना हब मोड मोटे तौर पर "हर ऑर्ग-स्कोप MCP को साझा करने" के लिए उपयोगी रहता है
+डिस्पैच से सर्वर” सेटअप और तैनाती के लिए जो पहले से ही MCP का उपयोग करते हैं
+UI को सत्य के स्रोत के रूप में सेट करें।
+
+### 1. हब ऐप (प्रेषण) पर हब-सर्व सक्षम करें
+
+डिस्पैच के परिनियोजन में एक env var सेट करें:
+
+```bash
+AGENT_NATIVE_MCP_HUB_TOKEN=<a-long-random-secret>
+```
+
+डिस्पैच अब `GET /_agent-native/mcp/hub/servers` को माउंट करता है जो अपनी `settings` तालिका में संग्रहीत प्रत्येक ऑर्ग-स्कोप MCP सर्वर को पूर्ण URL + हेडर के साथ, टोकन द्वारा प्रमाणित करता है।
+
+### 2. हब पर पॉइंट उपभोग करने वाले ऐप्स
+
+प्रत्येक उपभोक्ता पर सेट करें (मेल, क्लिप, जो भी हो):
+
+```bash
+AGENT_NATIVE_MCP_HUB_URL=https://dispatch.acme.com
+AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
+```
+
+स्टार्टअप पर, प्रत्येक उपभोक्ता हब की सर्वर सूची खींचता है और इसे अपने स्वयं के MCP प्रबंधक में विलय कर देता है। एजेंट को उपकरण `mcp__hub_<orgId>_<name>__*` के रूप में दिखाई देते हैं - उपभोक्ता के अपने स्थानीय `mcp__org_…` से अलग, इसलिए कोई टकराव नहीं होता है।
+
+### 3. क्या साझा किया जाता है
+
+केवल **ऑर्ग-स्कोप** सर्वर साझा किए जाते हैं। उपयोगकर्ता-स्कोप (व्यक्तिगत) सर्वर उस उपयोगकर्ता के पास रहते हैं जिसने उन्हें जोड़ा है - हब कभी भी ऐप्स में व्यक्तिगत क्रेडेंशियल्स को दोबारा उजागर नहीं करता है।
+
+हब प्रतिक्रियाओं में पूर्ण ऑथ हेडर (बियरर टोकन आदि) शामिल हैं। ट्रांसपोर्ट HTTPS है, समापन बिंदु को साझा रहस्य की आवश्यकता होती है, और यह केवल ऑर्ग-स्कोप पंक्तियाँ लौटाता है - हब URL + टोकन को डेटाबेस क्रेडेंशियल की तरह मानें।
+
+### 4. हॉट रीलोड बनाम रीस्टार्ट
+
+स्थानीय UI प्रत्येक ऐप में `McpClientManager.reconfigure()` के माध्यम से हॉट-रीलोड जोड़ता है - कोई पुनरारंभ नहीं। हब-सोर्स किए गए सर्वरों को उसी आवधिक बैकग्राउंड रिफ्रेश (लगभग 60 सेकंड, `AGENT_NATIVE_MCP_CONFIG_REFRESH_MS` के माध्यम से ट्यून करने योग्य या अक्षम करने योग्य) द्वारा उठाया जाता है, जिसे वर्कस्पेस संसाधन पथ उपयोग करता है, इसलिए डिस्पैच में किए गए परिवर्तन बिना पुनरारंभ किए लगभग एक मिनट के भीतर सभी उपभोक्ता ऐप्स में प्रसारित हो जाते हैं। इसके अतिरिक्त, किसी उपभोक्ता ऐप में कोई भी स्थानीय उत्परिवर्तन तुरंत उस ऐप के लिए पुन: कॉन्फ़िगर को ट्रिगर कर देता है।
+
+### समाप्ति बिंदु सारांश
+
+| विधि | मार्ग                            | उद्देश्य                                                                                                                                 |
+| ---- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| GET  | `/_agent-native/mcp/hub/servers` | सभी ऑर्ग-स्कोप सर्वरों को पूर्ण क्रेडिट के साथ परोसें (बेयरर-गेटेड, केवल तभी माउंट किया जाता है जब `AGENT_NATIVE_MCP_HUB_TOKEN` सेट हो)। |
+| GET  | `/_agent-native/mcp/hub/status`  | सेटिंग्स UI कार्ड के लिए `{ serving, consuming, hubUrl }` लौटाता है।                                                                     |
+
+## स्थिति मार्ग {#status-route}
+
+प्रत्येक ऐप टूलींग और ऑनबोर्डिंग के लिए `GET /_agent-native/mcp/status` को उजागर करता है:
+
+```an-api
+{
+  "method": "GET",
+  "path": "/_agent-native/mcp/status",
+  "summary": "MCP client status for tooling and onboarding",
+  "description": "Reports which configured servers connected, the total live tool count, the merged prefixed tool list, and any per-server connection errors. Use it to build \"detected — your agent can now drive X\" hints or to debug connection problems.",
+  "responses": [
+    {
+      "status": "200",
+      "description": "Configured vs connected servers, tool inventory, and per-server errors.",
+      "example": "{\n  \"configuredServers\": [\"claude-in-chrome\", \"playwright\"],\n  \"connectedServers\": [\"claude-in-chrome\", \"playwright\"],\n  \"totalTools\": 21,\n  \"tools\": [\n    {\n      \"source\": \"claude-in-chrome\",\n      \"name\": \"mcp__claude-in-chrome__navigate\",\n      \"description\": \"Navigate the browser to a URL\"\n    }\n  ],\n  \"errors\": {}\n}"
+    }
+  ]
+}
+```
+
+```json
+{
+  "configuredServers": ["claude-in-chrome", "playwright"],
+  "connectedServers": ["claude-in-chrome", "playwright"],
+  "totalTools": 21,
+  "tools": [
+    {
+      "source": "claude-in-chrome",
+      "name": "mcp__claude-in-chrome__navigate",
+      "description": "Navigate the browser to a URL"
+    }
+  ],
+  "errors": {}
+}
+```
+
+इसका उपयोग "क्लाउड-इन-क्रोम का पता चला - आपका एजेंट अब क्रोम चला सकता है" ऑनबोर्डिंग संकेत बनाने या MCP कनेक्शन समस्याओं को डीबग करने के लिए करें।
+
+## विफलता मोड {#failures}
+
+व्यक्तिगत MCP सर्वर विफलताएं कभी भी एजेंट को निष्क्रिय नहीं करतीं:
+
+- एक गलत कॉन्फ़िगर किया गया `command` → सर्वर छोड़ दिया गया है, इसकी त्रुटि `errors.<server-id>` के तहत `/mcp/status` में दिखाई देती है, और हर दूसरा सर्वर काम करना जारी रखता है।
+- MCP SDK `node_modules` से गायब है → सभी MCP कार्यक्षमता एक चेतावनी के साथ छोड़ दी गई है; एजेंट चैट शून्य MCP टूल के साथ काम करती रहती है।
+- एज रनटाइम में चल रहा है → MCP क्लाइंट नो-ऑप है।
+
+एजेंट-नेटिव हमेशा बूट होगा; टूटे हुए MCP कॉन्फ़िगरेशन का मतलब केवल कम उपकरण हैं।
+
+## सुरक्षा {#security}
+
+MCP उपकरण आपकी मशीन पर उत्पन्न प्रक्रिया की सभी अनुमतियों के साथ चलते हैं। `mcp.config.json` को किसी अन्य निष्पादन योग्य सूची की तरह समझें जिसे आप एजेंट को चलाने देना चाहते हैं। MCP सर्वर के उपकरण आपके टेम्पलेट के actions की तरह ही एजेंट के टूल-उपयोग लूप में दिखाई देते हैं, इसलिए सुनिश्चित करें कि आप अपने द्वारा कॉन्फ़िगर किए गए प्रत्येक सर्वर पर भरोसा करते हैं।