@mastergo/magic-mcp 0.1.1 → 0.1.4

package/README.md

@@ -24,6 +24,18 @@ MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed
 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
 
 ```
@@ -52,13 +64,16 @@ Alternatively, you can use environment variables instead of command line argumen
 - `API_BASE_URL`: API base URL
 - `RULES`: JSON array of rules (e.g., `'["rule1", "rule2"]'`)
 
-### Installing via Smithery
+### Installing via Smithery Marketplace
 
-To install MasterGo Magic for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mastergo-design/mastergo-magic-mcp):
+Smithery is an MCP server marketplace that makes it easy to install and manage MCP services.
 
-```bash
-npx -y @smithery/cli install @mastergo-design/mastergo-magic-mcp --client claude
-```
+#### Method 1: Install via Smithery Website
+
+1. Visit [Smithery Marketplace](https://smithery.ai/server/master/mastergo-magic-mcp-smithery)
+2. Click the "Connect" or "Install" button
+3. Select your MCP client (e.g., Claude Desktop, Cursor, etc.)
+4. Follow the prompts to complete installation and configuration
 
 ### LINGMA Usage
 
@@ -192,14 +207,14 @@ Contains markdown files with additional documentation:
 ## Local Development
 
 1. Run `yarn` and `yarn build` to install dependencies and build the code
-2. Find the absolute path of `bin/cli.js`
+2. Find the absolute path of `dist/index.js`
 3. Add local MCP configuration with your token
 
 ```json
 "mastergo-mcp-local": {
   "command": "node",
   "args": [
-    "absolute/path/to/bin/cli.js",
+    "absolute/path/to/dist/index.js",
     "--token=mg_xxxxxx",
     "--url=https://mastergo.com",
     "--debug"

package/README.zh-CN.md

@@ -24,6 +24,18 @@ MasterGo Magic MCP 是一个独立的 MCP（Model Context Protocol）服务，
 4. 找到个人访问令牌
 5. 点击生成令牌
 
+### 权限要求
+
+**重要提示**：如果工具已连接但返回"没有权限"错误，请检查以下条件：
+
+1. **账户版本要求**：
+   - 需要 **团队版** 或 **团队版以上** 的 MasterGo 账户
+   - 个人免费版不支持 MCP 工具访问
+
+2. **文件位置要求**：
+   - 设计文件必须放在 **团队项目** 中
+   - 草稿箱中的文件无法通过 MCP 工具访问
+
 ### 命令行选项
 
 ```
@@ -52,6 +64,16 @@ npx @mastergo/magic-mcp --token YOUR_TOKEN --url API_URL --rule RULE_NAME --debu
 - `API_BASE_URL`: API 基础 URL
 - `RULES`: 规则的 JSON 数组 (例如: `'["rule1", "rule2"]'`)
 
+### 通过 Smithery 市场安装
+
+
+#### 方式一：通过 Smithery 网站安装
+
+1. 访问 [Smithery 市场](https://smithery.ai/server/master/mastergo-magic-mcp-smithery)
+2. 选择你的 MCP 客户端（如 Claude Desktop、Cursor 等）
+4. one-click install 打开对应客户端，弹出tools&mcp 点击install
+5. connect->open->optional setting中填入token->connect
+
 ### LINGMA 使用方法
 
 在 vscode 拓展市场中搜索 LINGMA -> 然后安装该拓展
@@ -184,14 +206,14 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
 ## 本地开发
 
 1. 运行 `yarn` 和 `yarn build`，安装依赖并构建代码
-2. 查看 `bin/cli.js` 的绝对路径
+2. 查看 `dist/index.js` 的绝对路径
 3. 在 MCP 配置中添加本地 MCP 配置，其中 token 为您获取的 token
 
 ```json
 "mastergo-mcp-local": {
   "command": "node",
   "args": [
-    "bin/cli.js绝对路径地址",
+    "dist/index.js绝对路径地址",
     "--token=mg_xxxxxx",
     "--url=https://mastergo.com",
     "--debug"