MCP सर्वर

एक Model Context Protocol सर्वर होस्ट करें ताकि कोडिंग एजेंट आपके दस्तावेज़ों को सीधे खोज और पढ़ सकें — टूल, संसाधन, डिस्कवरी दस्तावेज़, कंटेंट-टाइप और फ़ैसेट फ़िल्टर, और इसके लिए आवश्यक सर्वर आउटपुट।

एक Model Context Protocol सर्वर होस्ट करें ताकि कोडिंग एजेंट (Claude Code, Cursor, VS Code, claude.ai कनेक्टर) आपके दस्तावेज़ों को सीधे खोज और पढ़ सकें — बिना स्क्रैपिंग के। यह ऑप्ट-इन है:

ai: {
  mcp: {
    enabled: true,
    route: "/mcp", // where the server is mounted
  },
}

टूल और संसाधन

सर्वर केवल-पढ़ने योग्य टूल उपलब्ध कराता है — search_docs, get_page, list_pages, और get_navigation — तथा प्रत्येक पृष्ठ को एक MCP संसाधन के रूप में (resources/list पृष्ठों को उनके सर्व किए गए URL पर text/markdown प्रकार के साथ सूचीबद्ध करता है; resources/read पृष्ठ का एजेंट Markdown लौटाता है, वही आउटपुट जो get_page देता है), जिससे URI द्वारा संदर्भ जोड़ने वाले क्लाइंट बिना कोई टूल कॉल किए दस्तावेज़ ब्राउज़ कर सकते हैं। यह /.well-known/mcp.json और /.well-known/mcp/server-card.json पर डिस्कवरी दस्तावेज़ प्रकाशित करता है। सर्वर कार्ड SEP-2127 Server Card एक्सटेंशन स्कीमा का पालन करता है (रिवर्स-DNS name, remotes ट्रांसपोर्ट एंडपॉइंट), साथ ही प्रस्ताव के पुराने संशोधन के अनुसार बने स्कैनर के लिए initialize-आकार वाले संगतता फ़ील्ड (serverInfo, capabilities, transports) भी शामिल हैं। प्रत्येक पृष्ठ का Connect to MCP मेन्यू Claude Code, Cursor, VS Code, और Codex के लिए कॉपी-एंड-गो इंस्टॉल प्रदान करता है (deployment.site सेट होने के बाद दिखाया जाता है)।

search_docs अपना स्वयं का फ़ुल-टेक्स्ट इंडेक्स चलाता है, इसलिए यह आपके search प्रदाता की परवाह किए बिना काम करता है — और तब भी जब search none पर सेट हो। MCP सर्वर ऑन-पेज सर्च से एक अलग सुविधा है।

वही टूल सादे HTTP पर JSON API के रूप में उपलब्ध हैं, उन फ़्रेमवर्क के लिए जो MCP नहीं समझते।

कंटेंट टाइप और फ़ैसेट द्वारा स्कोपिंग

search_docs और list_pages दोनों एक वैकल्पिक contentTypes फ़िल्टर स्वीकार करते हैं, जो परिणामों को दिए गए फ़्रंटमैटर type वाले पृष्ठों तक सीमित करता है — ["rfc"], ["blog", "changelog"] — ताकि ऐसी साइट पर काम करने वाला एजेंट जो दस्तावेज़ों को RFC, रनबुक, या नीतियों के साथ मिलाती है, अपनी आवश्यकता के अनुसार पृष्ठ प्रकार तक पुनर्प्राप्ति को सीमित कर सके। प्रत्येक परिणाम अपना कंटेंट टाइप बताता है, और list_pages का आउटपुट उपयोग में आने वाले प्रकार दिखाता है।

दोनों टूल एक filters ऑब्जेक्ट भी स्वीकार करते हैं जो उन फ़ैसेट से मिलान करता है जिन्हें साइट प्रति कंटेंट टाइप घोषित करती है (content.types.<type>.facets) — कस्टम फ़्रंटमैटर कुंजियाँ जिनके मान फ़िल्टर करने योग्य मेटाडेटा बन जाते हैं:

{
  "query": "OpenAPI request schemas",
  "contentTypes": ["rfc"],
  "filters": { "domain": "architecture", "status": "enforced" }
}

प्रत्येक filters प्रविष्टि का मिलान होना आवश्यक है (परिणाम अपने फ़ैसेट मान साथ लाते हैं, और list_pages प्रत्येक पृष्ठ के मान दिखाता है), जिससे एक नॉलेज बेस प्रोग्रेसिव-डिस्क्लोज़र एजेंट वर्कफ़्लो चला सकता है — लागू किए गए मानकों की सूची बनाएँ, केवल उन्हीं के भीतर खोजें — बिना अपने किसी सर्वर के।

सर्वर आउटपुट आवश्यक

MCP सर्वर एक लाइव एंडपॉइंट (/mcp) है, इसलिए यह स्टैटिक बिल्ड पर नहीं चल सकता। सर्वर आउटपुट पर स्विच करें और एक एडाप्टर चुनें:

deployment: {
  output: "server",
  adapter: "node", // or "vercel" | "netlify" | "cloudflare"
  site: "https://docs.example.com",
}

ai.mcp.enabled के साथ स्टैटिक बिल्ड तुरंत विफल हो जाता है और एक संदेश देता है जो आपको deployment.output को server पर सेट करने के लिए कहता है। एडाप्टर के लिए Deployment देखें। डिप्लॉय हो जाने के बाद, Claude Code से इस तरह कनेक्ट करें:

claude mcp add --transport http my-docs https://docs.example.com/mcp