MCP AIエージェント連携

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

主なワークフロー

アクセストークン発行と接続

設定 → AIトークンでアクセストークンを発行し、AIエージェントの設定ファイルにリモートMCPエンドポイント（https://mcp.xkat.space/mcp）を登録します。

AIエージェントに自然言語で依頼

エージェントにプロンプトを送ります: 「QEMUベースのDebian 12インストール実習ガイドを作成して。」

環境検出とガイド生成

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

下書きインポートとプレイヤーリンク取得

エージェントが import_draft_guide を実行してアカウントの非公開下書きに即時保存し、プレイヤー直行リンク（https://xkat.space/ja/player/<id>）を返します。

クライアント別設定方法

利用するAIツールの設定ファイルにxkat MCPサーバーを追加します:

Claude Code (.mcp.json)
Cursor (.cursor/mcp.json)
Antigravity (mcp_config.json)

{
  "mcpServers": {
    "xkat": {
      "type": "http",
      "url": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "xkat": {
      "url": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "xkat": {
      "serverUrl": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

利用可能な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 — 無制限。

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

スタジオの基本

AIで作成

設計と検証

公開と収益化

MCP AIエージェント連携

主なワークフロー

クライアント別設定方法

利用可能なMCPツール

公開リソース

インポート制限

​主なワークフロー

​クライアント別設定方法

​利用可能なMCPツール

​公開リソース

​インポート制限

主なワークフロー

クライアント別設定方法

利用可能なMCPツール

公開リソース

インポート制限