ProjectArchiSymphonyMCP

Rev—

Sheet社内配布 / Internal

未認証

Autodesk Revit × Claude · Model Context Protocol

ArchiSymphonyMCP

Revit の全 APIを Claude から制御する PLS 社内アドイン。建具表生成・モデル検査・自律修正——手作業 8 時間を 30 秒に。BIM/CIM の現場のための、設計者による設計者の道具。

775+

MCP Methods

Revit 2025·26·27

89%

AI-actionable API

100%

Named-pipe Local

Claude Code × Revit

Claude Code から全 Revit API を
入力・編集できます

よく使う操作は 1,330 の専用メソッドで高速・型安全に。それ以外も Universal API Bridge が reflection で RevitAPI / RevitAPIUI の全 public メソッド・プロパティに到達します。作成・変更・削除はすべて Revit トランザクションで安全に実行。MCP サーバーを登録すれば、あなたの AI バディが Revit を直接操作します。

revit_call — 全 1,330 メソッド

revit_api_invoke — 任意 API 実行(transacted)

revit_api_set_property — 任意プロパティ書込

revit_api_list_members — 型 introspection

ダウンロード

外部PC接続キット（Windows / Mac・Revit 不要）

Revit を動かしている PC 以外の、同じ社内 LAN 上のあなたの PC から接続する場合に使います。クライアント側に Revit / MSI は不要（Python だけ）。展開して Windows は scripts\install-lan-windows.ps1 -RevitHost <Revit PCのIP>（Mac は scripts/install-lan-mac.sh）を実行 → トークンを 1 回貼り付けるだけ。トークンの取得方法・手動手順は同梱 README と AI バディ用ガイドに記載。

キットをダウンロード

インストーラは 1 本だけ。実行するとインストール済みの Revit（2025 / 2026 / 2027）を自動判別し、該当する全バージョンへ一括導入します。管理者権限不要・「プログラムの追加と削除」に登録・新版はそのまま上書き更新。

統合インストーラ MSI

Revit 自動判別 · 2025 / 2026 / 2027 一括導入 · 管理者権限不要

旧バージョン（アーカイブ）

最新版で不具合が出た場合の退避用です。通常は最新版をご利用ください。

v1.0.0 MSI

2026-06-13 · named pipe のみ（LAN TCP 非対応）· Revit 自動判別

インストール手順

所要 1 分。MSI はコード署名済みです。管理者権限は不要です（perUser インストール）。

初回のみ（その PC で 1 回・管理者）: 「ポリシー違反 / 発行元不明」で実行できない場合は、PLS の発行元証明書を信頼させます。下の 2 ファイルを保存し、管理者 PowerShell で実行 → 証明書 (.cer) ・ trust-pls-cert.ps1

# 同じフォルダに 2 ファイルを置き、管理者 PowerShell で:
powershell -ExecutionPolicy Bypass -File .\trust-pls-cert.ps1

（ドメイン環境なら GPO で全社一括信頼も可能。詳細は CTO へ）

Revit を終了
インストール対象の Revit (2025/2026/2027) を閉じておきます。
MSI をダブルクリック
ダウンロードした ArchiSymphonyMCP-Setup-1.1.0.msi（1 本）をダブルクリックするだけ。インストール済みの Revit を自動判別し、該当する全バージョン（2025/2026/2027）へ一括導入します。「プログラムの追加と削除」に登録され、アンインストールもそこから可能です。

バージョンアップ時は新しい MSI を実行するだけ。同じ UpgradeCode で自動的に上書き更新されます。
Revit を起動
起動時にアドイン ArchiSymphonyMCP が自動ロードされ、named pipe ArchiSymphonyMCP<ver> でリッスンを開始します。

初回起動時にバージョンが最新かを自動確認します。新しい版がある場合は通知とこのページへの案内が表示されます。

疎通確認

パイプが立っているか確認:

[System.IO.Directory]::GetFiles("\\.\pipe\") | Where-Object { $_ -match "ArchiSymphonyMCP" }
# => \\.\pipe\ArchiSymphonyMCP2027

使用方法

アドインは Revit 内で named pipe サーバーを公開します。1 行 JSON {"method":..,"params":..} を書き込み、1 行 JSON の応答を受け取る単純なプロトコルです。

A. 付属ヘルパー `mcp-query.ps1` で試す

# 読み取り系のツアー (Revit 起動 + モデルを開いた状態で)
.\scripts\mcp-query.ps1 -RevitVersion 2027

# プロジェクト情報
.\scripts\mcp-query.ps1 -RevitVersion 2027 -Method getProjectInfo

# 壁エレメントを取得
.\scripts\mcp-query.ps1 -RevitVersion 2027 -Method getElements -ParamsJson '{"category":"Walls"}'

# 個別エレメントの全プロパティ
.\scripts\mcp-query.ps1 -RevitVersion 2027 -Method getElementProperties -ParamsJson '{"elementId":52627473}'

# 利用可能な全メソッドを列挙 (455 件 / 47 カテゴリ)
.\scripts\mcp-query.ps1 -RevitVersion 2027 -Method listMethods

B. 主要メソッド（抜粋）

method	params	用途
getDocumentInfo	{}	開いているモデルの概要・リンク・ワークセット
getProjectInfo	{}	プロジェクト情報（組織名・番号・住所等）
getLevels	{}	全レベルと標高
getElements	{"category":"Walls"}	カテゴリ別エレメント一覧
getElementProperties	{"elementId":N}	全パラメータ + バウンディングボックス
listMethods	{}	利用可能な全メソッドの列挙

メソッド名は必ず listMethods で確認してください（455 メソッド・カテゴリ: Walls / Doors-Windows / Sheets / Schedules / MEP / Structural ほか 47 分類）。

C. Claude / Claude Code から全 API を入力・編集

MCP サーバー (mcp-server/) を Claude Code / Claude Desktop に登録すると、Claude が 全 Revit API を read/write で直接操作できます。設定例:

{
  "mcpServers": {
    "archisymphony-revit": {
      "command": "python",
      "args": ["mcp-server/server.py", "--revit", "2027"]
    }
  }
}

公開ツール（これだけで全 API に到達）:

tool	用途
revit_list_methods	全 1,330 メソッドを発見（まず最初に）
revit_call	任意の named メソッドを実行（作成/変更/削除/読取・トランザクション）
revit_api_invoke	Universal Bridge: 任意の RevitAPI メソッドを reflection 実行（transacted）
revit_api_get_property / set_property	任意プロパティの読取 / 書込
revit_api_list_members	任意の Revit API 型を introspection

編集例（Universal Bridge で壁の上端レベルオフセットを変更）:

# AI バディへの指示例
revit_api_set_property( target="52627473", property="get_Parameter(...)" )
# あるいは named メソッド経由
revit_call( method="setParameter", params={"elementId":52627473, "name":"上部レベル オフセット", "value":3000} )

トラブルシュート

症状	原因 / 対処
パイプが見つからない	Revit が起動しているか / アドインがロードされているか確認。Revit「アドイン」タブに ArchiSymphonyMCP が無ければ再インストール。
接続タイムアウト	モデルを 1 つ開いてから実行（モデル未読込時は一部メソッドが応答しません）。
METHOD_NOT_FOUND	メソッド名を `listMethods` で再確認。旧 alias は廃止されています。
文字化け	PowerShell の出力を UTF-8 に: `[Console]::OutputEncoding=[Text.Encoding]::UTF8`。
更新通知が出た	新しい版が公開されています。本ページ 01 からインストーラを再実行してください。

対応 API 一覧

対応している API はすべて掲載しています（専用 MCP メソッド — 件）。未対応の領域も末尾に明記します。

対応メソッド（カテゴリ別・全件）

対応 API 領域（Revit API namespace 別）

下記 namespace の操作は専用メソッド + 汎用 Universal API Bridge で到達可能です。

未対応の API

未対応: 読み込み中…

API 対応方針とロードマップ

目標は 全 Revit API 対応（read / write）。二層構成で「未対応で詰まない」ことを保証します。

対応方針

① named メソッド	頻出操作（作成/編集/読取）を 1,330 の専用メソッドで高速・型安全に提供。`revit_call` から実行。
② Universal Bridge	named に無い API も reflection で RevitAPI/RevitAPIUI の全 public に到達（`revit_api_invoke` / `set_property`）。常にこの逃げ道があるため「未対応で詰む」ことが無い。
③ 段階的 named 化	業務で頻出する API から順に named 化（要望 → CTO → 専用メソッド追加）。named 化率は本ページの Tier 指標で四半期ごとに更新。
④ 安全性	全呼び出しは multitenancy 検証 + 監査ログ。編集は Revit トランザクション。破壊的操作は AI が件数・対象を提示し事前確認。

ロードマップ

完了 v1.0	named 1,330 + Universal Bridge 全到達 + Claude Code 連携（全 API read/write）。Revit 2025/2026/2027 対応、社員限定 magic-link 配布、起動時バージョンチェック。
進行 Phase 2 〜6/28	Neo4j 双方向同期、頻出編集系メソッドの named 拡充、進和建設建具表テンプレート。
予定 Phase 3 〜7/19	日本基準ナレッジ、建具表・帳票生成 + 公印 + PDF 出力。
予定 Phase 4 〜8/30	Revit 2027 完全対応、100 テナント並列の負荷検証、OSS 公開。

要望（named 化してほしい API・業務操作）は CTO（クロード）へ。次の四半期サイクルで優先度付けして対応します。

変更履歴

—読み込み中…

サインイン

ArchiSymphonyMCP

ダウンロード

インストール手順

Revit を終了

MSI をダブルクリック

Revit を起動

疎通確認

使用方法

A. 付属ヘルパー mcp-query.ps1 で試す

B. 主要メソッド（抜粋）

C. Claude / Claude Code から全 API を入力・編集

トラブルシュート

対応 API 一覧

対応メソッド（カテゴリ別・全件）

対応 API 領域（Revit API namespace 別）

未対応の API

API 対応方針とロードマップ

対応方針

ロードマップ

変更履歴

A. 付属ヘルパー `mcp-query.ps1` で試す