MasterGo AI 设计稿转代码功能可实现一键预览，听起来如同魔法般便捷，但真正的关键并非“点击生成代码”，而是打通设计数据与 AI 工具之间的结构化桥梁。其核心在于启用 MCP（Model Context Protocol）协议，让 AI 能够直接解析画布中的 DSL 结构化数据，而非依赖截图进行视觉识别。整体配置流程并不复杂，但每个环节都直接影响后续能否顺利生成可用的前端代码。
确认账号权限并生成 Personal Access Token（个人访问令牌）
仅企业版账号且拥有查看或编辑权限的设计稿，才能被 MCP 协议正常读取。若账号为访客或仅具备评论权限，则无法调用相关 API——这是首要前提条件。
- 登录 MasterGo 平台 → 点击右上角头像 → 进入个人设置 → 选择安全设置
- 点击“生成令牌”，有效期推荐设置为 180 天（不建议选择永久有效，以保障账户安全）
- 复制生成的 token（格式类似 mg_xse1da89123n），后续配置步骤中需要填入
配置 Cursor 等支持 MCP 的 IDE 接入 MasterGo MCP Server
Cursor 是目前最常用的集成环境，它通过本地运行 @mastergo/magic-mcp 包，将设计稿的 DSL 数据实时拉取为 JSON 结构，供 AI 模型解析处理。操作流程并不复杂，但有几个容易踩坑的细节需要注意。
- 启动 Cursor → 进入设置 → MCP 配置 → 点击 “Add new global MCP Server”
- 在自动创建的 mcp.json 配置文件中粘贴以下内容（请将
mg_token替换为你自己的实际 token）：
{"mcpServers":{"mastergo-magic-mcp":{"command":"npx","args":["-y","@mastergo/magic-mcp","--token=mg_token","--url=https://mastergo.com"],"env":{"NPM_CONFIG_REGISTRY":"https://registry.npmjs.org/"}}}}- 保存配置文件后重启 Cursor；若右下角出现 “MasterGo MCP” 工具列表，则表示配置已生效
- 常见配置失败原因包括：Node.js 版本低于 v18、npm 镜像源不可达、Windows 环境下未指定 cmd 启动方式——这些细节往往容易导致卡顿
在 Cursor 中触发 DSL 数据获取与代码生成
需要特别说明：并非上传文件或截图，而是直接基于画布链接进行操作——这才是“一键预览”的真正含义。
- 在 MasterGo 设计稿中，右键点击目标页面或图层 → 选择“复制容器链接”
- 切换回 Cursor，新建空白文件，粘贴刚才复制的链接，并开启右下角的 Agent 模式
- 输入指令，例如：“根据这个 DSL 生成一个响应式 React 页面，使用 Tailwind CSS，保留按钮悬停效果”
- AI 将调用
getDSL工具解析设计结构，再结合语义信息生成可直接运行的代码片段
验证与微调：预览效果不等同于完整交付
生成的代码属于“可运行预览”版本，并非最终交付成果。它可以还原布局结构、基础样式和简单交互效果（如 hover 悬停、跳转箭头等），但业务逻辑、状态管理、API 接口等内容仍需手动补充完善。这一点需要保持理性认知。
- 代码生成后可直接在 Cursor 内运行 HTML 文件，或启动本地开发服务预览实际效果
- 如果组件语义识别不准确（例如将图标误识别为文字），可以在 MasterGo 中对图层进行重命名（如 “PrimaryButton”、“HeaderNa v”），从而提高 DSL 解析的准确率
- 颜色、间距等设计变量若已在 MasterGo 中定义为设计系统变量，DSL 会自动完成映射，无需手动硬编码——这正是设计系统真正发挥价值的关键所在