Claude Architect · पाठ

टूल, संसाधन और प्रॉम्प्ट

वे तीन मूल तत्व जिन्हें MCP सर्वर उपलब्ध करा सकता है।

पाठ 1, कुल 4 में से13 चरण

टूल, संसाधन और प्रॉम्प्ट, CoddyKit पर Claude Architect का एक निःशुल्क पाठ है। यह 4 में से 1वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह Claude Architect सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। Claude Architect पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

तीन मूलभूत साधन, एक सर्वर

Model Context Protocol (MCP) किसी बाहरी सर्वर को मानक इंटरफ़ेस के माध्यम से Claude के लिए क्षमताएँ उपलब्ध कराने देता है। एक सर्वर ठीक तीन प्रकार के मूलभूत साधन दे सकता है:

टूल — वे कार्रवाइयाँ जिन्हें मॉडल चला सकता है (कुछ करना, अक्सर प्रभावों के साथ)
संसाधन — केवल पढ़े जाने वाले डेटा और संदर्भ, जिन्हें मॉडल ला सकता है (स्कीमा, कैटलॉग, दस्तावेज़)
प्रॉम्प्ट — पुनः उपयोग किए जा सकने वाले प्रारूप, जो यह तय करते हैं कि किसी कार्य के लिए अनुरोध कैसे किया जाए

किस क्षमता के लिए कौन-सा मूलभूत साधन उपयुक्त है, यह जानना वास्तुकार का एक मुख्य कौशल है: किसी कार्रवाई को संसाधन समझ लेना (या इसके उलट) नाज़ुक और भ्रमित करने वाले एकीकरणों की ओर ले जाता है।

टूल — प्रभाव वाली कार्रवाइयाँ

टूल कार्रवाइयाँ होते हैं। ये वे मूलभूत साधन हैं जिन्हें मॉडल कॉल करके कुछ करवाता है: सक्रिय डेटाबेस में क्वेरी करना, टिकट बनाना, संदेश भेजना या धनवापसी संसाधित करना। टूल, Agent SDK के उन टूल के MCP समकक्ष हैं जिन्हें आप API अनुरोध के tools फ़ील्ड में पहले से परिभाषित करते हैं।

क्योंकि टूल व्यवहार को संचालित करते हैं, इसलिए उनके विवरण ही चयन का प्राथमिक साधन होते हैं — उनके नाम नहीं। अच्छे tool विवरण में उद्देश्य, लौटाए गए मान, उदाहरणों सहित इनपुट प्रारूप और लागू होने की सीमाएँ स्पष्ट होती हैं, ताकि मॉडल सही tool तक पहुँच सके।

# An MCP server exposing a Tool (action) — Python style
@mcp.tool()
def lookup_order(order_id: str) -> dict:
    """Fetch a single order by its ID from the orders DB.

    Input: order_id as 'ORD-12345' (string, required).
    Returns: {status, total_cents, items[]}.
    Use only when you already have an exact order ID;
    for fuzzy search use search_orders instead.
    """
    return db.fetch_order(order_id)

संसाधन — केवल पढ़े जाने वाला संदर्भ

संसाधन केवल पढ़े जाने वाला डेटा होते हैं। वे मॉडल को किसी कार्रवाई के बजाय विचार करने के लिए संदर्भ देते हैं: डेटाबेस स्कीमा, उत्पाद कैटलॉग, API विनिर्देश, कॉन्फ़िगरेशन फ़ाइल या संदर्भ दस्तावेज़।

मानसिक जाँच यह है: यदि मॉडल समझने के लिए पढ़ रहा है, तो वह Resource है; यदि मॉडल कुछ बदलने के लिए काम कर रहा है, तो वह Tool है। स्थिर स्कीमा को Resource के रूप में उपलब्ध कराने से केवल आवश्यक संदर्भ पहले से लाने के लिए tool कॉल और आने-जाने का एक चक्र खर्च नहीं होता।

# An MCP Resource — read-only context the model can load
@mcp.resource("schema://orders")
def orders_schema() -> str:
    """The current orders table schema (read-only).
    Provides column names and types so the model can
    write correct queries without guessing.
    """
    return read_file("db/orders.schema.sql")

प्रॉम्प्ट — पुनः उपयोग योग्य प्रारूप

प्रॉम्प्ट प्रारूप होते हैं। MCP सर्वर पैरामीटर वाले, पुनः उपयोग किए जा सकने वाले प्रॉम्प्ट प्रारूप प्रकाशित कर सकता है — जैसे टीम की पसंदीदा संरचना और मानदंड पहले से शामिल करने वाला मानक "इस घटना का सारांश दें" या "सुरक्षा समस्याओं के लिए इस PR की समीक्षा करें" प्रॉम्प्ट।

प्रॉम्प्ट न तो कार्रवाइयाँ हैं और न ही डेटा; वे यह बताते हैं कि किसी कार्य के लिए अनुरोध कैसे किया जाए। वे सर्वर को सर्वोत्तम तरीकों वाले निर्देश (स्पष्ट मानदंड, few-shot उदाहरण) देने देते हैं, ताकि हर उपभोक्ता अनुरोध को एकसमान ढंग से लिखे और उसे फिर से गढ़ना न पड़े।

# An MCP Prompt — a reusable, parameterized template
@mcp.prompt()
def review_pr(diff: str, focus: str = "security") -> str:
    return (
        "Review the following diff. "
        f"Flag a finding only when it clearly violates {focus} "
        "best practice; do not flag style preferences.\n\n"
        f"{diff}"
    )

निर्णय: Tool बनाम Resource बनाम Prompt

तीनों को साथ रखकर देखने पर सीमाएँ स्पष्ट हो जाती हैं:

Tool — "X करें।" इसका प्रभाव होता है, यह क्षणिक रूप से विफल हो सकता है और लूप के बीच में चलाया जाता है। उदाहरण: process_refund।
Resource — "यह X पढ़ने के लिए है।" स्थिर, idempotent और बिना किसी प्रभाव के। उदाहरण: orders schema।
Prompt — "इसे इस तरह पूछें।" यह प्रारूप है, कॉल नहीं। उदाहरण: PR-समीक्षा प्रारूप।

एक आम गलती केवल पढ़े जाने वाले संदर्भ को tool में लपेटना है। यह काम करता है, लेकिन इसके लिए tool कॉल और आने-जाने का एक चक्र खर्च होता है; Resource वही संदर्भ कम लागत में देता है और उद्देश्य को स्पष्ट रूप से दर्शाता है।

MCP सर्वर कॉन्फ़िगर करना: दायरा

आप सर्वर को कहाँ पंजीकृत करते हैं, इससे तय होता है कि उसे कौन पा सकता है। दो दायरे महत्वपूर्ण हैं:

प्रोजेक्ट दायरा — रिपॉज़िटरी के मूल में .mcp.json, जिसे संस्करण नियंत्रण में कमिट किया जाता है। पूरी टीम के साथ साझा; रिपॉज़िटरी क्लोन करने वाले हर व्यक्ति को वही सर्वर मिलते हैं।
उपयोगकर्ता दायरा — ~/.claude.json, व्यक्तिगत और VCS के माध्यम से साझा नहीं। आपके अपने क्रेडेंशियल या प्रयोगात्मक सर्वर के लिए अच्छा।

जिस एकीकरण पर पूरी टीम निर्भर करती है, उसके लिए प्रोजेक्ट दायरा चुनें, ताकि वह VCS में रहे और नए सहकर्मियों को स्वतः मिल जाए।

{
  "mcpServers": {
    "orders": {
      "command": "node",
      "args": ["./servers/orders-mcp.js"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

गुप्त जानकारी: टोकन कभी कमिट न करें

क्योंकि प्रोजेक्ट-दायरे वाली .mcp.json VCS में कमिट की जाती है, इसलिए आपको इसमें गुप्त जानकारी कभी भी सीधे नहीं लिखनी चाहिए। इसके बजाय पर्यावरण चर के माध्यम से उनका संदर्भ दें — जैसे ${GITHUB_TOKEN} — ताकि कॉन्फ़िगरेशन साझा की जा सके और वास्तविक टोकन स्रोत नियंत्रण से बाहर रहे।

यह सुविधा नहीं, सुरक्षा की गारंटी है: कमिट किया गया टोकन लीक हुआ टोकन है। पर्यावरण-चर का अप्रत्यक्ष संदर्भ प्रोजेक्ट कॉन्फ़िगरेशन को पोर्टेबल और क्रेडेंशियल को हर मशीन पर निजी रखता है।

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

सामुदायिक सर्वर को प्राथमिकता दें

मानक एकीकरणों — GitHub, Postgres, Slack, फ़ाइल सिस्टम — के लिए अपना सर्वर बनाने के बजाय अच्छी तरह अनुरक्षित सामुदायिक MCP सर्वर को प्राथमिकता दें। आपको बिना किसी अतिरिक्त प्रयास के, वास्तविक परिस्थितियों में परखे गए टूल विवरण, त्रुटि प्रबंधन और अद्यतन मिल जाते हैं।

कस्टम सर्वर का उपयोग केवल उन वास्तविक रूप से स्वामित्व वाली प्रणालियों के लिए करें, जिनके लिए कोई सामुदायिक विकल्प उपलब्ध नहीं है। यह एक व्यापक आर्किटेक्ट सिद्धांत को दर्शाता है: मानक आधारभूत संरचना को दोबारा न बनाएँ; अपना प्रयास उस चीज़ पर लगाएँ जो आपके डोमेन में वास्तव में अद्वितीय है।

टूल से संरचित त्रुटियाँ

जब कोई MCP टूल विफल होता है, तो "Operation failed" जैसा सामान्य संदेश मॉडल को अंधेरे में छोड़ देता है — वह यह नहीं बता सकता कि दोबारा प्रयास करना है, मामले को आगे बढ़ाना है या कोई दूसरा विकल्प आज़माना है। मॉडल को समझदारी से मार्ग चुनने देने के लिए हमेशा संरचित त्रुटियाँ लौटाएँ।

एक अच्छी MCP त्रुटि में ये चीज़ें होती हैं: isError: true, एक errorCategory (transient / validation / business / permission), एक isRetryable फ़्लैग, मानव-पठनीय message, attempted_query, और कोई भी partial_results। श्रेणी और पुनःप्रयास योग्य फ़्लैग ही एक बंद रास्ते को समझदारी से संभली गई स्थिति में बदलते हैं।

{
  "isError": true,
  "errorCategory": "transient",
  "isRetryable": true,
  "message": "DB connection timed out after 5s",
  "attempted_query": "SELECT * FROM orders WHERE id='ORD-1'",
  "partial_results": []
}

टूल की स्वच्छता MCP तक भी पहुँचती है

अच्छे टूल डिज़ाइन के बारे में जो कुछ आप जानते हैं, वह MCP टूल पर भी लागू होता है:

नाम नहीं, विवरण चयन को दिशा देते हैं — उद्देश्य, लौटाए जाने वाले परिणाम, इनपुट के प्रारूप, असामान्य स्थितियाँ और सीमाएँ लिखें।
टूल को भूमिका के अनुसार सीमित रखें। प्रति एजेंट लगभग 4-5 टूल सर्वोत्तम होते हैं; जैसे ही संख्या 18+ के करीब पहुँचती है, चयन की विश्वसनीयता घटने लगती है।
अतिव्यापन से बचें। अस्पष्ट और मिलते-जुलते विवरण वाले दो टूल गलत मार्ग-चयन का कारण बनते हैं।

किसी एजेंट पर अस्पष्ट रूप से वर्णित 20 टूल लादने वाला MCP सर्वर एक गलत अभिकल्प है, चाहे हर टूल कितना भी सक्षम क्यों न हो।

सब कुछ एक साथ रखना

किसी सहायता एजेंट के लिए ऑर्डर संबंधी MCP सर्वर की कल्पना करें। एक सुव्यवस्थित अभिकल्प में तीनों मूलभूत प्रकारों का सोच-समझकर उपयोग किया जाता है:

संसाधन schema://orders — ताकि एजेंट पहले से ही डेटा मॉडल समझ सके और किसी टूल कॉल की आवश्यकता न पड़े।
टूल lookup_order, process_refund — ये कार्रवाइयाँ हैं, जिनमें से हर एक का स्पष्ट विवरण और संरचित त्रुटियाँ हैं।
प्रॉम्प्ट refund_review — टीम के धनवापसी-औचित्य मानदंड को समाहित करने वाला साँचा।

इसे प्रोजेक्ट-कार्य क्षेत्र वाले .mcp.json में पंजीकृत करें, गुप्त मान पर्यावरण चर से लें और टूल की संख्या कम रखें। यही आर्किटेक्ट-स्तर का MCP एकीकरण है।

त्वरित जाँच

तीन MCP मूलभूत प्रकारों और उन्हें उपलब्ध कराने के तरीके की अपनी समझ जाँचें।

इंटरैक्टिव पाठ में इसका उत्तर दें

पुनरावलोकन: टूल, संसाधन और प्रॉम्प्ट

परीक्षा और वास्तविक निर्माण कार्यों के लिए मुख्य बातें:

MCP सर्वर तीन मूलभूत प्रकार उपलब्ध कराता है: टूल (कार्रवाइयाँ), संसाधन (केवल-पठन डेटा/संदर्भ), प्रॉम्प्ट (साँचे)।
उद्देश्य के आधार पर निर्णय लें: काम करना → टूल, समझने के लिए पढ़ना → संसाधन, कैसे पूछना है → प्रॉम्प्ट।
कार्यक्षेत्र: प्रोजेक्ट .mcp.json (VCS में साझा) बनाम उपयोगकर्ता ~/.claude.json (व्यक्तिगत)।
गुप्त मान ${GITHUB_TOKEN} जैसे पर्यावरण चरों के माध्यम से दें — टोकन कभी भी कमिट न करें।
मानक एकीकरणों के लिए सामुदायिक सर्वर को प्राथमिकता दें; टूल की संख्या लगभग 4-5 रखें और उनके विवरण स्पष्ट रखें।
संरचित त्रुटियाँ (isError, errorCategory, isRetryable, attempted_query, partial_results) लौटाएँ, ताकि मॉडल समझदारी से स्थिति संभाल सके।

शुरुआत निःशुल्क

एआई शिक्षक के साथ Python सीखें — निःशुल्क

अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।

पाठ्यक्रम: 26
पाठ: 104

निःशुल्क सीखना शुरू करें पूरा पाठ्यक्रम देखें

अक्सर पूछे जाने वाले प्रश्न

क्या “टूल, संसाधन और प्रॉम्प्ट” पाठ निःशुल्क है?

हाँ — Claude Architect अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “टूल, संसाधन और प्रॉम्प्ट” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। Claude Architect पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

“टूल, संसाधन और प्रॉम्प्ट” में मैं क्या सीखूँगा?

वे तीन मूल तत्व जिन्हें MCP सर्वर उपलब्ध करा सकता है। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ Claude Architect का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।

क्या Claude Architect शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?

पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर Claude Architect शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 1वाँ पाठ है।

“टूल, संसाधन और प्रॉम्प्ट” पाठ पूरा करने में कितना समय लगता है?

CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।

क्या मैं इस Claude Architect पाठ में कोड लिख और चला सकता हूँ?

हाँ। हर Claude Architect पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।

इस पाठ्यक्रम के सभी पाठ

← Claude Architect पर वापस जाएँ