连接 AI 智能体
LinkCAD 11.3 及更高版本会将 linkcad-mcp 安装在安装文件夹中 linkcad 的旁边:
| 平台 | 路径 |
|---|---|
| Windows | C:\Program Files\LinkCAD 11\linkcad-mcp.exe(默认安装文件夹) |
| Linux | /opt/linkcad/linkcad-mcp |
智能体所在的应用程序(MCP 客户端)会自行启动 linkcad-mcp,并通过其标准输入和标准输出进行通信。您无需启动它,它也不会打开网络端口。安装程序不会更改任何客户端的配置;请按照下文所述,为每个客户端注册一次服务器。
选择文件夹
服务器需要知道智能体可以使用哪些文件夹。注册时逐一指定:
--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 | 提供 execute_python 工具,在 LinkCAD 的嵌入式解释器中运行 Python 代码。代码以您的用户权限运行,并且不受上述文件夹限制,因此仅对您允许在计算机上运行脚本的智能体启用。 |
--call-timeout <秒> | 单次工具调用在 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 的默认选项开始,而不是从桌面应用程序的设置开始,智能体所做的任何操作都不会保存到这些设置中。