MasterGo Magic MCP — это автономный сервис MCP (Model Context Protocol), предназначенный для соединения инструментов проектирования MasterGo с моделями ИИ. Он позволяет AI-моделям напрямую получать данные DSL из файлов дизайна MasterGo.

Ключевые особенности

• Извлечение данных DSL из файлов дизайна MasterGo
• Работает напрямую с NPX
• Внешние зависимости не требуются, требуется только Node.js окружение

Урок

• https://mastergo.com/file/192644601973042

Примеры запросов

После подключения MCP-сервера вы можете использовать следующие запросы в вашем AI-чате:

Извлечение SVG и предпросмотр в HTML:

Восстановить дизайн до кода:

Замените {domain}, {fileId} и {layerId} на ваши фактические значения. Вы также можете использовать короткие ссылки:

Восстановить дизайн и сохранить его как HTML-файл:

Вы также можете использовать короткие ссылки:

Использование

Получение MG_MCP_TOKEN

1. Посетите https://mastergo.com
2. Войдите в личные настройки
3. Нажмите на вкладку «Настройки безопасности»
4. Найдите личный токен доступа
5. Нажмите, чтобы сгенерировать токен

Требования к разрешению

Важно: Если инструмент подключён, но возвращает ошибку «нет разрешения», пожалуйста, проверьте следующие условия:

1. Требование версии аккаунта:

MasterGo Magic MCP

MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed to connect MasterGo design tools with AI models. It enables AI models to directly retrieve DSL data from MasterGo design files.

Key Features

• Retrieves DSL data from MasterGo design files
• Runs directly with npx
• No external dependencies required, only Node.js environment needed

Tutorial

• https://mastergo.com/file/192644601973042

Example Prompts

Once the MCP server is connected, you can use the following prompts in your AI chat:

Extract SVG and preview in HTML:

Extract SVG and preview in HTML: https://{domain}/file/{fileId}?layer_id={layerId}

Restore a design to code:

Restore design: https://{domain}/file/{fileId}?layer_id={layerId}

Replace {domain}, {fileId}, and {layerId} with your actual values. You can also use short links:

Restore design: https://{domain}/goto/{shortLink}

Restore a design and save as an HTML file:

Restore design, save as HTML file: https://{domain}/file/{fileId}?layer_id={layerId}

You can also use short links:

Restore design, save as HTML file: https://{domain}/goto/{shortLink}

Usage

Obtaining MG_MCP_TOKEN

1. Visit https://mastergo.com
2. Enter personal settings
3. Click the Security Settings tab
4. Find the personal access token
5. Click to generate the token

Permission Requirements

Important: If the tool is connected but returns a “no permission” error, please check the following conditions:

1. Account Version Requirement:

   • Requires Team Edition or higher MasterGo account
   • Personal free edition does not support MCP tool access

2. File Location Requirement:

   • Design files must be placed in Team Projects
   • Files in draft box cannot be accessed via MCP tools

Command Line Options

npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--proxy=PROXY_URL] [--format=FORMAT] [--header "Key: Value"] [--debug] [--no-rule] [--no-prefix]

Parameters:

• --token=YOUR_TOKEN (required): MasterGo API token for authentication
• --url=API_URL (optional): API base URL, defaults to http://localhost:3000
• --rule=RULE_NAME (optional): Add design rules to apply, can be used multiple times
• --proxy=PROXY_URL (optional): HTTP/HTTPS proxy URL (e.g., http://127.0.0.1:7890), also supports HTTPS_PROXY / HTTP_PROXY environment variables