twinmotion

Twinmotion MCP

APS を介した Twinmotion レンダリングパイプライン — Revit モデルをインポートし、環境を設定して、画像をレンダリングし、ウォークスルー動画を書き出します。

ツール（5）

ツール	説明
tm_import_rvt	Revit モデルを Twinmotion にインポートします
tm_set_environment	天候、時刻、環境を設定します
tm_render_image	静止画をレンダリングします（最大 8K）
tm_export_video	ウォークスルー動画を書き出します（MP4/MOV/WebM）
tm_list_scenes	保存済みのシーンとアニメーションを一覧表示します

クイックスタート

{
  "mcpServers": {
    "twinmotion": {
      "url": "https://twinmotion-mcp.itmartin24.workers.dev/mcp"
    }
  }
}

アーキテクチャ

• ランタイム：Cloudflare Workers
• 認証：APS OAuth2（client_credentials）
• キャッシュ：Cloudflare KV（トークンのキャッシュ）

ScanBIM Labs AEC MCP エコシステムの一部です

MIT — ScanBIM Labs LLC

認証

使用できるヘッダー形式は 2 種類です。どちらか一方を使用し、混在させないでください。

1. x-scanbim-api-key: <your_user_key> — 値には user_key をそのまま指定します。
2. Authorization: Bearer sk_scanbim_<your_user_key> — 値には sk_scanbim_ プレフィックスを含む文字列全体を指定します。D1 の user_key 列には、この文字列全体を設定する必要があります。

形式を混在させると、別のキーに対して新しい無料プランの行が自動作成されます（切り替えるたびに、新しい 50 クレジットのアカウントが通知なく作成されます）。

user_key は scanbim.app/settings/billing で取得できます。

使用例

curl -X POST https://mcp.scanbimlabs.io/unified/mcp \
  -H "content-type: application/json" \
  -H "x-scanbim-api-key: $SCANBIM_USER_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{}}}'

レスポンスコード

• 200 — ツール呼び出しが実行され、クレジットが差し引かれました。
• 401 — 認証ヘッダーがないか、形式が正しくありません（ミドルウェアは JSON-RPC エラーコード -32001 を返します）。
• 402 — クレジットが不足しています。レスポンスボディには、5 種類すべてのクレジットパックの checkout_urls と、請求ページの top_up_url が含まれます。