MCP

把造个模接到自己的 Agent

用一个访问令牌，让 Claude、Cursor 或其他远程 MCP 客户端读写你的云端模型。字段格式与造个模编辑器里的 Agent 相同。

创建访问令牌打开工作台

它能做什么

接入之后，Agent 操作的是你账号下的参数化脚本，不是一张静态网格。

列出和读取模型，包括完整的 JSCAD 源码。
新建模型，或用精确替换修改已有脚本。
遵守 paramSchema、具名零件，以及配置和零件名称这两段保留块。

三步接入

登录后打开设置 → MCP，创建一个令牌。明文只出现一次，请立刻复制。
在 Claude Desktop、Cursor 或其他客户端加入下面的远程 MCP 配置，把令牌填进 Authorization。
让 Agent 先调用 get_script_format，再创建或修改模型。它会返回编辑链接，在造个模里打开即可预览。

客户端配置

生产环境的服务地址：

https://www.zaogemo.com/mcp

本地开发把地址换成 http://localhost:5181/mcp，令牌仍在本地设置页创建。

{
  "mcpServers": {
    "zaogemo": {
      "url": "https://www.zaogemo.com/mcp",
      "headers": {
        "Authorization": "Bearer zgm_你的令牌"
      }
    }
  }
}

可用工具

客户端完成连接后可以调用这些工具。Prompt write_model 和 edit_model 带有同一份写作约定。

get_script_format — 读取 paramSchema、保留块和零件字段格式。写脚本前先调用。
list_models / get_model — 按标题或 id 查找，并读取一个模型。
create_model / update_model / apply_patch — 新建、整段替换，或按唯一原文打补丁。更新时可带上 expected_version，避免盖掉更新的保存。
delete_model — 删除一个云端模型。

资源 zaogemo://formats/fields 是这些字段的 JSON 说明，zaogemo://formats/guide 是同一份文字说明。

脚本字段

几何单位是米。表示毫米的参数以 Mm 结尾，在脚本里乘 0.001。只能 import @jscad/modeling。

defaultParams / paramSchema — 可调参数和可选的控件说明。type 可以是 number、integer、string、boolean、array；step 只是调节步长。
configuredParams — 保存在 // <3ddesign-configuration> 里。这是用户保存的参数覆盖，改代码时要原样保留。
main 返回 { name, id?, group?, geom, printable? }。多色模型拆成多个零件，用 colorize 上色。
partOverrides — 保存在 // <3ddesign-parts> 里。这是用户改过的零件名和分组，改代码时要原样保留。

使用时注意

MCP 不编译几何，也不导出 STL。改完后打开工具返回的编辑链接预览。
每个账号最多 8 个令牌。服务端只保存哈希，撤销后立即失效。
令牌只能访问该账号自己的模型。广场和公开分享链接不需要令牌。