How to set up MCP Assistant for Claude to operate my NAS with natural language commands?

如何设置 MCP 助手，使 Claude 能够通过自然语言命令操作我的 NAS？

1. If your NAS runs QTS/QuTS hero 5.2.1 or later versions:
   1. Log in to your QNAP NAS.
   2. Go to the App Center.
   3. On the top-right corner, click  
   4. Select Join the QNAP App Beta Program and click Apply.
   5. In the search bar, search for MCP Assistant.
   6. Click Install.
2. If your NAS runs QTS/QuTS hero 5.2.0:
   1. Go to the webpage of App Center.
   2. Search for MCP Assistant.
   3. Click MCP Assistant from the search result.
   4. Select your NAS model.
   5. Download the installation file.
   6. Log in to your QNAP NAS.
   7. Go to App Center.
   8. On the right-top corner, click  
   9. Select Install Manually.
   10. Click Browse and upload the installation file that you just downloaded from the QNAP website.
   11. Click Install.

1. Locate the MCP Assistant from the Main Menu.
2. Launch MCP Assistant.
    

1. In the MCP Assistant, go to the Credentials tab.
2. Click Create to generate a new key.
3. Enter a descriptive name for the key, select the key type, and choose the user account to associate with this key.
   Tip

   By default, Read-only Mode is enabled. To grant more privileges to a trusted user, you may uncheck this option.
4. Specify which MCP tools the user can access.
5. Click Create to complete key creation.
6. After the key is created, click the download arrow under Actions. 
   • The Download Key and MCP Server dialog will appear, which allows you to download the authentication key and MCP Server files to your computer.
      
      
      
7. Select your operating system:
8. • Windows – For Windows-based computers
   • macOS (M1 and above) – For Apple Silicon Macs
   • macOS (Intel) – For Intel-based Macs
   • Linux – Claude Desktop is not available for Linux; use other MCP hosts.
   • Click the button matching your OS to download the package, which includes both your user key and the MCP Server files.

1. Locate the downloaded file:
   • The filename will vary (e.g., qmcp-darwin-arm64-250630_1502.zip).
   • Check your Downloads folder or the location you selected.
2. Extract the ZIP file:
   • Windows: Right-click the ZIP file and select Extract All or use your preferred extraction tool.
   • macOS: Double-click the ZIP file to extract it automatically or use a tool like The Unarchiver.
3. Verify extraction:
   • You should see a folder containing the MCP Server executable and configuration files.
   • Note the folder path; you will need it for Claude Desktop configuration.
     Important

     Keep track of the extracted folder location for later configuration steps.

1. Visit the official Anthropic website at claude.ai.
2. Navigate to the Claude Desktop download section.
3. Download the appropriate installer for your operating system:
   • Windows: Download the .exe installer.
   • macOS: Download the .dmg installer.

1. Windows:
   • Run the downloaded .exe installer.
   • Follow the installation wizard prompts and accept the license agreement.
   • Choose the installation location and complete the process.
2. macOS:
   • Open the downloaded .dmg file.
   • Drag Claude Desktop to the Applications folder.
   • If prompted, go to System Preferences > Security & Privacy and allow the application to run.

1. Launch Claude Desktop from your desktop shortcut.
2. If this is your first time launching Claude:
   • Sign in with your Anthropic account.
   • Complete any initial setup procedures.
   • Accept terms of service if prompted.

Edit the configuration of Claude Desktop.

1. Locate the configuration file:
   • Use Claude Desktop UI: Menu (top left) > Settings > Developer > Edit Config.
   • You may also find the configuration file here:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Edit the file:

   • Open in a text editor (e.g., Notepad++, VS Code, TextEdit).

   • Add the MCP Server configuration as shown in the MCP Assistant dialog. For example:

     {
       "mcpServers": {
         "qnap-nas": {
           "command": "/path/to/qmcp-folder/qmcp"
         }
       }
     }

   • Replace /path/to/qmcp-folder/qmcp with the actual path to your extracted MCP Server executable.

   • On Windows, use double backslashes (\\) instead of single backslashes (\). For example: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Save the configuration file.

Allow execution of the MCP Server.

1. macOS users:
   • You may see a security warning when running the MCP Server executable. Click Done to close the warning.
   • Go to Apple Menu > System Settings > Privacy & Security > Security.
   • Click Allow Anyway next to the blocked qmcp executable.
   • Only allow executables from trusted sources to avoid risks.
      
      
      
2. Windows users:
   • Ensure antivirus or firewall software does not block the MCP Server executable.
   • Add exceptions if necessary.

1. To load your previous configuration, completely quit Claude Desktop and reopen it.
   1. macOS: Force Quit the app or close the app in Activity Monitor.
   2. Windows: open Task Manager, locate the app, and select End task.

      If this does not work, restart your computer.

2. Test with prompts such as:
   • Can you access my QNAP NAS?
   • Show me the status of my NAS storage.
   • List the files in my shared folders.
3. Verify Claude responds with successful interactions related to your NAS.
4. If errors appear, check the user interface for details.

1. 如果您的 NAS 运行 QTS/QuTS hero 5.2.1 或更高版本：
   1. 登录到您的 QNAP NAS。
   2. 转到App Center。
   3. 在右上角，点击  
   4. 选择加入 QNAP 应用测试计划  并点击  申请。
   5. 在搜索栏中，搜索MCP Assistant。
   6. 点击安装。
2. 如果您的 NAS 运行 QTS/QuTS hero 5.2.0：
   1. 转到应用中心网页。
   2. 搜索MCP Assistant。
   3. 从搜索结果中点击MCP Assistant。
   4. 选择您的 NAS 型号。
   5. 下载安装文件。
   6. 登录到您的 QNAP NAS。
   7. 转到 App Center。
   8. 在右上角，点击  
   9. 选择手动安装。
   10. 点击浏览并上传您刚从 QNAP 网站下载的安装文件。
   11. 点击安装。

1. 从主菜单中找到 MCP 助手。
2. 启动MCP 助手。
    

1. 在 MCP 助手中，进入凭证选项卡。
2. 点击创建以生成新密钥。
3. 为密钥输入描述性名称，选择密钥类型，并选择要与此密钥关联的用户账户。
   提示

   默认情况下，只读模式已启用。要为受信任用户授予更多权限，可以取消选中此选项。
4. 指定用户可以访问的 MCP 工具。
5. 点击创建以完成密钥创建。
6. 密钥创建后，点击操作下的下载箭头。
   • 将出现下载密钥和 MCP 服务器对话框，允许您将认证密钥和 MCP 服务器文件下载到计算机。
      
      
      
7. 选择您的操作系统：
8. • Windows – 适用于基于 Windows 的计算机
   • macOS (M1 及以上) – 适用于 Apple Silicon Mac
   • macOS (Intel) – 适用于基于 Intel 的 Mac
   • Linux – Claude 桌面不支持 Linux；请使用其他 MCP 主机。
   • 点击与您的操作系统匹配的按钮以下载包含用户密钥和 MCP 服务器文件的包。

1. 找到下载的文件：
   • 文件名会有所不同（例如，qmcp-darwin-arm64-250630_1502.zip）。
   • 检查您的下载文件夹或您选择的位置。
2. 提取 ZIP 文件：
   • Windows:右键单击 ZIP 文件并选择全部提取或使用您喜欢的解压工具。
   • macOS:双击 ZIP 文件以自动提取，或使用像 The Unarchiver 这样的工具。
3. 验证提取：
   • 您应该会看到一个包含 MCP 服务器可执行文件和配置文件的文件夹。
   • 记下文件夹路径；您将在 Claude Desktop 配置中需要它。
     重要提示

     记录提取文件夹的位置，以便后续配置步骤使用。

1. 访问官方 Anthropic 网站claude.ai。
2. 导航到 Claude Desktop 下载部分。
3. 下载适合您操作系统的安装程序：
   • Windows：下载 .exe 安装程序。
   • macOS：下载 .dmg 安装程序。

1. Windows：
   • 运行下载的 .exe 安装程序。
   • 按照安装向导提示并接受许可证协议。
   • 选择安装位置并完成安装过程。
2. macOS：
   • 打开下载的 .dmg 文件。
   • 将 Claude Desktop 拖动到应用程序文件夹。
   • 如果出现提示，请前往系统偏好设置 > 安全性与隐私并允许应用程序运行。

1. 从桌面快捷方式启动 Claude Desktop。
2. 如果这是您较高次启动 Claude：
   • 使用您的 Anthropic 账户登录。
   • 完成任何初始设置程序。
   • 如果出现提示，接受服务条款。

编辑 Claude Desktop 的配置。

1. 找到配置文件：
   • 使用 Claude Desktop UI：菜单（左上角）> 设置 > 开发者 > 编辑配置。
   • 您也可以在此处找到配置文件：
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. 编辑文件：

   • 在文本编辑器中打开（例如，Notepad++、VS Code、TextEdit）。

   • 按照 MCP Assistant 对话框中显示的方式添加 MCP 服务器配置。例如：

     {
       "mcpServers": {
         "qnap-nas": {"command": "/path/to/qmcp-folder/qmcp"}
       }
     }

   • 将 /path/to/qmcp-folder/qmcp 替换为实际的 MCP 服务器可执行文件路径。

   • 在 Windows 上，使用双反斜杠（\\）代替单反斜杠（\）。例如：C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe。

3. 保存配置文件。

允许执行 MCP 服务器。

1. macOS 用户：
   • 运行 MCP 服务器可执行文件时，您可能会看到安全警告。点击完成以关闭警告。
   • 前往Apple 菜单 > 系统设置 > 隐私与安全 > 安全性。
   • 点击仍然允许，在被阻止的 qmcp 可执行文件旁边。
   • 仅允许来自可信来源的可执行文件以避免风险。
      
      
      
2. Windows 用户：
   • 确保杀毒软件或防火墙软件不会阻止 MCP 服务器可执行文件。
   • 如有必要，添加例外。

1. 要加载以前的配置，请退出 Claude Desktop 并重新打开。
   1. macOS：强制退出应用程序或在活动监视器中关闭应用程序。
   2. Windows：打开任务管理器，找到应用程序，然后选择结束任务。

      如果这不起作用，请重启计算机。

2. 测试提示，例如：
   • 你能访问我的 QNAP NAS 吗？
   • 显示我的 NAS 存储的状态。
   • 列出我共享文件夹中的文件。
3. 验证 Claude 是否成功响应与您的 NAS 相关的交互。
4. 如果出现错误，请检查用户界面以获取详细信息。