एक Zaru endpoint: आपके टूल, प्रोफ़ाइल और मंज़ूरियाँ

अन्य भाषाओं में: English, Español, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano · हिन्दी में सभी गाइड

खुलासा: Zaru को 100monkeys AI, Inc. बनाती है, इसलिए इस गाइड को निर्माता का विवरण मानकर पढ़ें। इसका मसौदा हमारे एक AI एजेंट ने Zaru दस्तावेज़ों से (29 अक्टूबर 2026 को पढ़े गए: Connect Zaru to Any MCP Client, MCP Tools, Profiles, API Keys, The Vault, Calendar, Refusals and Errors) तैयार किया, और कंपनी ने इसकी समीक्षा की; यह हिन्दी संस्करण अंग्रेज़ी में लिखी मूल गाइड का अनुवाद है। नीचे का हर कमांड, हेडर और संदेश उन्हीं पन्नों से लिया गया है; उद्धरण अंग्रेज़ी में ही रखे गए हैं और अनुवाद साथ में दिया गया है। जहाँ वे नहीं बताते कि कोई चीज़ कैसे काम करती है, वहाँ हम यही कहते हैं, उसका वर्णन नहीं करते।

आपका मेलबॉक्स, आपका कैलेंडर, एक GitHub token और एक Carbon Forge token Zaru में रह सकते हैं, और Claude Code एक ही पते से इन सब तक पहुँच सकता है। token Zaru में ही रहते हैं, प्रोफ़ाइल तय करती है कि कोई key इनमें से किसे छू सकती है, और जो कॉल कुछ भेजती या बदलती, वह Zaru Web में आपके जवाब का इंतज़ार करती है। यह गाइड zaru init से पहली रुकी हुई कॉल तक का रास्ता दिखाती है।

कदम 1. जो आपके टूल इस्तेमाल करेंगे उसे जोड़ें

Get Zaru free (Zaru मुफ़्त पाएँ) से रजिस्टर करें; इसमें केवल नाम और ईमेल चाहिए। Vault में Connections पेज एक Google मेलबॉक्स, Google Calendar, IMAP और SMTP वाला मेलबॉक्स, या CalDAV वाला कैलेंडर जोड़ता है। GitHub token या Carbon Forge MCP token New Credential से सहेजा जाता है। मान के बारे में दस्तावेज़ साफ़ हैं: "No agent, operator, API key or other person is given the value." (किसी एजेंट, ऑपरेटर, API key या किसी और व्यक्ति को वह मान नहीं दिया जाता।)

कदम 2. एक प्रोफ़ाइल बनाएँ

जब तक आप न बताएँ कि key किस तक पहुँच सकती है, वह किसी तक नहीं पहुँचती। API Keys पेज अपनी सूची के ऊपर यही कहता है: "A key reaches only the connections in the profile you choose for it; with no profile it reaches none." (key केवल उसके लिए चुनी गई प्रोफ़ाइल के कनेक्शनों तक पहुँचती है; प्रोफ़ाइल के बिना किसी तक नहीं।) एडिटर को जो कनेक्शन और टूल मिलने चाहिए, उनसे एक प्रोफ़ाइल बनाएँ; हर Zaru रन को केवल ज़रूरी कनेक्शन दें फ़ॉर्म को कदम-दर-कदम समझाती है।

कदम 3. API key बनाएँ और उसकी प्रोफ़ाइल चुनें

Settings → API Keys खोलें, New API Key दबाएँ, नाम दें, एक स्कोप प्रीसेट चुनें, key की प्रोफ़ाइल चुनें (डिफ़ॉल्ट None है), समाप्ति चुनें और Create दबाएँ। "The key value is shown once." (key का मान केवल एक बार दिखाया जाता है।)

कदम 4. Claude Code में endpoint जोड़ें

हर क्लाइंट एक ही पते https://mcp.myzaru.com/mcp/v1 से StreamableHTTP पर जुड़ता है, और key को Bearer token के रूप में भेजता है। Claude Code के लिए दस्तावेज़ यह देते हैं:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

उसी पेज पर Claude Desktop, Cursor, Windsurf, VS Code (GitHub Copilot) और Gemini CLI का सेटअप है, और StreamableHTTP बोलने वाले किसी भी क्लाइंट का।

कदम 5. zaru init टाइप करें

सत्र में असिस्टेंट से कहें:

zaru init

यह zaru.init टूल को कॉल करता है और Zaru की पर्सोना अपनाता है। zaru init agentic एक तय मोड में शुरू करता है। यह MCP सर्वर का टूल है; Zaru CLI गाइड वाले कमांड-लाइन प्रोग्राम का zaru init इससे अलग है और Zaru Web से नहीं जुड़ता।

कदम 6. ज़रूरत हो तो हर कनेक्शन के लिए प्रोफ़ाइल चुनें

key की प्रोफ़ाइल हर रिक्वेस्ट पर लागू होती है। इसके बजाय क्लाइंट x-zaru-contexts हेडर भेज सकता है, जिसमें केवल आरक्षित key @profile हो:

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

वह id दस्तावेज़ों का नमूना है। key पर, रिक्वेस्ट का @profile उस रिक्वेस्ट के लिए key की अपनी प्रोफ़ाइल की जगह ले लेता है, और पेश किए गए टूल उस प्रोफ़ाइल के हो जाते हैं। किसी और रूप का जवाब 400 होता है।

हेडर कहाँ जाता है, यह Connect Zaru to Any MCP Client पेज बताता है: "Every client above sends one header, Authorization, from its configuration. The same place takes a second header, x-zaru-contexts, which chooses for every request of that connection which of your connections its tools use." (ऊपर का हर क्लाइंट अपने कॉन्फ़िगरेशन से एक हेडर, Authorization, भेजता है। उसी जगह दूसरा हेडर, x-zaru-contexts, भी दिया जा सकता है, जो उस कनेक्शन की हर रिक्वेस्ट के लिए चुनता है कि उसके टूल आपके कौन-से कनेक्शन इस्तेमाल करें।) Claude Code में, दूसरा --header:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header 'x-zaru-contexts: {"@profile":"<profile id>"}'

JSON से कॉन्फ़िगर होने वाले क्लाइंट (Claude Desktop, Windsurf, VS Code) में यह headers के नीचे दूसरी एंट्री बनता है। "The profile's id is the last part of the address of its page in Zaru Web, ask.myzaru.com/vault/profiles/<profile id>." (प्रोफ़ाइल की id, Zaru Web में उसके पेज के पते का आख़िरी हिस्सा है।) एक बात दस्तावेज़ खुली छोड़ते हैं: "Whether a given client sends a header it was configured with on every request is the client's behaviour, not documented here." (कोई ख़ास क्लाइंट कॉन्फ़िगर किया गया हेडर हर रिक्वेस्ट पर भेजता है या नहीं, यह क्लाइंट का व्यवहार है, जिसका यहाँ दस्तावेज़ नहीं है।)

कदम 7. कनेक्शन इस्तेमाल करने वाली कॉल करें

क्लाइंट को प्रोफ़ाइल के कनेक्शन परिवारों के टूल दिखाए जाते हैं: मेलबॉक्स के लिए मेल टूल, कैलेंडर के लिए कैलेंडर टूल, और GitHub या Carbon Forge के लिए रिमोट सर्वर के टूल। जो मेल या कैलेंडर कॉल कोई मेलबॉक्स या खाता नहीं बताती, वह इकलौते वाले को, नहीं तो सबसे नए को इस्तेमाल करती है, और जवाब उसका नाम mailbox_name या account_name में देता है। कैलेंडर टूल के बारे में दस्तावेज़ कहते हैं: "Your Google token or your password never reaches an agent or the model." (आपका Google token या आपका पासवर्ड कभी किसी एजेंट या मॉडल तक नहीं पहुँचता।)

MCP Tools पेज उनके नाम बताता है: "The remote servers a person can connect today are GitHub and Carbon Forge (formerly Nuclear Notes)." (आज कोई व्यक्ति जो रिमोट सर्वर जोड़ सकता है, वे GitHub और Carbon Forge (पहले Nuclear Notes) हैं।) कस्टम SEAL गेटवे: जल्द आ रहे हैं।

कदम 8. इनकार को पढ़ें

जब AEGIS by 100monkeys.ai, बीटा में, कोई कॉल अस्वीकार करता है, तो क्लाइंट को isError: true वाला एक सामान्य टूल परिणाम मिलता है, जिसमें error.code, error.message और एक request_id होता है। दो इनकार पहुँच के बारे में हैं:

CREDENTIAL_BINDING_REQUIRED, कुछ भी चलने से पहले। बिना प्रोफ़ाइल वाली key पर: "This key reaches none of your connections. Choose a profile for it on the API keys page in Zaru Web, or name one in the request." (यह key आपके किसी कनेक्शन तक नहीं पहुँचती। Zaru Web के API keys पेज पर इसके लिए प्रोफ़ाइल चुनें, या रिक्वेस्ट में किसी का नाम दें।) जिस परिवार को आपने कभी नहीं जोड़ा, उसके लिए जवाब Connections पेज का नाम देता है।
TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this conversation." (यह टूल इस बातचीत के लिए चुनी गई प्रोफ़ाइल में नहीं है।)

हर इनकार में error.needs होता है, यानी परिवार और Zaru Web का वह पेज जो इसे सुलझाता है। किसी रन के लिए Zaru Web का कार्ड कहता है "This run has no profile that names your <family>." (इस रन की कोई प्रोफ़ाइल आपके <family> का नाम नहीं लेती।) और साथ में Open Profiles होता है। नीति वाला इनकार निर्धारक होता है, इसलिए कॉल दोहराने के बजाय उसे बदलें।

कदम 9. रुकी हुई कॉल का जवाब Zaru Web में दें

"Every tool that asks for approval waits at the person's approval gate, as a call from the chat does." (मंज़ूरी माँगने वाला हर टूल व्यक्ति के मंज़ूरी द्वार पर इंतज़ार करता है, जैसे चैट से आई कॉल करती है।) कॉल का जवाब {"status": "approval_pending", "approval_id", "summary", "message"} होता है, जिसका संदेश है "This waits for your answer in Zaru Web, under Approvals." (यह Zaru Web में, Approvals के तहत, आपके जवाब का इंतज़ार कर रहा है।) Approvals पेज पर जवाब दें; aegis.approval.status क्लाइंट से आपका जवाब पढ़ता है।

MCP Tools पेज बताता है कि myzaru.com पर कौन-सी कॉलें डिफ़ॉल्ट रूप से इंतज़ार करती हैं। टूल कैटलॉग mail.send, mail.reply, mail.forward, mail.delete और mail.archive पर, और कैलेंडर के चार लिखने वाले टूल calendar.create, calendar.update, calendar.delete और calendar.respond पर निशान लगाता है। डिप्लॉयमेंट का कॉन्फ़िगरेशन GitHub के चार लिखने वाले टूल github.merge_pull_request, github.push_files, github.create_or_update_file और github.delete_file पर, और साथ में aegis.git.push और aegis.system.info पर निशान लगाता है। "No Carbon Forge tool waits: neither the catalogue nor the configuration marks one, so a Carbon Forge call the key's profile admits runs at once." (Carbon Forge का कोई टूल इंतज़ार नहीं करता: न कैटलॉग किसी पर निशान लगाता है, न कॉन्फ़िगरेशन, इसलिए key की प्रोफ़ाइल जिस Carbon Forge कॉल को अनुमति देती है, वह तुरंत चलती है।) प्रोफ़ाइल फ़ॉर्म इंतज़ार करने वाले हर टूल पर "Needs your approval" (आपकी मंज़ूरी चाहिए) का निशान लगाता है। स्थायी "Always allow" (हमेशा अनुमति दें) चुनाव उसकी कॉलों का जवाब बिना पूछे दे देता है, इसलिए इंतज़ार डिफ़ॉल्ट है, वादा नहीं।