इसे छोड़कर कंटेंट पर जाएं
MFA ServiceNow MCP

Tool Packages — उन्नत संदर्भ

अधिकांश उपयोगकर्ताओं को इस पृष्ठ की आवश्यकता नहीं है। डिफ़ॉल्ट पैकेज standard है — केवल-पठन (read-only), किसी भी वातावरण के लिए सुरक्षित। केवल तभी आगे पढ़ें जब आपको standard द्वारा प्रदान किए गए से अधिक लेखन (write) टूल्स की आवश्यकता हो।

पैकेज चुनना

Section titled “पैकेज चुनना”

सबसे संकीर्ण पैकेज से शुरू करें जो आपके कार्य को कवर करता हो। प्रत्येक अगला स्तर अधिक डोमेन में लेखन पहुँच जोड़ता है:

केवल-पठन — किसी भी वातावरण के लिए सुरक्षित, कोई लेखन टूल नहीं:

Package Tools अधिकतम टोकन अधिकतम (3 instances) कब उपयोग करें
core 12 ~2.0K ~2.6K न्यूनतम केवल-पठन: केवल health, schema, discovery, और मुख्य artifact लुकअप
standard 31 ~7.0K ~7.9K (डिफ़ॉल्ट) incidents, changes, portal, logs, और source विश्लेषण में केवल-पठन
none 0 0 0 जानबूझकर सभी टूल्स अक्षम करें (परीक्षण, प्रतिबंधित वातावरण)

⚠️ लेखन-सक्षम — उन्नत विकल्प जो create/update/delete की अनुमति देते हैं:

Package Tools अधिकतम टोकन अधिकतम (3 instances) कब उपयोग करें
service_desk 33 ~7.7K ~8.7K ⚠️ सर्विस डेस्क एजेंट जिन्हें incidents और changes को अपडेट/बंद करने की आवश्यकता हो
portal_developer 52 ~15.2K ~17.0K ⚠️ पोर्टल डेवलपर जो widgets, changesets, और script includes परिनियोजित करते हैं
platform_developer 46 ~12.8K ~14.4K ⚠️ प्लेटफ़ॉर्म इंजीनियर जो workflows, Flow Designer, और scripts प्रबंधित करते हैं
full 63 ~17.6K ~19.8K ⚠️ सबसे उन्नत — सभी डोमेन में सभी लेखन टूल्स एक साथ (नीचे चेतावनी देखें)

अधिकतम टोकन = हर request पर उस package की tool schemas model के context में जोड़ने वाले अनुमानित tokens (tiktoken cl100k_base आधार; वास्तविक Claude token संख्या थोड़ी भिन्न)। संकरे package से context और लागत बचती है। यह अधिकतम है, सामान्य लागत नहीं: पूरा खर्च केवल वे clients उठाते हैं जो सारी tool schemas शुरुआत में load करते हैं। Deferred tool loading वाले clients (जैसे Claude Code का tool search) किसी tool का schema तभी load करते हैं जब वह उपयोग हो, इसलिए उनकी वास्तविक per-request लागत काफी कम होती है। Tools की संख्या package के सदस्य गिनती है; हर package में list_tool_packages भी होता है, और multi-instance setup में list_instances, compare_instances और हर tool पर एक instance parameter जुड़ता है — दूसरा token column इसे तीन instances के साथ मापता है। आंकड़े tiktoken से मापे गए हैं, अनुमानित नहीं (uv run --no-sync --with tiktoken python scripts/measure_tool_tokens.py <package> हर tool का हिस्सा दिखाता है)।

core और none को छोड़कर सभी पैकेज _extends के माध्यम से standard केवल-पठन टूल्स को इनहेरिट करते हैं। पूर्ण इनहेरिटेंस ट्री के लिए config/tool_packages.yaml देखें।

पैकेज सेट करना

Section titled “पैकेज सेट करना”

पर्यावरण चर (environment variable) के माध्यम से (अनुशंसित):

टर्मिनल विंडो
MCP_TOOL_PACKAGE=standard

CLI फ़्लैग के माध्यम से:

टर्मिनल विंडो
servicenow-mcp --tool-package standard --instance-url ...

आपके MCP क्लाइंट कॉन्फ़िग में:

{
  "env": {
    "MCP_TOOL_PACKAGE": "standard"
  }
}

जब कोई टूल आपके पैकेज में नहीं होता तो क्या होता है

Section titled “जब कोई टूल आपके पैकेज में नहीं होता तो क्या होता है”

यदि आप कोई ऐसा टूल कॉल करते हैं जो आपके वर्तमान पैकेज में सक्रिय नहीं है, तो सर्वर एक स्पष्ट त्रुटि लौटाता है:

Tool 'manage_widget' is not available in package 'standard'.
Enable package 'portal_developer' or higher to use this tool.

कोई मौन विफलता (silent failure) नहीं — LLM को ठीक-ठीक पता होता है कि कौन सा पैकेज अनुरोध करना है।

पूर्ण टूल सूची

Section titled “पूर्ण टूल सूची”

सभी 73 टूल्स की श्रेणी और पैकेज सदस्यता के अनुसार पूर्ण सूची के लिए, Tool Inventory देखें।