AI エージェントの接続
linkcad-mcp は LinkCAD 11.3 以降に含まれ、インストールフォルダーの linkcad の隣にインストールされます。
| プラットフォーム | パス |
|---|---|
| Windows | C:\Program Files\LinkCAD 11\linkcad-mcp.exe(既定のインストールフォルダー) |
| Linux | /opt/linkcad/linkcad-mcp |
エージェントのアプリケーション(MCP クライアント)が linkcad-mcp を自ら起動し、標準入力と標準出力を通じて通信します。ユーザーが起動する必要はなく、ネットワークポートも開きません。インストーラーはどのクライアントの設定も変更しません。以下の説明に従い、クライアントごとに 1 回サーバーを登録してください。
フォルダーの選択
サーバーは、エージェントが使用できるフォルダーを知る必要があります。登録時にそれぞれ指定します。
--root <フォルダー>は、そのフォルダー以下のファイルの読み書きをエージェントに許可します。--read-root <フォルダー>は、そのフォルダー以下のファイルの読み込みだけを許可します。--root内の--read-rootは、その部分を読み取り専用にします。
どちらも複数回指定でき、各フォルダーは存在している必要があります。エージェントはこれらのフォルダーの外のパスを使用できず、自分でフォルダーを追加することもできません。エージェントが指定した相対パスは、エージェントが使用できる最初のフォルダーを基準に解決されます。
登録内容の出力
linkcad-mcp --print-config <クライアント> は、このインストールのパスとフォルダーを、そのクライアントが期待する形式で含む登録内容を出力します。対応するクライアントは claude-code、claude-desktop、vscode、cursor です。
& "C:\Program Files\LinkCAD 11\linkcad-mcp.exe" --print-config claude-desktop ` --root "C:\CAD\Work" --read-root "C:\CAD\Library"/opt/linkcad/linkcad-mcp --print-config claude-code --root ~/cadクライアントへの登録
Claude Code
--print-config claude-code が出力する claude mcp add コマンドを実行します。次のようなコマンドです。
claude mcp add --transport stdio --scope user linkcad -- /opt/linkcad/linkcad-mcp --root /home/me/cad--scope user により、すべてのプロジェクトで LinkCAD を使用できます。claude mcp list でサーバーが接続されたかどうかを確認できます。
Claude Desktop
-
Settings > Developer > Edit Config を開きます。
claude_desktop_config.jsonが開きます。Windows では%APPDATA%\Claude\claude_desktop_config.json、Linux では~/.config/Claude/claude_desktop_config.jsonです。 -
--print-config claude-desktopが出力するmcpServersのエントリをファイルに追加します。{"mcpServers": {"linkcad": {"command": "C:\\Program Files\\LinkCAD 11\\linkcad-mcp.exe","args": ["--root", "C:\\CAD\\Work", "--read-root", "C:\\CAD\\Library"]}}} -
Claude Desktop を完全に終了してから、もう一度起動します。
VS Code(GitHub Copilot)
--print-config vscode が出力する servers のエントリをワークスペースの .vscode/mcp.json に追加し、MCP ビュー、またはファイル内のエントリの上に表示される Start からサーバーを起動します。Copilot CLI は ~/.copilot/mcp-config.json またはワークスペースの .mcp.json から mcpServers を読み込みます。そこでは claude-desktop の形式を使用してください。
Cursor
--print-config cursor が出力するエントリを、プロジェクトの .cursor/mcp.json、またはすべてのプロジェクト用の ~/.cursor/mcp.json に追加します。
その他のクライアント
stdio でサーバーを起動する MCP クライアントであれば、linkcad-mcp を使用できます。プログラムのパスをコマンドとして、フォルダーのオプションを引数として指定してください。
サーバーオプション
| オプション | 意味 |
|---|---|
--root <フォルダー> | エージェントが読み書きできるフォルダー。複数指定可。 |
--read-root <フォルダー> | エージェントが読み込みだけできるフォルダー。複数指定可。 |
--allow-python | LinkCAD の組み込みインタープリターで Python コードを実行する execute_python ツールを提供します。コードはユーザーの権限で実行され、上記のフォルダーに制限されません。コンピューター上でスクリプトの実行を任せられるエージェントに対してのみ有効にしてください。 |
--call-timeout <秒> | 1 回のツール呼び出しに許可する時間。これを超えると LinkCAD が再起動されます。既定値は 600。0 で無制限になります。 |
--idle-timeout <秒> | 図面が開かれていない状態で LinkCAD が待機できる時間。これを超えるとメモリを解放するために停止されます。既定値は 900。0 で停止しません。 |
--print-config <クライアント> | claude-code、claude-desktop、vscode、cursor の登録内容を出力して終了します。 |
--version、--help | バージョンまたはオプションの一覧を出力して終了します。 |
接続の確認
エージェントに「LinkCAD の状態は?」と尋ねます。エージェントは get_status を呼び出し、LinkCAD のバージョン、ライセンスの状態、保有するライセンス、フォルダー、開いている図面を報告します。最初の呼び出しでは LinkCAD が起動するため、数秒かかります。
トラブルシューティング
| 症状 | 原因と対処 |
|---|---|
| クライアントでサーバーが失敗または切断と表示される。 | 登録内容のプログラムのパスを確認してください。Windows では JSON ファイル内のすべてのバックスラッシュを二重にする必要があります。--print-config はこれを自動で行います。 |
エージェントが path_outside_roots または no_roots_configured を報告する。 | ファイルが --root または --read-root で指定したフォルダーの下にありません。登録にフォルダーを追加し、クライアントを再起動してください。 |
エージェントが path_not_writable を報告する。 | フォルダーが --read-root です。--root のフォルダーの下に書き出してください。 |
エージェントが ..._license_required または format_not_licensed のエラーを報告する。 | このコンピューターにないライセンスが作業に必要です。ライセンスを参照してください。 |
エージェントが license_blocked を報告する。 | ライセンスがこのコンピューターでの LinkCAD の動作を許可していません。たとえば、登録されていない場合です。get_status が理由を示します。LinkCAD アプリケーションを起動して登録してください。 |
エージェントが timeout または worker_crashed を報告する。 | LinkCAD が再起動され、開いていた図面はすべて閉じられました。エージェントはファイルを開き直して再試行します。大きなファイルに時間がかかる場合は --call-timeout を大きくしてください。 |
LinkCAD 自体のログはサーバーの標準エラー出力に送られ、ほとんどのクライアントは MCP ログとして表示します(Claude Desktop では Settings > Developer)。
各呼び出しはデスクトップアプリケーションの設定ではなく LinkCAD の既定のオプションから始まり、エージェントの操作がそれらの設定に保存されることはありません。