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

如何設定 MCP Assistant 讓 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 App Beta 計畫  並點擊  申請。
   5. 在搜尋欄中，搜尋MCP Assistant。
   6. 點擊安裝。
2. 如果您的 NAS 運行 QTS/QuTS hero 5.2.0：
   1. 前往App Center 的網頁。
   2. 搜尋MCP Assistant。
   3. 從搜尋結果中點擊MCP Assistant。
   4. 選擇您的 NAS 型號。
   5. 下載安裝檔案。
   6. 登入您的 QNAP NAS。
   7. 前往 App Center。
   8. 在右上角，點選  
   9. 選擇手動安裝。
   10. 點擊瀏覽並上傳您剛從 QNAP 網站下載的安裝檔案。
   11. 按一下Install。

1. 在主選單中找到 MCP Assistant。
2. 啟動MCP Assistant。
    

1. 在 MCP Assistant 中，前往Credentials標籤。
2. 按一下Create以生成新金鑰。
3. 輸入金鑰的描述性名稱，選擇金鑰型別，並選擇要與此金鑰關聯的使用者帳戶。
   提示

   預設情況下，Read-only Mode已啟用。若要授予受信任使用者更多權限，您可以取消選中此選項。
4. 指定使用者可以存取哪些 MCP 工具。
5. 按一下Create以完成金鑰創建。
6. 金鑰創建後，按一下Actions下的下載箭頭。
   • 將出現Download Key and MCP Server對話框，允許您將驗證金鑰和 MCP Server 檔案下載到您的電腦。
      
      
      
7. 選擇您的作業系統：
8. • Windows – 適用於 Windows 系統的電腦
   • macOS (M1 and above) – 適用於 Apple Silicon Macs
   • macOS (Intel) – 適用於 Intel 系統的 Macs
   • Linux – Claude Desktop 不支援 Linux；請使用其他 MCP 主機。
   • 按一下與您的作業系統相符的按鈕以下載包含使用者金鑰和 MCP Server 檔案的套件。

1. 找到已下載的檔案：
   • 檔名會有所不同（例如：qmcp-darwin-arm64-250630_1502.zip）。
   • 檢查您的下載資料夾或您選擇的位置。
2. 解壓縮 ZIP 檔案：
   • Windows:右鍵點擊 ZIP 檔案並選擇Extract All或使用您偏好的解壓工具。
   • macOS:雙擊 ZIP 檔案以自動解壓縮或使用像 The Unarchiver 的工具。
3. 驗證解壓：
   • 您應該會看到一個包含 MCP Server 可執行檔和設定檔的資料夾。
   • 記下資料夾路徑；您將需要它來進行 Claude Desktop 設定。
     重要

     記住解壓縮資料夾的位置，以便後續設定步驟使用。

1. 造訪官方 Anthropic 網站claude.ai。
2. 瀏覽至 Claude Desktop 下載區。
3. 下載適合您作業系統的安裝程式：
   • Windows: 下載 .exe 安裝程式。
   • macOS: 下載 .dmg 安裝程式。

1. Windows：
   • 執行下載的 .exe 安裝程式。
   • 按照安裝精靈提示並接受授權協議。
   • 選擇安裝位置並完成過程。
2. macOS：
   • 開啟下載的 .dmg 檔案。
   • 將 Claude Desktop 拖到應用程式資料夾。
   • 如果出現提示，請前往System Preferences > Security & Privacy並允許應用程式運行。

1. 從桌面快捷方式啟動 Claude Desktop。
2. 如果這是您第一次啟動 Claude：
   • 使用您的 Anthropic 帳戶登入。
   • 完成任何初始設定程式。
   • 如果出現提示，接受服務條款。

編輯 Claude Desktop 的設定。

1. 找到設定檔：
   • 使用 Claude Desktop UI：Menu (top left) > Settings > Developer > Edit Config。
   • 您也可以在這裡找到設定檔：
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. 編輯檔案：

   • 在文字編輯器中開啟（例如，Notepad++、VS Code、TextEdit）。

   • 按照 MCP Assistant 對話方塊中顯示的方式新增 MCP Server 設定。例如：

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

   • 將 /path/to/qmcp-folder/qmcp 替換為您的 MCP Server 可執行檔的實際路徑。

   • 在 Windows 上，使用雙反斜線（\\）而不是單反斜線（\）。例如：C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe。

3. 儲存設定檔。

允許執行 MCP Server。

1. macOS 使用者：
   • 執行 MCP Server 可執行檔時可能會看到安全警告。按一下完成以關閉警告。
   • 前往Apple 選單 > 系統設定 > 隱私與安全 > 安全性。
   • 在被阻擋的 qmcp 可執行檔旁按一下仍然允許。
   • 僅允許來自可信來源的可執行檔以避免風險。
      
      
      
2. Windows 使用者：
   • 確保防毒或防火牆軟體不會阻擋 MCP Server 可執行檔。
   • 如有必要，新增例外。

1. 要載入您之前的設定，請完全退出 Claude Desktop 並重新開啟。
   1. macOS：強制退出應用程式或在活動監視器中關閉應用程式。
   2. Windows：開啟工作管理員，找到應用程式，然後選擇結束任務。

      如果這不起作用，請重新啟動您的電腦。

2. 使用以下提示進行測試：
   • 你能訪問我的 QNAP NAS 嗎？
   • 顯示我的 NAS 儲存空間的狀態。
   • 列出我共享資料夾中的檔案。
3. 確認 Claude 能夠成功回應與您的 NAS 相關的互動。
4. 如果出現錯誤，請檢查使用者介面以獲取詳細資訊。