DataGrout

अधिकांश MCP क्लाइंट एक ही काम करते हैं: अनुरोध भेजना, प्रतिक्रिया प्राप्त करना। Conduit एक थोड़ी अलग समस्या के लिए बनाया गया है — एक एजेंट जिसे यह साबित करना होता है कि वह कौन है, लंबे सत्रों में बिना मैन्युअल पुनः-प्रमाणीकरण के काम करता रहे, और ऐसा करते समय लागत या नीति बजट के भीतर रहे। यही वह अंतर है जिसे यह SDK भरता है।

अंतर्निहित mTLS, OAuth 2.1 और सिमेंटिक टूल डिस्कवरी के साथ MCP क्लाइंट लाइब्रेरी। Python, TypeScript, Rust, Elixir और Ruby के लिए उपलब्ध।

एक ही import बदलें और मौजूदा एजेंट सर्टिफिकेट-आधारित पहचान, लागत दृश्यता और प्राकृतिक-भाषा टूल डिस्कवरी अपना लेता है — किसी अन्य कोड परिवर्तन की आवश्यकता नहीं।

क्या आपको SDK चाहिए, या केवल कच्चा एंडपॉइंट?

हर DataGrout सर्वर एक मानक MCP एंडपॉइंट प्रदान करता है — कोई भी MCP-संगत क्लाइंट केवल URL और bearer token के साथ सीधे उससे जुड़ सकता है, SDK की आवश्यकता नहीं। Conduit उन मामलों के लिए है जहाँ आप न्यूनतम से अधिक चाहते हैं:

• आप स्वयं token प्रबंधित करने के बजाय सर्टिफिकेट-आधारित (mTLS) पहचान चाहते हैं

• आप इसे अलग से बनाए बिना हर कॉल पर लागत ट्रैकिंग चाहते हैं

• आप सिमेंटिक डिस्कवरी चाहते हैं ताकि एजेंट सटीक टूल नाम की आवश्यकता के बजाय लक्ष्य का वर्णन करके सही टूल ढूंढ सके

• आप Rust, Elixir या Ruby में एकीकरण कर रहे हैं, जहाँ MCP ट्रांसपोर्ट लॉजिक को हाथ से बनाना Python/TypeScript की तुलना में अधिक काम है

यदि इनमें से कोई भी लागू नहीं होता — मान लीजिए, आप केवल Claude Desktop को DataGrout सर्वर से जोड़ रहे हैं — तो सादा mcpServers JSON कॉन्फ़िगरेशन सरल और पर्याप्त है। Conduit DataGrout के ऊपर अपना स्वयं का एजेंट या एप्लिकेशन बनाने के लिए है, बुनियादी क्लाइंट कॉन्फ़िगरेशन के लिए नहीं।

भाषा समर्थन

भाषा	पैकेज	इंस्टॉल
Python	datagrout-conduit	pip install datagrout-conduit==0.7.0
TypeScript	@datagrout/conduit	npm install @datagrout/conduit@0.7.0
Rust	datagrout-conduit	cargo add datagrout-conduit@0.7.0
Elixir	datagrout_conduit	{:datagrout_conduit, "~> 0.7.0"}
Ruby	datagrout-conduit	gem install datagrout-conduit -v 0.7.0

बिना पहले साइन अप किए सर्वर प्राप्त करना

अभी तक DataGrout खाता या एंडपॉइंट नहीं है? SDK आपके लिए दोनों सीधे प्रावधान कर सकता है (Python दिखाया गया है; वही कॉल प्रत्येक भाषा के SDK में मौजूद है — सटीक सिंटैक्स के लिए नीचे दिए गए प्रति-भाषा दस्तावेज़ देखें):

from datagrout.conduit import ClientBuilder
from datagrout.conduit.onramp import OnrampOptions

client = await ClientBuilder().bootstrap_onramp(OnrampOptions(
    gateway="https://app.datagrout.ai",
    agent_name="my-agent",
    agent_type="claude-sonnet-4-6",
    intended_use="Summarise documents and extract entities.",
))
await client.connect()

उस एक कॉल के पीछे: SDK आपके एजेंट को पंजीकृत करता है, OAuth क्रेडेंशियल्स और सर्वर URL के लिए अल्पकालिक token का आदान-प्रदान करता है, एक स्थानीय कुंजी जोड़ी उत्पन्न करता है, और इसे DataGrout के CA से हस्ताक्षरित करवाता है। निजी कुंजी आपकी मशीन पर रहती है। पहले के बाद हर रन स्वचालित रूप से सहेजी गई पहचान का पुनः उपयोग करता है।

कोड लिखने के बजाय टर्मिनल पसंद है: invariant onboard।

प्रमाणीकरण

तीन विधियाँ, सभी पाँच SDK में समान:

• Bearer token — सबसे सरल विकल्प, त्वरित परीक्षण के लिए अच्छा।

• OAuth 2.1 (क्लाइंट क्रेडेंशियल्स) — SDK स्वचालित रूप से JWT प्राप्त करता है, कैश करता है और रीफ्रेश करता है।

• mTLS — एक बार के बूटस्ट्रैप के बाद, सर्टिफिकेट स्वयं हर अनुरोध को प्रमाणित करता है; बाद में प्रबंधित करने के लिए कोई token नहीं।

mTLS के लिए, पहचान एक निश्चित खोज क्रम में स्वतः खोजी जाती है: एक स्पष्ट ओवरराइड निर्देशिका, CONDUIT_MTLS_CERT/CONDUIT_MTLS_KEY env vars, CONDUIT_IDENTITY_DIR, डिफ़ॉल्ट ~/.conduit/, फिर कार्यशील निर्देशिका के सापेक्ष एक स्थानीय .conduit/। एक मशीन पर कई एजेंट चलाने का अर्थ है प्रत्येक को अपनी स्वयं की पहचान निर्देशिका देना।

समर्पित CA क्यों: मशीन पहचान की आवश्यकताएँ ब्राउज़र पहचान से भिन्न होती हैं — एजेंटों को हर बार मानव की भागीदारी के बिना, प्रोग्रामेटिक रूप से जारी और घुमाए गए सर्टिफिकेट की आवश्यकता होती है। हस्ताक्षर कुंजी HSM-समर्थित AWS KMS कुंजी (FIPS 140-2 Level 2) में रहती है और इसे कभी नहीं छोड़ती। CA सर्टिफिकेट स्वतंत्र श्रृंखला सत्यापन के लिए ca.datagrout.ai/ca.pem पर सार्वजनिक है।

ट्रांसपोर्ट विकल्प

ट्रांसपोर्ट	प्रोटोकॉल	कब उपयोग करें
mcp (डिफ़ॉल्ट)	MCP over Streamable HTTP/SSE	आप पूर्ण प्रोटोकॉल समर्थन, स्ट्रीमिंग, सूचनाएँ चाहते हैं
jsonrpc	JSON-RPC 2.0 over HTTP POST	आप कुछ सरल और स्टेटलेस चाहते हैं
websocket	JSON-RPC 2.0 over WebSocket	आपको सर्वर से केवल प्रतिक्रिया देने के बजाय इवेंट पुश करने की आवश्यकता है

प्रमाणीकरण तीनों में समान रूप से काम करता है — ट्रांसपोर्ट बदलने का अर्थ यह नहीं है कि आप प्रमाणीकरण का तरीका बदल रहे हैं।

मुख्य विशेषताएँ

• Intelligent Interface (डिफ़ॉल्ट रूप से चालू) — संपूर्ण टूल सतह को दो कॉल, discover और perform में समेट देता है। एजेंट सैकड़ों टूल स्कीमा पर तर्क करने के बजाय सरल भाषा में लक्ष्य का वर्णन करता है। कच्चे टूल देखने के लिए use_intelligent_interface=False से अक्षम करें।

• सिमेंटिक डिस्कवरी — सटीक नाम के बजाय अर्थ द्वारा टूल खोजने के लिए, स्टैंडअलोन रूप में भी उपलब्ध।

• लागत दृश्यता — हर कॉल क्रेडिट उपयोग के साथ एक रसीद लौटाता है।

• निर्देशित वर्कफ़्लो — client.guide(goal=...) एक बहु-चरणीय लक्ष्य के माध्यम से इंटरैक्टिव रूप से चलता है।

• कॉग्निटिव ट्रस्ट सर्टिफिकेट — क्रिप्टोग्राफ़िक प्रमाण कि वर्कफ़्लो चक्र-मुक्त, टाइप-सुरक्षित, नीति-अनुपालक और बजट के भीतर है, जो एजेंट पहचान के समान CA द्वारा हस्ताक्षरित है।

प्रथम-पक्ष नेमस्पेस

नेमस्पेस	इसका उपयोग किस लिए है
prism	डेटा परिवर्तन, चार्टिंग, रेंडरिंग, निर्यात
logic	Prolog लॉजिक परत के माध्यम से स्थायी एजेंट मेमोरी
warden	सुरक्षा जाँच, इरादा सत्यापन, बहु-मॉडल सहमति
deliverables	पूर्ण कार्य उत्पाद का पंजीकरण और पुनर्प्राप्ति
ephemerals	कैश किए गए परिणामों का निरीक्षण और प्रबंधन
flow	वर्कफ़्लो ऑर्केस्ट्रेशन — रूटिंग, मानव अनुमोदन, निष्पादन इतिहास

फ़्लो को नामित, पुनः प्रयोज्य कौशल (save_as_skill=True) के रूप में सहेजा जा सकता है या $compute के माध्यम से एक-बार के चरणों के रूप में इनलाइन एम्बेड किया जा सकता है। flow.route सशर्त शाखाकरण को संभालता है; flow.request_approval/flow.request_feedback मानव चेकपॉइंट सम्मिलित करते हैं। किसी नेमस्पेस द्वारा कवर न की गई कोई भी चीज़ सामान्य dg() कॉल के माध्यम से पहुँच योग्य है।

यह DataGrout के एकीकरण से कहाँ जुड़ता है

Conduit आपके एजेंट और किसी भी DataGrout सर्वर के बीच की परत है — जिसमें Salesforce, QuickBooks और Oracle Fusion Cloud एकीकरण शामिल हैं। call_tool("salesforce@1/get_lead@1", ...) कॉल उसी तरह काम करती है चाहे उस सर्वर पर कोई भी एकीकरण कॉन्फ़िगर किया गया हो; SDK को किसी विशिष्ट एकीकरण के बारे में पहले से जानने की आवश्यकता नहीं है।

आगे कहाँ जाएँ

• प्रति-भाषा दस्तावेज़: Python, TypeScript, Rust, Elixir, Ruby README (GitHub)

• सुरक्षा विवरण: app.datagrout.ai/security

• निःशुल्क, बिना खाते के उपकरण: MCP Inspector और JSON-RPC Inspector, ब्राउज़र-आधारित

• लैब्स: ट्रस्ट सर्टिफिकेट, सिमेंटिक कोड विश्लेषण, नीति प्रवर्तन, क्रेडिट मॉडल और अधिक पर शोध लेख

लाइसेंस

MIT