> ## 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.

# Agen AI MCP

> Hubungkan Claude, Cursor, dan agen MCP untuk membuat dan mengimpor kursus secara instan.

Hubungkan agen AI eksternal (Claude Code, Cursor, Antigravity, dan alat lain yang mendukung Model Context Protocol) ke xkat. Hanya dengan satu perintah bahasa alami, agen AI dapat menemukan lingkungan lab yang tersedia, menyusun panduan praktik lengkap sesuai aturan domain, dan langsung mengimpornya ke akun Anda sebagai draf privat.

## Alur Kerja Cepat

<Steps>
  <Step title="Hubungkan melalui Token Akses Pribadi">
    Terbitkan token akses di [Pengaturan → Token AI](https://xkat.space/id/settings/ai-tokens), lalu daftarkan endpoint MCP jarak jauh (`https://mcp.xkat.space/mcp`) dalam konfigurasi agen AI Anda.
  </Step>

  <Step title="Beri Perintah pada Agen AI">
    Minta dalam bahasa alami: *"Buat panduan praktik instalasi Debian 12 untuk QEMU."*
  </Step>

  <Step title="Eksplorasi Lingkungan & Pembuatan Panduan">
    Agen memanggil `list_lab_profiles` dan `get_guide_spec` untuk memeriksa lingkungan yang didukung (`debian_qemu`) serta aturan penulisan (satu perintah per kartu, diagram Mermaid, menyembunyikan detail internal platform).
  </Step>

  <Step title="Impor Instan & Tautan Pemutar">
    Agen memanggil `import_draft_guide` untuk menyimpan kursus sebagai draf privat di akun Anda dan mengembalikan tautan pemutar langsung (`https://xkat.space/id/player/<id>`).
  </Step>
</Steps>

## Konfigurasi Klien

Tambahkan server MCP xkat ke file konfigurasi agen AI Anda:

<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>

## Alat MCP yang Tersedia

| Alat | Kegunaan |
| :- | :- |
| `import_draft_guide` | Memvalidasi dan menyimpan panduan (XML/YAML/JSON) langsung sebagai draf privat ke akun Anda, mengembalikan tautan pemutar. |
| `get_guide_spec` | Mengembalikan aturan dan spesifikasi penulisan untuk domain seperti `os-install`, `linux-cli`, dll. |
| `list_plugins` | Mengembalikan daftar plugin penampil yang tersedia (`desktop-viewer`, `linux-wasix`, dll.). |
| `list_lab_profiles` | Mengembalikan lingkungan eksekusi lab yang didukung (`debian_qemu`, `ubuntu_qemu`, dll.). |
| `validate_course` | Memvalidasi struktur kursus dan skema XML tanpa menulis ke database. |
| `build_course` | Memvalidasi konten kursus dan mengembalikan XML yang diformat tanpa menyimpan ke database. |

## Sumber Daya yang Diekspos

| URI Sumber Daya | Deskripsi |
| :- | :- |
| `catalog://plugins` | Katalog plugin penampil dan kapabilitas runtime. |
| `catalog://lab-profiles` | Katalog profil eksekusi lab dan mesin virtual/kontainer. |
| `spec://os-install` | Panduan penulisan dan aturan lencana untuk panduan instalasi OS. |
| `schema://course` | Skema JSON untuk validasi struktur kursus. |
| `template://sample-course` | Kursus referensi dalam format YAML untuk pembelajaran agen. |

## Kuota dan Batas Impor

Mengimpor melalui `import_draft_guide` menggunakan kuota impor bulanan sesuai tingkat keanggotaan Anda:

* **Free** — Impor MCP tidak didukung (validasi dan build tetap tersedia).
* **Basic** — 5 impor per bulan.
* **Pro** — 10 impor per bulan.
* **Creator** — Tak terbatas.

<Tip>
  Panduan yang diimpor melalui MCP disimpan dengan `isPublished: false` (draf privat), sehingga tetap bersifat rahasia di akun Anda sampai Anda meninjau dan menerbitkannya di Studio.
</Tip>


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