Didit MCP टूलसेट और रीड-ओनली मोड

MCP टूलसेट एक Didit MCP कनेक्शन को पूरी सूची के बजाय टूल की एक छोटी सूची लोड करने देते हैं। केवल-पढ़ने वाला मोड ऐसा कनेक्शन देता है जो कभी डेटा नहीं बदल सकता। दोनों सर्वर URL पर एक पैरामीटर के रूप में सेट होते हैं:

https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true

पैरामीटर के बिना सर्वर वे सभी टूल सूचीबद्ध करता है जिन्हें आपकी भूमिका उपयोग कर सकती है, इसलिए आपके मौजूदा कनेक्शन में कुछ नहीं बदलता।

कम टूल क्यों लोड करें

आपका क्लाइंट पहले सवाल से पहले मॉडल को सूची में मौजूद हर टूल की परिभाषा भेजता है। पूरे Didit कैटलॉग के लिए यह हर अनुरोध पर दसियों हज़ार token है: मॉडल के tokenizer के आधार पर लगभग 50,000 से 115,000। कुछ क्लाइंट यह भी सीमित करते हैं कि वे कितने टूल स्वीकार करेंगे।

कनेक्शन में क्या लोड होता है	सूचीबद्ध टूल	इन token में हिस्सा
सब कुछ (कोई पैरामीटर नहीं)	आपकी भूमिका जो भी टूल उपयोग कर सकती है	सभी
छोटी सूची, `core`	लगभग 30	लगभग एक-दसवाँ हिस्सा
छोटी सूची, केवल-पठन	लगभग 20	एक-दसवें से कम

इसके बदले में एक अतिरिक्त चरण जुड़ता है। सूची से बाहर का टूल खोता नहीं है, लेकिन मॉडल को उसे चलाने से पहले टूल खोज से ढूँढना पड़ता है। जो मॉडल हर टूल देखता है, वह खोज करने वाले मॉडल की तुलना में सही टूल थोड़ा अधिक बार चुनता है। जब बातचीत कई क्षेत्रों में फैली हो और संदर्भ की लागत मायने न रखती हो, तो सब कुछ लोड करें। जब संदर्भ की लागत मायने रखती हो, तो core और अपने सबसे अधिक उपयोग होने वाले टूलसेट लोड करें।

अपने टूलसेट चुनें

सर्वर URL में toolsets जोड़ें और कॉमा से अलग की गई सूची दें:

https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases

core छोटी सूची है, जिससे ज़्यादातर काम शुरू होते हैं। इसमें आपके संगठन और एप्लिकेशन, सत्यापन सत्र (बनाना, खोजना, निर्णय लेना, समझाना, सैंडबॉक्स में सिमुलेट करना, webhook डिलीवरी पढ़ना), वर्कफ़्लो खोजना, एनालिटिक्स और बैलेंस, आपके एप्लिकेशन की API कुंजी और webhooks, केस, उपयोगकर्ता, व्यवसाय और लेन-देन खोजना, और दस्तावेज़ खोज शामिल हैं।

core: ऊपर दी गई छोटी सूची।
account: संगठन, एप्लिकेशन, API कुंजियाँ, सदस्य और भूमिकाएँ।
billing: प्लान, क्रेडिट बैलेंस, भुगतान के तरीके, रसीदें और बिलिंग विवरण।
sessions: सत्यापन सत्र (बनाना, खोजना, निर्णय लेना, समीक्षा करना, साझा करना, इंपोर्ट करना, PDF और webhook डिलीवरी)।
workflows: सत्यापन वर्कफ़्लो और प्रश्नावलियाँ (बनाना, संपादित करना, सत्यापित करना और प्रकाशित करना)।
lists: कस्टम सूचियाँ, ब्लॉकलिस्ट और अनुमति सूची।
vendors: वे लोग और कंपनियाँ जिनका आप सत्यापन करते हैं (विक्रेता उपयोगकर्ता और विक्रेता व्यवसाय)।
transactions: लेन-देन निगरानी (लेन-देन, वॉलेट स्क्रीनिंग और बैकटेस्टिंग के साथ नियम)।
cases: केस प्रबंधन (केस बनाना, असाइन करना, आगे बढ़ाना और हल करना)।
investigator: Investigator (इसकी समीक्षा कतार, रिपोर्ट, निर्णय, नीति से जुड़े प्रश्न और प्रदर्शन)।
webhooks: webhook गंतव्य और अलर्ट।
reports: एनालिटिक्स, एक्सपोर्ट और ऑडिट लॉग।
branding: सत्यापन प्रवाह की व्हाइट लेबल ब्रांडिंग।
verification: स्वतंत्र सत्यापन API (पहचान दस्तावेज़, चेहरा, AML, पते का प्रमाण, फ़ोन, ईमेल, डेटाबेस और व्यवसाय जाँच)।
travel_rule: Travel Rule (सेटिंग्स, VASP डायरेक्टरी, नेटवर्क, वॉलेट पते, ट्रांसफ़र और संदेश)।
marketplace: प्रदाता मार्केटप्लेस (कैटलॉग, आपके कनेक्शन और इंटीग्रेशन अनुरोध)।
networks: धोखाधड़ी नेटवर्क (लिंक किए गए सत्र, उपयोगकर्ता और व्यवसाय जो कोई डिवाइस, दस्तावेज़ या संपर्क साझा करते हैं)।
compliance: अनुपालन सहायक (आपकी नियामक प्रोफ़ाइल, उसकी आवश्यकताएँ और उनसे बने वर्कफ़्लो)।
docs: Didit दस्तावेज़ीकरण में खोज।
all: आपकी भूमिका द्वारा उपयोग किए जा सकने वाले सभी टूल। यह डिफ़ॉल्ट है।

टूल संदर्भ हर टूल को उसके प्रकार और उसके लिए आवश्यक भूमिका अनुमति के साथ सूचीबद्ध करता है। चयन इस तरह काम करता है:

टूलसेट वैकल्पिक हैं। बिना toolsets वाला URL सब कुछ सूचीबद्ध करता है।
किसी टूलसेट का नाम देने पर केवल वही सूचीबद्ध होते हैं। ?toolsets=cases केस टूल सूचीबद्ध करता है, साथ में didit_context_get भी, जो हर कनेक्शन को मिलता है। छोटी सूची भी बनाए रखने के लिए core जोड़ें।
टूलसेट तय करता है कि क्या सूचीबद्ध होगा, न कि आप क्या चला सकते हैं। आपके चयन से बाहर का टूल तब भी चलेगा, जब मॉडल उसे नाम से कॉल करेगा, और उसकी भूमिका अनुमतियाँ हमेशा की तरह लागू रहेंगी।
सर्वर जो नाम नहीं जानता, उसे अनदेखा किया जाता है। कनेक्शन फिर भी काम करता है, और सर्वर मॉडल को बताता है कि किस नाम को अनदेखा किया गया और कौन से नाम मान्य हैं।
आपकी भूमिका अब भी लागू होती है। टूलसेट कोई अनुमति नहीं देता: देखें भूमिकाएँ और अनुमतियाँ।

केवल-पढ़ने वाले मोड में कनेक्ट करें

सर्वर URL में read_only=true जोड़ें:

https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&read_only=true

केवल-पढ़ने वाला कनेक्शन केवल वे टूल सूचीबद्ध करता है जो पढ़ते हैं, और सर्वर हर उस कॉल को अस्वीकार कर देता है जो कुछ बनाती, बदलती या हटाती है। यह अस्वीकृति हर कॉल पर सर्वर की ओर से लागू होती है, इसलिए यह तब भी लागू रहती है जब आपका क्लाइंट किसी पिछले कनेक्शन के टूल को याद रखे। इसका उपयोग रिपोर्टिंग के लिए, किसी खाते को खंगालने के लिए, या ऐसे एजेंट के लिए करें जिसे आप अपने आप कार्य न करने देना चाहते हों। फिर से बदलाव की अनुमति देने के लिए, read_only के बिना कनेक्ट करें।

आपके लोड न किए गए टूलों तक पहुँचना

जब कोई कनेक्शन कैटलॉग का केवल एक हिस्सा सूचीबद्ध करता है, तो सर्वर चार टूल जोड़ता है ताकि कुछ भी पहुँच से बाहर न रहे:

didit_tool_search (पठन): आप जो करना चाहते हैं उसके आधार पर टूल खोजता है (“सत्र CSV में एक्सपोर्ट करें”), या एक टूलसेट की सूची दिखाता है। हर मिलान बताता है कि टूल क्या करता है, उसके पैरामीटर क्या हैं, और वह पढ़ता है, लिखता है या विनाशकारी है।
didit_tool_describe (पठन): अधिकतम पाँच टूल का पूरा विवरण और इनपुट स्कीमा लौटाता है।
didit_tool_call_read (पठन): सूची में न होने वाला केवल-पठन टूल चलाता है। डेटा बदलने वाले टूल को यह अस्वीकार करता है।
didit_tool_call_write (विनाशकारी): ऐसा टूल चलाता है जो डेटा बनाता, बदलता या हटाता है और जो सूची में नहीं है। केवल-पठन कनेक्शन पर यह उपलब्ध नहीं होता।

didit_tool_call_read या didit_tool_call_write के माध्यम से की गई कॉल की जाँच ठीक उसी तरह होती है जैसे सीधी कॉल की होती है: आपकी भूमिका की अनुमतियाँ, केवल-पठन मोड और हर confirm: true आवश्यकता लागू रहती हैं। ये दोनों अलग इसलिए हैं ताकि आपका क्लाइंट किसी बदलाव से पहले आपसे पूछ सके और किसी लुकअप को अनुमति दे। core लोड होने पर, “मेरे संगठन में एक नया टीममेट आमंत्रित करें” जैसा अनुरोध इस तरह आगे बढ़ता है:

मॉडल didit_tool_search को invite a teammate के साथ कॉल करता है और didit_org_invite_member पाता है, जिसे लेखन के रूप में चिह्नित किया गया है।
यह didit_tool_call_write को कॉल करता है, name के रूप में didit_org_invite_member और उस टूल के अपने आर्गुमेंट पास करते हुए।
आपका क्लाइंट आपसे इस कॉल को मंज़ूर करने को कहता है, जैसे वह डेटा बदलने वाले किसी भी टूल के लिए करता है।

जब सब कुछ लोड होता है तो खोजने के लिए कुछ नहीं बचता, इसलिए ये चार टूल सूचीबद्ध नहीं होते।

अपने क्लाइंट में सेट अप करें

वही चरण उपयोग करें जो इंस्टॉलेशन गाइड में हैं, बस पैरामीटर URL में जोड़ दें।

claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"

क्वोट्स रखें: अन्यथा आपका शेल ? और & को स्वयं पढ़ लेगा।

codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"

~/.cursor/mcp.json में:

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp?toolsets=core"
    }
  }
}

.vscode/mcp.json में:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp?toolsets=core"
    }
  }
}

Settings खोलें, फिर Connectors, फिर Add custom connector चुनें, और पैरामीटर के साथ URL पेस्ट करें:

https://mcp.didit.me/mcp?toolsets=core

लोकल सर्वर फ़्लैग या एनवायरनमेंट वेरिएबल लेता है:

npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only

DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server

यदि आपका क्लाइंट आपको हेडर सेट करने देता है लेकिन URL बदलने नहीं देता, तो इसके बजाय X-MCP-Toolsets: core,workflows और X-MCP-Readonly: true भेजें। टूलसेट के लिए URL में दी गई वैल्यू हेडर पर भारी पड़ती है, और केवल-पढ़ने मोड तब चालू होता है जब इनमें से कोई भी इसे माँगे।

ChatGPT प्लगइन अपनी स्थिर, सीमित कैटलॉग का उपयोग करता है, जो https://mcp.didit.me/mcp/chatgpt पर है। टूलसेट और केवल-पढ़ने मोड इस पर लागू नहीं होते। देखें ChatGPT कनेक्ट करें।

प्रॉम्प्ट, निर्देश और दस्तावेज़ खोज

सर्वर मॉडल को सही जगह से शुरू करने में मदद करता है:

निर्देश। कनेक्ट होते ही सर्वर मॉडल को बताता है कि didit_context_get से शुरू करे, organization_id और application_id कैसे हल होते हैं, सैंडबॉक्स एप्लिकेशन में निर्माण करे, और इस कनेक्शन ने कौन-से टूलसेट लोड किए हैं।
प्रॉम्प्ट। MCP प्रॉम्प्ट का समर्थन करने वाले क्लाइंट पाँच शुरुआती बिंदु दिखाते हैं: integrate_didit, review_queue, explain_session, build_workflow और verification_report। Claude Code में ये स्लैश कमांड के रूप में दिखते हैं।
दस्तावेज़ खोज। didit_docs_search इन दस्तावेज़ों में खोजता है और मिलते-जुलते अनुभाग उनके लिंक के साथ लौटाता है, ताकि Didit के काम करने के तरीके से जुड़े सवालों के जवाब मौजूदा पेजों से मिलें।

कनेक्शन ने क्या लोड किया, यह जाँचें

अपने क्लाइंट से पूछें:

Which Didit toolsets does this connection load, and is it read-only?

मॉडल सर्वर के निर्देशों से उत्तर देता है। उन पर भरोसा करने से पहले यह जाँचने के लिए कि सर्वर टूलसेट को सपोर्ट करता है, उसके endpoint की स्थिति पढ़ें:

curl https://mcp.didit.me/healthz

उत्तर में toolsets और read_only दिखते हैं, जो features के अंतर्गत सूचीबद्ध होते हैं।

अगले चरण

इंस्टॉलेशन

Claude, ChatGPT, Cursor, VS Code, Codex या किसी भी MCP क्लाइंट से कनेक्ट करें।

टूल संदर्भ

हर टूल, उसका प्रकार और उसके लिए आवश्यक भूमिका की अनुमति।

प्रमाणीकरण

Didit से लॉग इन करना, स्कोप और भूमिका अनुमतियाँ।

उदाहरण प्रॉम्प्ट

पहले दिन से काम करने वाले प्रॉम्प्ट।

गाइड

प्रमाणीकरण

Model Context Protocol (MCP)

वेब SDK

नेटिव SDK

सर्वर SDK

इंटीग्रेशन

Didit MCP टूलसेट और रीड-ओनली मोड

कम टूल क्यों लोड करें

अपने टूलसेट चुनें

केवल-पढ़ने वाले मोड में कनेक्ट करें

आपके लोड न किए गए टूलों तक पहुँचना

अपने क्लाइंट में सेट अप करें

प्रॉम्प्ट, निर्देश और दस्तावेज़ खोज

कनेक्शन ने क्या लोड किया, यह जाँचें

अगले चरण

इंस्टॉलेशन

टूल संदर्भ

प्रमाणीकरण

उदाहरण प्रॉम्प्ट

​कम टूल क्यों लोड करें

​अपने टूलसेट चुनें

​केवल-पढ़ने वाले मोड में कनेक्ट करें

​आपके लोड न किए गए टूलों तक पहुँचना

​अपने क्लाइंट में सेट अप करें

​प्रॉम्प्ट, निर्देश और दस्तावेज़ खोज

​कनेक्शन ने क्या लोड किया, यह जाँचें

​अगले चरण

इंस्टॉलेशन

टूल संदर्भ

प्रमाणीकरण

उदाहरण प्रॉम्प्ट

कम टूल क्यों लोड करें

अपने टूलसेट चुनें

केवल-पढ़ने वाले मोड में कनेक्ट करें

आपके लोड न किए गए टूलों तक पहुँचना

अपने क्लाइंट में सेट अप करें

प्रॉम्प्ट, निर्देश और दस्तावेज़ खोज

कनेक्शन ने क्या लोड किया, यह जाँचें

अगले चरण