需先获取MG_MCP_TOKEN或组织级AccessToken：个人令牌在安全设置中生成并立即保存；组织令牌需企业管理员通过OpenAPI用app_id/app_secret换取，再于请求头X-MG-Authentication中携带。
要在MasterGo中调用API接口完成自动化设计操作、集成第三方系统或开发插件，必须先获取合法访问凭证并明确调用路径与参数格式。
获取个人访问令牌（MG_MCP_TOKEN）
打开浏览器，访问 https://www.php.cn/link/a3a92e719349dda06de72dac3448e149 并登录你的账号。
点击右上角头像 → 进入【个人设置】→ 切换到【安全设置】选项卡。
在“个人访问令牌”区域点击【生成令牌】按钮，为该令牌命名（例如：cli-deploy 或 plugin-dev），勾选所需权限范围（如 design:read、design:write），然后点击确认生成。
【生成后务必立即复制保存令牌值，页面刷新后将无法再次查看原始值】
调用 Magic MCP 工具执行设计规则检查
方法一：使用 npx 直接运行（无需全局安装）
在终端中执行以下命令，替换 YOUR_TOKEN 为上一步复制的完整令牌：
npx @mastergo/magic-mcp --token=YOUR_TOKEN --url=https://www.php.cn/link/a3a92e719349dda06de72dac3448e149 --rule=color-contrast --debug
方法二：通过配置文件集成到 Cursor 或 Cline 等支持 MCP 的 IDE 中
在 Cursor 的 settings.json 中添加 mcpServers 配置块，确保 【
{ "mcpServers": { "mastergo-magic-mcp": { "command": "npx", "args": [ "-y", "@mastergo/magic-mcp", "--token=abc123xyz...", "--url=https://www.php.cn/link/a3a92e719349dda06de72dac3448e149" ], "env": {} } } }
调用 OpenAPI 获取组织级 AccessToken
第一步：确认你拥有企业版账号且具备管理员权限，已进入企业管理后台的【应用管理】页面。
第二步：创建一个新应用，记录下系统分配的 app_id 和 app_secret。
第三步：向 MasterGo OpenAPI 发起 POST 请求：
请求地址：POST https://api.mastergo.com/openapi/v1/organization/application/token
请求头：Content-Type: application/json
请求体（JSON 格式）：
{ "app_id": "your_app_id_here", "app_secret": "your_app_secret_here" }
第四步：从响应 data.token 字段提取 AccessToken，并在后续所有 /openapi/v1/ 接口请求头中携带：
X-MG-Authentication: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
