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

# Agent IA MCP

> Connectez Claude, Cursor et des agents MCP pour générer et importer des cours instantanément.

Connectez des agents IA externes (Claude Code, Cursor, Antigravity et d'autres outils compatibles Model Context Protocol) à xkat. Grâce à une seule consigne en langage naturel, votre agent IA peut découvrir les environnements de laboratoire disponibles, rédiger un guide pratique complet selon les règles du domaine et l'importer directement sur votre compte en tant que brouillon privé.

## Flux de travail rapide

<Steps>
  <Step title="Connexion via jeton d'accès personnel">
    Générez un jeton d'accès dans [Paramètres → Jetons IA](https://xkat.space/fr/settings/ai-tokens), puis enregistrez le point de terminaison distant MCP (`https://mcp.xkat.space/mcp`) dans la configuration de votre agent.
  </Step>

  <Step title="Demande en langage naturel">
    Demandez simplement : *« Crée un guide pratique d'installation de Debian 12 avec QEMU. »*
  </Step>

  <Step title="Découverte et génération du guide">
    L'agent appelle `list_lab_profiles` et `get_guide_spec` pour identifier les environnements pris en charge (`debian_qemu`) et les contraintes de rédaction (une commande par carte, diagrammes Mermaid, masquage de la plomberie interne).
  </Step>

  <Step title="Import instantané et lien vers le lecteur">
    L'agent exécute `import_draft_guide` pour enregistrer le cours comme brouillon privé sur votre compte et renvoie un lien direct vers le lecteur (`https://xkat.space/fr/player/<id>`).
  </Step>
</Steps>

## Configuration du client

Ajoutez le serveur MCP distant xkat au fichier de configuration de votre agent :

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

## Outils MCP disponibles

| Outil | Description |
| :- | :- |
| `import_draft_guide` | Valide et enregistre directement un guide (XML/YAML/JSON) comme brouillon privé sur votre compte, puis renvoie le lien du lecteur. |
| `get_guide_spec` | Renvoie les règles et spécifications de rédaction pour des domaines comme `os-install`, `linux-cli` ou `database-sql`. |
| `list_plugins` | Liste les plugins de visualisation disponibles (`desktop-viewer`, `linux-wasix`, etc.). |
| `list_lab_profiles` | Liste les environnements d'exécution de lab pris en charge (`debian_qemu`, `ubuntu_qemu`, etc.). |
| `validate_course` | Valide la structure du cours et le schéma XML sans écrire dans la base de données. |
| `build_course` | Valide le contenu du cours et renvoie le XML mis en forme sans persistance. |

## Ressources exposées

| URI de la ressource | Description |
| :- | :- |
| `catalog://plugins` | Catalogue des plugins de visualisation et fonctionnalités d'exécution. |
| `catalog://lab-profiles` | Catalogue des profils de lab et machines virtuelles/conteneurs. |
| `spec://os-install` | Spécification de rédaction de guides pour l'installation d'OS invité. |
| `schema://course` | Schéma JSON décrivant la structure valide d'un cours. |
| `template://sample-course` | Cours de référence en YAML pour l'apprentissage de l'agent. |

## Quotas et limites d'importation

L'importation via `import_draft_guide` consomme le quota mensuel de votre niveau d'adhésion :

* **Free** — Importation MCP non prise en charge (validation et build disponibles).
* **Basic** — 5 importations par mois.
* **Pro** — 10 importations par mois.
* **Creator** — Illimité.

<Tip>
  Les guides importés par MCP sont enregistrés avec `isPublished: false`, restant strictement privés sur votre compte jusqu'à ce que vous les vérifiiez et les publiiez dans Studio.
</Tip>


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