メインコンテンツまでスキップ

MCP で接続する

AR Clip は MCP サーバーを公開しています。Model Context Protocol を話すツールなら、あなたの プロジェクトを直接扱えます。シーンを読む、オブジェクトを足す、イベントを配線する、patch を書く。

エンドポイント​

https://<your-server>/api/mcp/v1

認証は bearer トークンです。

Authorization: Bearer <your-api-token>

トークンはアカウント設定の API & MCP で作成します。

トークンはパスワードと同じ扱いで

これはあなたのプロジェクトを変更できます。共有するものには絶対に入れず、漏れたら取り消してください。

スコープ​

トークンは、あなたが与えたものしか持ちません。

スコープ許可されること
editor:readプロジェクト・シーン・リソースの読み取り
editor:writeそれらの作成と変更
editor:ai生成系のツール
editor:publish公開

分析だけをさせたいなら、読み取り専用のトークンを渡してください。 書けないモデルは何も 壊せませんし、有用な仕事の多く — シーンの点検、発火しない理由の説明、変更の計画 — はそれ以上を 必要としません。

何がつながるか​

streamable HTTP 上の MCP を実装しているものなら何でも。実際には Claude Desktop、Claude Code、 Cursor、そして対応するエディターが増えつつあります。サーバーを登録する場所はそれぞれ違います。 上の URL とトークンを渡してください。

エディターと並べて使う​

アシスタントの変更は、エディターにその場で反映されます。 同僚の変更と同じで、ほかの編集と 同じように共同作業の履歴にも残ります。

ですから、うまくいくやりかたはこうです。片方の画面でエディターを開いたまま変更を頼み、起きるのを 見る。意図と違うときにその場で気づけます。あとから発見するのではなく。

セッションは、いまどのプロジェクトのどの space を扱っているかを覚えているので、毎回の依頼で 言い直す必要はありません。

ツールが扱う範囲​

頼みたくなる内容ごとにまとめます。

領域アシスタントにできること
シーンオブジェクトの一覧・作成・移動・親子付け・複製・削除
component任意のオブジェクトの任意の component の読み取りと設定
イベントトリガーとステップの一覧、イベントの追加と編集
patchノードグラフの読み書きと検証、コンパイル結果のコードの確認
アニメーションタイムラインのプリセットの作成
物理ボディ・collider・初速の設定
リソースプロジェクトのツリーの閲覧、フォルダー作成、アセットの取り込みと生成
UIUI カードの読み書き
公開適切なスコープがあれば公開

サーバーの外へ手を伸ばすため見落としやすい、もう 4 つ。

ほかにも何をするか
スクリーンショットビューポートを撮影し、アシスタントが自分の作ったものを見られるようにします
計測オブジェクトの実際のバウンディングサイズをメートルで。縮尺の確認に使います
シーンの書き出しシーンをデータとして取り出します
Blender ブリッジ起動中の Blender とやりとり。オブジェクトの一覧、シーンの送出と取り込み
スクリーンショットは証拠にはなりません

アシスタントが自分の仕事を見られるのは助けになりますが、静止画は、script が動くか、物理が落ち着くか、 マーカーが追従するかについて何も語りません。それらは実機でのプレビューが必要です。

プラットフォームそのものをモデルに説明するツールがあります

list_component_schemas・list_event_types・list_patch_nodes、そして describe_*_api 系の ツールは、動いているエンジンから答えます。学習データから推測するのではなく、実際に存在する ものを調べられるということです。モデルが component の名前をでっち上げているようなら、まずこれらを 呼ぶよう伝えてください。

用意されたタスク​

サーバーは、MCP クライアントがコマンドとして表示するプロンプトもいくつか提供します。

プロンプト内容
build-scene説明からシーンを組み立てる
add-interactivityタップ・トリガー・ステップを配線する
animateタイムラインを組む
audit-scene問題を探す
prepare-publish公開前に確認しておく価値のあることを点検する

変更せずに読む​

サーバーは、自分のリファレンスをクライアントが読めるリソースとして公開しています。

was://project/info        was://scene/current       was://scene/selection
was://scripting/api       was://patch/api           was://events/api
was://physics/api         was://timeline/api        was://resources/api
was://ui/api

これらはエンジンから生成されるので、もう存在しないバージョンのプラットフォームを説明することは ありません。

次へ: アシスタントのスキル