MasterGo设计令牌使用方法

想在 Cursor 这类 AI 编程工具中直接读取 MasterGo 设计稿并生成代码，第一步就是获取设计令牌。设计令牌是打通设计与开发环境的唯一凭证。

以下详细介绍操作步骤。

获取 MasterGo 设计令牌

具体操作很简单：登录 MasterGo 网页版，点击右上角头像进入「个人设置」，切换到「安全设置」选项卡，找到「个人访问令牌」区域，点击「生成新令牌」。

生成时务必勾选“只读权限”。如果误选了读写权限，后续在 Cursor 中调用 MCP 时可能因权限过高被拦截，甚至触发安全风控。万一选错，删除后重新生成即可。

令牌命名建议采用“项目名_环境”格式，例如 dashboard_prod，便于多项目并行时清晰管理。有效期按需选择——长期协作项目可选“永不过期”，临时评审设置24小时足够。

生成成功后，页面会显示一串以 mg_ 开头的字符串。注意：该令牌仅显示一次，关闭页面后无法找回，必须立即复制保存。丢失后只能删除并重新生成。

验证令牌是否可用

拿到令牌后，在终端运行一行命令即可验证：

npx @mastergo/magic-mcp --token=你的实际令牌 --url=https://mastergo.com --debug

返回信息中如果包含 Connected to MasterGo API 以及用户信息，说明令牌有效。若提示 Unauthorized 或 Invalid token，需检查以下几点：令牌字符串是否完整复制（包括 mg_ 前缀），是否在 MasterGo 中误删了该令牌，以及账号是否属于团队或企业空间成员——访客账号无法生成有效令牌。

在 Cursor 中配置令牌

验证通过后，将令牌配置到 Cursor 中。

方法一：通过 mcp.json 文件配置

在 Cursor 设置中打开 MCP 配置目录，新建或编辑 mcp.json 文件，填入以下内容（将 YOUR_TOKEN 替换为你的真实令牌）：

{"mcpServers":{"mastergo-magic-mcp":{"command":"npx","args":["-y","@mastergo/magic-mcp","--token=YOUR_TOKEN","--url=https://mastergo.com"],"env":{}}}}

方法二：Windows 用户需额外适配

如果使用 Windows 系统且上述命令执行失败，可将 "command": "npx" 改为 "command": "cmd /c npx"，否则 Node.js 子进程可能无法正常启动。

保存文件后重启 Cursor，在设置页面观察 mastergo-magic-mcp 服务的状态。左侧出现绿色圆点，说明令牌已成功加载并完成初始化。

使用令牌读取设计稿

配置完成，接下来进入实际使用阶段。需要记住三个关键点。

第一步：确认设计稿位置合法

设计文件必须位于团队空间的具体项目中，URL 路径需包含 /team/ 字段，例如 https://mastergo.com/team/889900/file/abcd1234page_id=xxx&layer_id=yyy。草稿箱中的文件无法访问。

第二步：复制带 layer_id 的精准链接

在 MasterGo 中打开目标画板，选中需要解析的图层或画板，右键浏览器地址栏选择「复制链接地址」，确保 URL 中包含 &layer_id= 参数。没有 layer_id 的链接无法被精准读取。

第三步：在 Cursor Chat 中发起解析指令

切换到 Agent 模式，粘贴刚才复制的链接，然后输入指令，例如“请根据这个设计稿生成 React 函数组件”。AI 会自动调用 MCP 工具拉取 DSL 数据，无需截图、无需逐项描述尺寸和颜色，直接输出高保真代码。