Archicad

Archicad MCP

Claude、ChatGPT、または任意の MCP クライアントを、macOS と Windows で起動中の Archicad 29（30 も動作します）に接続します。自然な言葉で指示すると、サーバーが Archicad の JSON API と Tapir アドオンを介して実行します。

• オフィス標準に照らしてモデルをチェックします。 YAML ルールを開いているモデルに適用し、合否、スコア、不合格の要素を表示します。要素をハイライト表示したり、課題に変換したりできます。
• 要素を検索、読み取り、変更します。 条件クエリ、プロパティ、分類、GDL および IFC データ、お気に入り、属性、干渉チェックに対応しています。
• 要素を作成します。 壁、スラブ、柱、ドア、窓、ゾーン、階段、寸法など、30 種類以上の要素を作成できます。
• その他すべて。 公式コマンドと Tapir コマンド約 500 種類を、1 つのゲートウェイ経由で利用できます。

警告

プロパティを読み取る前に保存してください。 Archicad 29 では、要素を 1 つだけ読み取る場合でも、プロパティの読み取り時にクラッシュすることがあり、未保存の作業が失われます。サーバーではこれを防げません。 まず save_project を実行するようクライアントに指示し、 既知の問題も確認してください。

インストール

Claude Desktop： お使いのプラットフォーム用のバンドルを 最新リリースからダウンロードし、Settings > Extensions にドラッグします。バンドルには専用の Python が含まれているため、ほかにインストールするものはありません。

プラットフォーム	ファイル
Windows	archicad-mcp-0.12.0-win32.mcpb
macOS（Apple シリコン）	archicad-mcp-0.12.0-darwin-arm64.mcpb

Claude Code（uv が必要です）：

uv tool install archicad-mcp-server
claude mcp add archicad -- archicad-mcp --mode full

Tapir： ほとんどのツールでは、Archicad に Tapir アドオンが必要です。クライアントにTapir をインストールするよう指示するか、archicad-mcp install-tapir を実行してください。固定バージョンの Tapir 1.7.3 を sha256 で検証して Archicad の Add-Ons フォルダーに配置し、指示がない限り既存のものは置き換えません。その後、Archicad を再起動してください。

Intel Mac、手動で記述する Claude Desktop の設定、ChatGPT、Codex、およびすべての設定については、インストールを参照してください。

動作確認

Archicad を起動した状態で、クライアントにArchicad インスタンスを一覧表示するよう指示してください。ポート、Archicad のバージョン、開いているプロジェクト、Tapir のバージョン、および不足している場合にインストールするものが表示されます。クライアントにツールがまったく表示されない場合は、動作確認を参照してください。

できること

分野	ツール
QA	audit_delivery_readiness、run_rule、list_rules、verify_ifc_export_readiness、highlight_failures、create_issues_from_failures
検索と読み取り	find_elements、search_definitions、get_element_data、get_model_summary、get_project_info、list_attributes、find_collisions
変更	set_element_data、modify_elements、apply_favorites、move_elements、delete_elements、edit_attributes、edit_property_definitions、edit_classifications
作成	create_elements（40 種類）、create_swept_beam、create_road_marking、スケッチから家具、ドア、窓を配置するための learn_library_part
表示	show_elements、capture_window、選択ツール
課題と出力	Issue Manager と BCF、export_ifc、publish、save_project
Teamwork	reserve_elements、release_elements
一覧表	Scheme Settings の XML を介した read_schedule_scheme、edit_schedule_scheme、validate_schedule_scheme（Archicad に一覧表 API はありません）
ライブラリパーツ	メッシュモデル（OBJ、3DS）を GDL オブジェクトに変換：build_gdl_object、deploy_gdl_object
ゲートウェイ	list_api_commands、describe_api_command、execute_read_api_command、execute_write_api_command

各ツールの詳しい説明、チェック内容、必要なものについては、ツールを参照してください。

デフォルトで安全です。 要素、データ、定義の変更は、まずドライランを実行し、現在の値と新しい値を表示します。削除と移動には confirm=true も必要です。Archicad が操作を拒否する要素（別のビューにある要素、非表示またはロックされたレイヤー上の要素、ホットリンクモジュール、Teamwork で未予約の要素）は、理由を示してスキップされ、ロック解除されることはありません。確定後は書き込んだ内容を読み戻し、反映されなかった内容を報告します。

オフィスルール

ルールは、サーバーが参照するフォルダー（拡張機能のOffice rules folder設定、またはARCHICAD_MCP_RULES_DIR）に置かれた YAML ファイルです。

- id: walls-fire-rating
  type: property-required
  property: "OFFICE/Fire Rating"
  applies_to: { element_type: Wall }
  severity: error

組み込みのルールタイプが6種類あり、カスタムチェックは YAML と同じ場所に Python で記述します。実際のオフィス標準は、このリポジトリの外部に保管してください。ルールの作成を参照してください。

ドキュメント

• インストール：すべてのインストール方法、Tapir、設定
• ツール：すべてのツール、そのチェック内容と必要なもの
• 既知の問題
• 要素の検索と 要素データの読み取りと書き込み
• ルールの作成
• 一覧表
• GDL パイプラインとスクリプト作成
• API ダッシュボード： 到達可能なすべてのコマンドと、ツールが用意されているコマンド
• 開発：テスト、Tapir、バンドル、リリース

プライバシー

サーバーはお使いのマシンで実行され、127.0.0.1上のArchicadとのみ通信します。テレメトリーもバックエンドもありません。読み取られたデータは、要求したMCPクライアント（通常はClaude）に送信され、そのクライアントのプライバシー規約が適用されます。PRIVACY.mdを参照してください。

ライセンス

MIT。LICENSEを参照してください。