独立社区指南 · 从理解到动手

SolidCraft MCP 配置：把建模工具接入 Claude

SolidCraft 的 MCP 服务可让兼容的 AI 客户端调用本机建模工具。先安装 CLI，再选择 Claude Code 或 Claude Desktop，以及 Headless（无界面）或桌面桥接模式。下方生成器会准备 JSON；检测安装、启动进程和验证连接，需要在自己的电脑上完成。

官方资料核对日期：2026/10/16

开始前准备：安装可由客户端启动的 SolidCraft CLI，并安装所选 Claude 客户端。桌面桥接还需要 SolidCraft 桌面应用。

查看官方安装说明

MCP 配置生成器

01 选择客户端

Claude Code在终端中使用Claude Desktop使用桌面客户端

02 选择运行方式

Headless独立建模会话，无需打开窗口桌面桥接连接已启动的桌面应用

03 填写本机 CLI 路径CLI 可执行文件路径

可填写 PATH 中的命令名，或不带引号的绝对路径。Snap 安装的 CLI 命令为 solidcraft.cli。查看各安装方式的路径示例

配置在当前浏览器中生成。
不会将 CLI 路径或生成的 JSON 加入统计事件。

配置预览JSON

.mcp.json可以复制

{
  "mcpServers": {
    "solidcraft": {
      "command": "solidcraft-cli",
      "args": [
        "mcp"
      ]
    }
  }
}

生成器仅准备配置文件；安装软件、合并已有设置和连接 MCP 需要在本机完成。如果下载后的文件名为 mcp.json，请先重命名为 .mcp.json。首次保存或导出前，请先设置文件夹访问权限。

修改左侧选项，配置预览会同步更新。

接下来，在本机完成

将配置应用到 Claude Code。

在项目根目录保存为 .mcp.json 。部分浏览器下载时会去掉文件名开头的点，请将 mcp.json 重命名为 .mcp.json。若已有其他 MCP 服务，请将 solidcraft 条目合并到现有的 mcpServers 对象中。
在该项目中打开 Claude Code，按提示审核并批准项目的 MCP 服务；必要时重新启动会话。
在 Claude Code 中输入 /mcp ，查看服务状态和可用工具。若启动失败，先确认 CLI 已安装且路径正确。

也可以用命令注册默认的 Headless 服务

claude mcp add solidcraft -- solidcraft-cli mcp

项目 JSON 和此命令选择一种即可。命令使用 Claude Code 默认的本地作用域，不会创建共享的项目 .mcp.json，也不会授予项目文件夹权限。首次写入前请参照文件夹权限说明完成设置。

官方 Claude Code 配置指南

CLI 路径怎么填？先看你的安装方式。

以下示例依据官方 v0.13.1 打包定义核对。请先确认文件在本机存在。生成器的路径栏只填写 CLI 可执行文件，不要加两端引号，也不要把启动参数写进路径。

Windows 安装版：默认路径为 C:\Program Files\SolidCraft\solidcraft-cli.exe。如改过安装目录或使用便携 ZIP，请填写对应文件夹中的 CLI。旁边的桌面程序是 solidcraft.exe。

macOS DMG：如果已拖入应用程序文件夹，CLI 路径为 /Applications/SolidCraft.app/Contents/MacOS/solidcraft-cli。拖入 Applications 并不意味着 CLI 已加入 PATH。启动桌面桥接时，在终端另行执行 /Applications/SolidCraft.app/Contents/MacOS/SolidCraft --control 7878，端口需与配置一致。

Linux 原生包或 CLI 压缩包：客户端可通过 PATH 找到时，填写 solidcraft-cli；否则填写安装或解压后的绝对路径。仅有 AppImage 桌面启动器，不代表系统中已有独立 CLI 命令。

Snap：CLI 填写 solidcraft.cli；桌面控制接口仍使用 solidcraft --control 7878 启动。

Flatpak：/app/bin/solidcraft-cli 位于沙箱内部，不能直接当作宿主机路径填写。可安装独立原生 CLI，或自行创建可执行包装脚本，调用 Flatpak CLI 并转发参数，再填写脚本的绝对路径。连接 Flatpak 桌面时还涉及沙箱网络与控制 token 的访问，请参照官方包定义及 MCP 文档。

核对来源：Windows 安装器、macOS 打包脚本、Flatpak 定义与官方安装指南。

按你的工作方式选择

独立运行，
或连接桌面窗口。

两种模式都由客户端在本机启动 MCP 服务。AI 模型是否在本地运行、数据如何处理以及相关费用，取决于所选客户端和服务。

Headless（无界面）

solidcraft-cli mcp

使用独立设计会话，无需打开桌面窗口。适合不需要在窗口中观察操作的流程。

桌面桥接（Bridged）

solidcraft-cli mcp --connect 127.0.0.1:7878

将工具调用转发给已启用控制接口的桌面应用，便于在窗口中观察设计。桌面应用与 CLI 需运行在同一台电脑，端口一致。

首次保存或导出前，先设置专用文件夹。

新的 Headless 会话默认可访问恢复文件夹和自己的临时工作文件夹，但不会自动获得项目目录权限。把 .mcp.json 放在项目中，也不代表 SolidCraft 可以访问该项目的文件。

先在本机创建一个专用文件夹，然后在已保存配置中，为 solidcraft 的 args 数组追加两个独立条目：--allow-path 和该文件夹的绝对路径。Headless 示例：

{
  "args": [
    "mcp",
    "--allow-path",
    "/absolute/path/to/designs"
  ]
}

这里只展示 args 字段，请保留配置中的其他内容，并把示例路径改为本机已存在的文件夹。Windows 路径在 JSON 中需要转义反斜杠，例如 "C:\\Users\\you\\Documents\\SolidCraft"。桥接模式要保留已有的 mcp、--connect 和地址端口，再追加上述两个条目。

修改启动参数后，重启 MCP 服务，尝试在该文件夹保存和导出，并检查实际生成的文件。生成器不会自动添加目录授权，也无法检查本机文件系统。

已打开的设计也可能让其目录可访问，但目录需要严格位于用户主目录或临时目录内部，并排除隐藏文件夹。显式 --allow-path 会授权指定目录及其中的隐藏文件，请使用专用工作区。客户端的工具批准、系统权限及沙箱规则仍然适用；遇到错误时参照官方文件访问规则排查。

常见问题

生成 JSON 之后，连接问题怎么排查？

提示找不到 solidcraft-cli，怎么办？

先确认安装包包含 CLI，再检查客户端能否找到该命令。可直接填写 CLI 的绝对路径，不加两端引号。Snap 使用 solidcraft.cli，Flatpak 还涉及沙箱环境，参照安装方式与路径示例。

服务能连接，但无法保存或导出文件？

确认目标文件夹已存在且已授权。新的 Headless 会话不会自动继承项目目录权限，按文件夹授权说明设置 --allow-path 后重启服务，再检查系统写入权限和沙箱限制。

桥接模式提示没有桌面应用在监听？

先用 solidcraft --control PORT 或该安装方式对应的桌面命令启动控制接口，保持应用运行，再确认配置中的本机地址和端口一致。沙箱安装还需检查 token 的访问。

Claude 中看不到 MCP 服务？

检查 JSON 语法、mcpServers 外层结构和 CLI 路径，然后重新加载或重启客户端。Claude Code 中可使用 /mcp 检查状态及项目服务审批；Claude Desktop 需完全退出并重新打开，必要时查看 MCP 日志。

下载文件会覆盖原有 MCP 设置吗？

下载只会产生新文件。已有配置时，请只把 solidcraft 条目合并进 mcpServers，保留其他服务和设置。生成器不会读取或修改现有配置。

这个网页会连接我的电脑或 AI 账号吗？

生成器在浏览器中生成、复制或下载配置文本，不会连接本机 CLI 或 AI 账号。本站使用 Google Analytics 统计访问量，CLI 路径、生成的 JSON 和 token 不会被加入统计事件。

资料与出处

有据可查，按需深入。

资料核对日期：2026/10/16。软件持续更新，界面和功能请以所用版本及官方文档为准。官方链接可能为英文资料。

SolidCraft MCP 命令与客户端示例 CLI 安装说明 Claude Code MCP 文档 Claude Desktop 本地 MCP 指南