> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xkat.space/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP AI एजेंट एकीकरण

> Claude, Cursor और MCP एजेंटों को कनेक्ट करके तुरंत कोर्स बनाएं और आयात करें।

xkat से बाहरी AI एजेंटों (Claude Code, Cursor, Antigravity और अन्य Model Context Protocol संगत टूल्स) को कनेक्ट करें। केवल एक सामान्य भाषा के प्रॉम्प्ट के साथ, आपका AI एजेंट उपलब्ध लैब वातावरण की खोज कर सकता है, नियमों के अनुसार एक संपूर्ण व्यावहारिक गाइड लिख सकता है, और इसे सीधे आपके खाते में एक निजी ड्राफ्ट के रूप में आयात कर सकता है।

## त्वरित कार्यप्रवाह

<Steps>
  <Step title="व्यक्तिगत एक्सेस टोकन के माध्यम से कनेक्ट करें">
    [सेटिंग्स → AI टोकन](https://xkat.space/hi/settings/ai-tokens) में एक एक्सेस टोकन बनाएं, फिर अपने AI एजेंट कॉन्फ़िगरेशन में रिमोट MCP एंडपॉइंट (`https://mcp.xkat.space/mcp`) दर्ज करें।
  </Step>

  <Step title="AI एजेंट को प्रॉम्प्ट दें">
    सामान्य भाषा में पूछें: *"QEMU के लिए Debian 12 इंस्टॉलेशन गाइड तैयार करें।"*
  </Step>

  <Step title="वातावरण खोज और गाइड निर्माण">
    एजेंट समर्थित वातावरण (`debian_qemu`) और निर्माण नियमों (प्रति कार्ड एकल कमांड, Mermaid आरेख, आंतरिक प्लेटफ़ॉर्म विवरण छिपाना) को समझने के लिए `list_lab_profiles` और `get_guide_spec` को कॉल करता है।
  </Step>

  <Step title="त्वरित आयात और प्लेयर लिंक">
    एजेंट कोर्स को आपके खाते में एक निजी ड्राफ्ट के रूप में सहेजने के लिए `import_draft_guide` चलाता है और एक सीधा प्लेयर URL (`https://xkat.space/hi/player/<id>`) लौटाता है।
  </Step>
</Steps>

## क्लाइंट कॉन्फ़िगरेशन

अपने AI टूल की कॉन्फ़िगरेशन फ़ाइल में xkat रिमोट MCP सर्वर जोड़ें:

<Tabs>
  <Tab title="Claude Code (.mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "type": "http",
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor (.cursor/mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Antigravity (mcp_config.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "serverUrl": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## उपलब्ध MCP टूल्स

| टूल | उद्देश्य |
| :- | :- |
| `import_draft_guide` | गाइड (XML/YAML/JSON) को मान्य करता है और सीधे आपके खाते में निजी ड्राफ्ट के रूप में सहेजता है, प्लेयर लिंक लौटाता है। |
| `get_guide_spec` | `os-install`, `linux-cli` आदि डोमेन के लिए गाइड निर्माण नियम और विनिर्देश लौटाता है। |
| `list_plugins` | उपलब्ध व्यूअर प्लगइन्स (`desktop-viewer`, `linux-wasix` आदि) की सूची लौटाता है। |
| `list_lab_profiles` | समर्थित लैब निष्पादन वातावरण (`debian_qemu`, `ubuntu_qemu` आदि) की सूची लौटाता है। |
| `validate_course` | डेटाबेस में लिखे बिना कोर्स संरचना और XML स्कीमा को मान्य करता है। |
| `build_course` | कोर्स इनपुट को मान्य करता है और डेटाबेस में सहेजे बिना XML लौटाता है। |

## उपलब्ध संसाधन

| संसाधन URI | विवरण |
| :- | :- |
| `catalog://plugins` | व्यूअर प्लगइन्स और रनटाइम क्षमताओं की सूची। |
| `catalog://lab-profiles` | लैब प्रोफाइल और वर्चुअल वातावरण/कंटेनर की सूची। |
| `spec://os-install` | ओएस इंस्टॉलेशन गाइड के लिए विनिर्देश और बैज नियम। |
| `schema://course` | कोर्स संरचना सत्यापन के लिए JSON स्कीमा। |
| `template://sample-course` | एजेंट सीखने के लिए YAML में संदर्भ कोर्स टेम्पलेट। |

## आयात कोटा और सीमाएं

`import_draft_guide` के माध्यम से आयात करने पर आपके सदस्यता स्तर का मासिक कोटा खर्च होता है:

* **Free** — MCP आयात समर्थित नहीं है (सत्यापन और बिल्ड उपलब्ध है)।
* **Basic** — प्रति माह 5 आयात।
* **Pro** — प्रति माह 10 आयात।
* **Creator** — असीमित आयात।

<Tip>
  MCP द्वारा आयातित गाइड `isPublished: false` के साथ सहेजे जाते हैं, इसलिए जब तक आप Studio में उनकी समीक्षा करके उन्हें प्रकाशित नहीं करते, वे निजी रहते हैं।
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.