> ## 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 KI-Agent

> Verbinden Sie Claude, Cursor und MCP-Agenten, um Kurse im Handumdrehen zu erstellen und zu importieren.

Verbinden Sie externe KI-Agenten (Claude Code, Cursor, Antigravity und weitere Tools mit Model Context Protocol) mit xkat. Mit einer einzigen Eingabeaufforderung in natürlicher Sprache kann Ihr KI-Agent verfügbare Laborumgebungen ermitteln, eine praxisnahe Anleitung nach Domänenregeln erstellen und diese direkt als privaten Entwurf in Ihr Konto importieren.

## Schneller Ablauf

<Steps>
  <Step title="Verbindung über persönliches Zugriffstoken">
    Erstellen Sie ein Zugriffstoken unter [Einstellungen → KI-Tokens](https://xkat.space/de/settings/ai-tokens) und tragen Sie den Remote-MCP-Endpunkt (`https://mcp.xkat.space/mcp`) in die Konfiguration Ihres Agenten ein.
  </Step>

  <Step title="Anfrage in natürlicher Sprache stellen">
    Fragen Sie Ihren Agenten wie gewohnt: *„Erstelle eine Praxisanleitung zur Installation von Debian 12 mit QEMU.“*
  </Step>

  <Step title="Umgebungserkennung & Leitfadenerstellung">
    Der Agent ruft `list_lab_profiles` und `get_guide_spec` auf, um unterstützte Umgebungen (`debian_qemu`) und Erstellungsregeln (ein Befehl pro Karte, Mermaid-Diagramme, keine internen Plattformdetails) zu ermitteln.
  </Step>

  <Step title="Sofortiger Import & Player-Link">
    Der Agent ruft `import_draft_guide` auf, speichert den Kurs direkt als privaten Entwurf in Ihrem Konto und gibt den direkten Player-Link (`https://xkat.space/de/player/<id>`) zurück.
  </Step>
</Steps>

## Client-Konfiguration

Fügen Sie den xkat-MCP-Server zur Konfigurationsdatei Ihres Agenten hinzu:

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

## Verfügbare MCP-Tools

| Tool | Zweck |
| :- | :- |
| `import_draft_guide` | Validiert und speichert eine Anleitung (XML/YAML/JSON) direkt als privaten Entwurf in Ihrem Konto und gibt den Player-Link zurück. |
| `get_guide_spec` | Ruft Erstellungsregeln und Spezifikationen für Domänen wie `os-install`, `linux-cli` oder `database-sql` ab. |
| `list_plugins` | Listet verfügbare Viewer-Plugins (`desktop-viewer`, `linux-wasix` usw.) auf. |
| `list_lab_profiles` | Listet unterstützte Laborumgebungen (`debian_qemu`, `ubuntu_qemu` usw.) auf. |
| `validate_course` | Überprüft die Kursstruktur und das XML-Schema, ohne in die Datenbank zu schreiben. |
| `build_course` | Überprüft den Kursinhalt und gibt formatiertes XML zurück, ohne es zu speichern. |

## Bereitgestellte Ressourcen

| Ressourcen-URI | Beschreibung |
| :- | :- |
| `catalog://plugins` | Katalog der Viewer-Plugins und Laufzeitfunktionen. |
| `catalog://lab-profiles` | Katalog der Laborprofile und virtuellen Umgebungen/Container. |
| `spec://os-install` | Spezifikation und Badge-Regeln für OS-Installationsanleitungen. |
| `schema://course` | JSON-Schema zur Überprüfung der Kursdateistruktur. |
| `template://sample-course` | Referenzkurs in YAML für das In-Context-Lernen des Agenten. |

## Import-Kontingente & Limits

Der Import über `import_draft_guide` verbraucht das monatliche Kontingent Ihrer Mitgliedschaftsstufe:

* **Free** — Kein MCP-Import möglich (Validierung und Build stehen zur Verfügung).
* **Basic** — 5 Importe pro Monat.
* **Pro** — 10 Importe pro Monat.
* **Creator** — Unbegrenzt.

<Tip>
  Über MCP importierte Anleitungen werden mit `isPublished: false` gespeichert und bleiben strikt privat, bis Sie sie im Studio prüfen und veröffentlichen.
</Tip>


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