# Udonarium Axe の AI連携(MCP)を用いた Muse の TRPG セッション参加に関する検証報告 ※本レポートに登場するサーバーURL・部屋名・プレイヤー名・キャラクター名などの固有名詞は、すべてダミー表記に置き換えている。また、記載する機能・道具はすべて公式版の範囲のもののみである。 --- ## 1. 概要 本ドキュメントは、パーソナルAIエージェント「Muse」を、オンラインセッションツール「Udonarium Axe」の AI連携(MCP)機能に接続し、TRPG のセッションへ参加させる検証の記録である。 検証の目的はシンプルで、**「MCP連携を用いて Muse と TRPG を一緒に遊びたい!」** というものである。普段チャットで会話している AI を、チャットの外にある実際の「卓」の中――盤面のコマ、チャットログ、ダイスの判定――に入れて、セッションの参加者として一緒に遊べるかどうか。その実現方法と実用性を確認するために、本検証を行った。 結論を先に述べると、公式手順のままでは Muse を接続することはできなかったが、接続構成を工夫することで接続に成功し、実戦闘を通したテストプレイ(ソード・ワールド2.5、上級戦闘)まで完遂できた。本レポートでは、その課題と解決方法、テストプレイの結果と振り返りをまとめる。 ## 2. 前提(公式の仕組み) Udonarium Axe の AI連携(MCP)は、次の3要素で構成される公式機能である。 1. **ブリッジ**(`axe-mcp.mjs`):ユーザーの PC 上で動作する小さなプログラム。Axe のタブと AI アプリの間を取り持つ 2. **AI アプリ**:Claude Code / Claude Desktop など、PC 上で動作する MCP 対応アプリ。ブリッジを起動し、道具(ツール)を通じて部屋を読み、操作する 3. **Axe のタブ**:ブラウザで開いた Axe の部屋。画面内の AI連携パネルで「つなぐ」を押すと、そのタブがブリッジに接続する 仕様上の主なポイントは以下のとおり。 - 接続した AI は「つないだタブの席」として振る舞う。読めるのはその席から見えるものだけ、できるのはその席の役割でできることだけに限られる - 権限は「読むだけ」「書くことも許す」の2段階。GM 用の道具(BGM・カットイン・エフェクト等)は GM 席でのみ使える - 公式の道具は全31個(読む道具8、書く道具11、GM の道具10、AI GM 用の道具2)。部屋の読み取り、チャット発言、ダイス、コマ移動、リソース変更などが行える - AI が送った発言には全員の画面で AI の印が付き、接続開始・終了・権限変更は全員向けのシステム行として表示される - AI は「頼まれたときにだけ動く」設計である。部屋の出来事を待ち受けるには `wait_for_events` という道具を繰り返し呼ぶ待機ループが公式の作法とされ、GM として進めるための手引きも用意されている - **ブリッジは同一 PC の中(loopback)からの接続しか受け付けない**。他の PC からは接続できないことが仕様として明記されている。また、ブリッジに繋げるタブは1つだけである ## 3. 事前の課題 公式手順は「AI アプリとブリッジと Axe のタブが、すべてユーザーの PC の上で動く」ことを前提にしている。しかし Muse はこの前提に当てはまらない。 - **Muse はユーザーの PC 上ではなく、専用の VM 上で動作する別マシンである** - Muse には、PC 上のプログラムファイルを MCP サーバーとして登録する仕組みがない(外部連携はリモート側の APIキー/OAuth 型が前提) - ブリッジが同一 PC 内の接続しか受け付けないため、VM からユーザーの PC のブリッジには原理的に届かない - Muse のクラウドブラウザで Axe のタブを開いても、そのブラウザから見た接続先は VM 側を指すため、「ブリッジが見つかりません」となり接続できない(実測で確認) つまり課題は、「MCP クライアントがブリッジに届くこと」と「Axe のタブがブリッジに届くこと」の両方を、同一マシン上で同時に満たすことである。 ## 4. 課題の解決方法 解決の発想は、**公式構成の3要素をすべて Muse の VM の中に再現する**ことである。 ``` [ Muse の VM ] MCPクライアント(自作の小さなスクリプト) │ http://127.0.0.1:<ポート>/mcp ブリッジ axe-mcp.mjs(--http モードで起動) │ ws://127.0.0.1:<ポート> ヘッドレスブラウザ(VM 内で起動)で開いた Axe のタブ │ https / wss [ Axe のサーバー ] ``` 具体的な手当ては以下のとおり。 - **ブリッジは `--http` モードで VM 内に起動する**。公式にも用意された起動方法で、MCP のやりとりを標準入出力ではなく `http://127.0.0.1:<ポート>/mcp` で受け付ける形になる。自前設置の Axe を使う場合は、許可するページを指定する `--allow-origin` を併せて指定する - **MCP クライアントは最小実装を自作する**。接続の初期化から道具の一覧取得・呼び出しまでの正式手順を話す小さなスクリプトで足りる - **Axe のタブは VM 内のヘッドレスブラウザで開く**。このブラウザから見た接続先は VM 自身を指すため、タブとブリッジの接続が成立する。部屋への参加は通常の招待リンクをそのまま開けばよい - **AI連携パネルの操作(権限の選択と「つなぐ」)も自動化する**。画面要素の特定が不安定な箇所は、スクリーンショット上で位置を特定して操作する方法に落ち着いた - 環境固有の詰まりとして、VM の外向き通信の制限を回避する中継の自作や、証明書の扱いの調整が必要だった。これらは Muse の VM のネットワーク設計に起因するもので、ブリッジや Axe 側の仕様ではない さらに、セッション本番での運用に耐えるため、次の2点も併せて整えた。 - **開始と終了の合図は、ユーザーとのチャットから出す**運用とした。開始時に部屋への参加と待機を始め、終了で全て止める - **待機と監視を分離した**。部屋の出来事を待ち受けて応答する担当とは別に、ブリッジ・中継・タブの生存を監視する仕組み(supervisor)を置き、いずれかが落ちても自動で再起動するようにした。ブリッジとタブを意図的に終了させる試験で、自動復帰できることを確認済みである ## 5. 実際のプレイを通しての検証結果 接続の疎通だけでなく、実際の戦闘プレイを通して運用できるかを検証した。 ### テストプレイの概要 - システム:ソード・ワールド2.5 - 内容:上級戦闘。冒険者レベル9の PC 1名を Muse 側が操作し、GM 役は別の AI が担当。高レベルモンスター複数体を相手に、味方 PC 2名と共闘する構成 - 条件:**公式の道具のみを使用する**こと - 操作対象の PC の情報は、コマに設定されたシートデータの読み取りに加え、コマ内の情報に記録されていた外部キャラクターシートの URL を開いて詳細(能力値・特技・装備・所持品)まで確認した ### 結果 - **第7ラウンドで敵全滅、PC 側の勝利**で戦闘終了。開始から終了まで、待機→GM の指示を受ける→判定・移動・攻撃→裁定を待つ、という一連の流れを通しで運営できた - 操作した PC の最終状態は HP 51(戦闘中の呪いにより最大 HP が 80 から 68 に低下)。受けたダメージは合計29点 - 攻撃は各ラウンドで実施し、適用ダメージは1回あたり17〜30点。味方との連携(付与された支援効果の適用、とどめの分担)も GM の裁定のもとで成立した - 使用した道具は次の7種のみ:`read_chat`、`get_turn_order`、`get_room`、`get_piece`、`wait_for_events`、`send_chat`、`move_piece` - 判定はすべて、コマのチャットパレットのコマンド文字列を `send_chat` で送信し、タブ側のダイスボットが処理する形を取った(`roll_dice` は未使用)。HP の増減適用は GM 側が行ったため `change_resource` も未使用である - 先制判定については、開始直後に後述の権限トラブルで送信が遅れたが、復旧後に GM 指定の式で実施できた ### 応答速度とトークン消費量 - **応答速度**:部屋のチャットの時刻から実測したところ、Muse 側の1手の応答は直前の発言から **2〜22秒後、概ね10秒前後**だった。攻撃の一連の流れ(宣言→命中判定→ダメージ判定)も数秒間隔で進み、セッションの進行を妨げる水準ではなかった - **トークン消費量(参考値)**:待機担当の稼働は約24分(戦闘前の待機とトラブル対応時間を含む)で、入力 約2,057万トークン/出力 約3.0万トークンだった。使用枠への換算では、週間無料枠の約2ポイント分に相当した。ただし枠の消費はトークン数の単純換算ではないため、これはあくまで参考値である ## 6. テストプレイの振り返り ### 良かった点 - 戦闘の開始から終了まで、実際のセッションの流れ(待機・判定・移動・攻撃・裁定待ち)を AI 参加者として一貫して回すことができた - 定型の判定だけでなく、「対象によっては有効でない支援効果の修正を、GM の裁定に沿って手動で調整する」といった応用的な判断も、その場で確認を取りながら実施できた - 応答速度は実用範囲内であり、待機+自動復帰の構成により、要素が落ちても立て直せることを実証できた ### 問題点と課題 1. **再接続時に席の AI 権限が初期化される**:部屋側のネットワーク再接続が発生した際、AI への権限が初期値の「読むだけ」に戻って再接続され、書き込みが `not_allowed` で止まった。対策として、再接続の前に権限を選び直す処理を自動化に組み込んだ。併せて、再接続時は出来事のカーソルも無効になるため、取り直しが必要な点も運用上の注意として残る 2. **チャットパレットは1行で送る必要がある**:定義行を含む複数行で送信すると、ダイスボットが反応しない場合があった。1行だけで送れば、変数はタブ側が自動で解決して正常に処理される 3. **パレット変数の過大適用**:対象依存の修正(特定の種別にのみ有効な支援効果など)でも、パレット内の変数は対象を問わず解決されてしまう。対象外の相手には修正を落とした式を手動で組む必要があり、ここは AI 側の注意力と GM との確認が要る 4. **コスト構造**:待機ループは「出来事のたびに担当が目覚め、文脈全体を読み直して次の一手を決める」作りのため、入力トークンの消費は発言量ではなくセッションの長さと文脈の大きさに比例して増える。長時間のセッションでは、担当に持たせる文脈の絞り込みや、担当の立て直しのタイミングが課題になる 5. **VM 自体の再起動には監視が及ばない**:監視の仕組みごと VM が再起動した場合は式全体が落ちるため、チャット側で気づいて再起動する手順が別途必要である 6. **進行マナー**:一部の場面で、手番の判定を GM の目標提示より僅かに先行して送信してしまった。結果的に採用されたが、厳密には GM の指示文を待ってから判定する方が綺麗な流れであり、運用面の改善点である ## 7. 補足:Muse の TRPG 知見について 本検証の担当である Muse の、対象システムに対する知見の自己評価を記す。いずれも「ルールの運用とセッションの流れには強いが、正確なデータの暗記には限界がある」という前提つきである。 - **ソード・ワールド2.5**:実務レベル。判定処理の流れ、戦闘の運営、シナリオ作成や戦闘数値の調整といった作業は扱える水準にある。今回のテストプレイでも、シートとパレットを読み取り、GM の裁定に従って戦闘を運営できた。一方で、サプリメント収録の特技・アイテム等の厳密な数値や文面は、記憶だけに頼らず原典で確認する必要がある - **クトゥルフ神話TRPG(第6版/第7版)**:実務レベル。技能判定、プッシュ・ロール、幸運、正気度(SAN)喪失と狂気の処理など、基本ルールとセッション運営の枠組みは理解している。一方で、神話生物・呪文・アイテムの正確なステータスや、個別シナリオ固有の数値は原典確認が必要である 数値が勝敗に直結する場面では、AI の記憶ではなく、シートや原典の値で裏取りする運用を前提としたい。 ## 8. 参考文献 - Udonarium Axe 公式マニュアル「AI連携(MCP)」 https://xelltis.github.io/udonarium_axe/manual/ai-link - Udonarium Axe 公式マニュアル「AI連携の道具とブリッジの設定」 https://xelltis.github.io/udonarium_axe/manual/ai-link-reference - Udonarium Axe 公式マニュアル「AI GM」 https://xelltis.github.io/udonarium_axe/manual/ai-gm