必须配置有效的mastergo设计令牌才能在cursor中自动读取设计稿生成代码；需登录mastergo网页版→个人设置→安全设置→生成只读令牌，命名建议“项目名_环境”，有效期按需选择，令牌仅显示一次且须立即复制保存；通过终端命令验证有效性，再在cursor的mcp.json中配置令牌并重启，确保服务状态为绿色即成功。
要在 Cursor 或其他支持 MCP 的 AI 编程工具中自动读取 MasterGo 设计稿并生成代码，必须先配置有效的设计令牌（Personal Access Token），这是唯一能打通设计系统与开发环境的身份凭证。
获取 MasterGo 设计令牌
登录 MasterGo 网页版 → 点击右上角头像 → 进入「个人设置」→ 切换到「安全设置」选项卡 → 找到「个人访问令牌」区域 → 点击「生成新令牌」。
生成时【必须勾选“只读权限”】，否则后续在 Cursor 中调用 MCP 时可能因权限过高被平台拦截或触发安全风控；若误选“读写权限”，需手动删除该令牌后重新生成。
命名建议采用“项目名_环境”格式（如 dashboard_prod），方便后期多项目管理；有效期按需选择——长期协作项目选“永不过期”，临时评审可设为24小时。
生成成功后，页面会显示一串以 mg_ 开头的长字符串，立即复制保存。该令牌【仅显示一次，关闭页面即无法再次查看】，丢失后只能删除重置。
验证令牌是否可用
打开终端，执行以下命令：
npx @mastergo/magic-mcp --token=你的实际令牌 --url=https://mastergo.com --debug
若返回包含 Connected to MasterGo API 和用户信息的 JSON 响应，说明令牌有效；若提示 Unauthorized 或 Invalid token，请检查：① 是否复制了完整字符串（含 mg_ 前缀）；② 是否在 MasterGo 中误删了该令牌；③ 账号是否属于团队/企业空间成员（访客账号无法生成有效令牌）。
在 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/abcd1234?page_id=xxx&layer_id=yyy），草稿箱（Drafts）中的文件不可被 MCP 访问。
第二步：复制带 layer_id 的精准链接
在 MasterGo 中打开目标画板 → 选中需解析的图层或画板 → 右键浏览器地址栏 → 「复制链接地址」，确保 URL 中包含 &layer_id= 参数。
第三步：在 Cursor Chat 中发起解析指令
切换至 Agent 模式 → 粘贴上述链接 → 输入指令：“请根据这个设计稿生成 React 函数组件”，AI 将自动调用 MCP 工具拉取 DSL 数据，无需截图、无需描述尺寸颜色，直接输出高保真代码。
