> ## 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、AntigravityなどのAIエージェントで実習ガイドを即時生成し、アカウントにインポートします。

外部AIエージェント（Claude Code、Cursor、Antigravity、その他Model Context Protocol対応ツール）をxkatに接続しましょう。自然言語プロンプト1つで、AIエージェントがxkatのラボ環境を把握し、ドメイン仕様に準拠したインタラクティブ実習ガイドを作成して、アカウントの非公開下書きに直接インポートできます。

## 主なワークフロー

<Steps>
  <Step title="アクセストークン発行と接続">
    [設定 → AIトークン](https://xkat.space/ja/settings/ai-tokens)でアクセストークンを発行し、AIエージェントの設定ファイルにリモートMCPエンドポイント（`https://mcp.xkat.space/mcp`）を登録します。
  </Step>

  <Step title="AIエージェントに自然言語で依頼">
    エージェントにプロンプトを送ります: *「QEMUベースのDebian 12インストール実習ガイドを作成して。」*
  </Step>

  <Step title="環境検出とガイド生成">
    エージェントが `list_lab_profiles` と `get_guide_spec` を呼び出し、対応環境（`debian_qemu`）と作成規則（カードあたり単一コマンド、Mermaid図、プラットフォーム内部構造の非表示）を確認してガイドを生成します。
  </Step>

  <Step title="下書きインポートとプレイヤーリンク取得">
    エージェントが `import_draft_guide` を実行してアカウントの非公開下書きに即時保存し、プレイヤー直行リンク（`https://xkat.space/ja/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インストール（`os-install`）、Linux CLI（`linux-cli`）などドメイン別の作成仕様を返します。 |
| `list_plugins` | 利用可能なビューアープラグイン（`desktop-viewer`、`linux-wasix`など）の一覧を取得します。 |
| `list_lab_profiles` | 対応しているラボ実行環境（`debian_qemu`、`ubuntu_qemu`など）の一覧を取得します。 |
| `validate_course` | DBに保存せず、講義構造とXMLスキーマの有効性を検証します。 |
| `build_course` | 入力された講義を検証し、正規化されたXMLとして生成して返します（DB保存なし）。 |

## 公開リソース

| リソースURI | 説明 |
| :- | :- |
| `catalog://plugins` | ビューアープラグインおよび機能カタログです。 |
| `catalog://lab-profiles` | 利用可能なラボ実行環境および仮想マシン/コンテナカタログです。 |
| `spec://os-install` | ゲストOSインストールガイドの作成仕様および規則です。 |
| `schema://course` | 有効な講義ファイルを定義するJSON Schemaです。 |
| `template://sample-course` | エージェントが学習・参照できるYAML形式のサンプル講義です。 |

## インポート制限

`import_draft_guide` によるインポートはメンバーシッププランの月間インポート制限を共有します:

* **Free** — MCPインポート未対応（検証およびビルドは可能）。
* **Basic** — 月5回。
* **Pro** — 月10回。
* **Creator** — 無制限。

<Tip>
  MCPでインポートされたガイドは `isPublished: false`（非公開下書き）として保存されるため、スタジオで確認して公開するまで外部には公開されません。
</Tip>


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