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

Jak nastavit MCP Assistant pro Claude, aby mohl ovládat můj NAS pomocí příkazů v přirozeném jazyce?

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. Pokud váš NAS běží na QTS/QuTS hero 5.2.1 nebo novějších verzích:
   1. Přihlaste se do QNAP NAS.
   2. Přejděte na App Center.
   3. V pravém horním rohu klikněte na  
   4. Vyberte Připojit se k beta programu aplikací QNAP  a klikněte na  Použít.
   5. V vyhledávacím poli vyhledejte MCP Assistant.
   6. Klikněte na Instalovat.
2. Pokud váš NAS běží na QTS/QuTS hero 5.2.0:
   1. Přejděte na webová stránka App Center.
   2. Vyhledejte MCP Assistant.
   3. Klikněte na MCP Assistant z výsledků vyhledávání.
   4. Vyberte model vašeho NAS.
   5. Stáhněte instalační soubor.
   6. Přihlaste se do QNAP NAS.
   7. Přejděte na App Center.
   8. V pravém horním rohu klikněte na  
   9. Vyberte Instalovat ručně.
   10. Klikněte na Procházet a nahrajte instalační soubor, který jste právě stáhli z webu QNAP.
   11. Klikněte na Instalovat.

1. Najděte MCP Assistant v hlavní nabídce.
2. Spusťte MCP Assistant.
    

1. V MCP Assistant přejděte na kartu Přihlašovací údaje.
2. Klikněte na Vytvořit pro generování nového klíče.
3. Zadejte popisný název pro klíč, vyberte typ klíče a zvolte uživatelský účet, se kterým bude klíč spojen.
   Tip

   Ve výchozím nastavení je povolen Režim pouze pro čtení. Chcete-li důvěryhodnému uživateli poskytnout více oprávnění, můžete tuto možnost zrušit.
4. Určete, ke kterým MCP nástrojům má uživatel přístup.
5. Klikněte na Vytvořit pro dokončení vytvoření klíče.
6. Po vytvoření klíče klikněte na šipku stahování pod Akce. 
   • Zobrazí se dialog Stáhnout klíč a MCP Server, který vám umožní stáhnout autentizační klíč a soubory MCP Serveru do vašeho počítače.
      
      
      
7. Vyberte svůj operační systém:
8. • Windows – Pro počítače s Windows
   • macOS (M1 a vyšší) – Pro Apple Silicon Macy
   • macOS (Intel) – Pro Macy s procesorem Intel
   • Linux – Claude Desktop není dostupný pro Linux; použijte jiné MCP hostitele.
   • Klikněte na tlačítko odpovídající vašemu OS pro stažení balíčku, který obsahuje jak váš uživatelský klíč, tak soubory MCP Serveru.

1. Najděte stažený soubor:
   • Název souboru se bude lišit (např. qmcp-darwin-arm64-250630_1502.zip).
   • Zkontrolujte složku Stažené soubory nebo místo, které jste vybrali.
2. Extrahujte soubor ZIP:
   • Windows: Klikněte pravým tlačítkem na soubor ZIP a vyberte Extrahovat vše nebo použijte svůj oblíbený nástroj pro extrakci.
   • macOS: Dvojklikem na soubor ZIP jej automaticky extrahujte nebo použijte nástroj jako The Unarchiver.
3. Ověřte extrakci:
   • Měli byste vidět složku obsahující spustitelný soubor MCP Server a konfigurační soubory.
   • Poznámka k cestě ke složce; budete ji potřebovat pro konfiguraci Claude Desktop.
     Důležité

     Sledujte umístění extrahované složky pro pozdější konfigurační kroky.

1. Navštivte oficiální web Anthropic na claude.ai.
2. Přejděte do sekce stahování Claude Desktop.
3. Stáhněte si příslušný instalační program pro váš operační systém:
   • Windows: Stáhněte si instalační program .exe.
   • macOS: Stáhněte si instalační program .dmg.

1. Windows:
   • Spusťte stažený instalační program .exe.
   • Postupujte podle pokynů průvodce instalací a přijměte Licence dohodu.
   • Vyberte umístění instalace a dokončete proces.
2. macOS:
   • Otevřete stažený soubor .dmg.
   • Přetáhněte Claude Desktop do složky Aplikace.
   • Pokud budete vyzváni, přejděte na Předvolby systému > Zabezpečení a soukromí a povolte spuštění aplikace.

1. Spusťte Claude Desktop z vaší zástupce na ploše.
2. Pokud spouštíte Claude poprvé:
   • Přihlaste se pomocí svého účtu Anthropic.
   • Dokončete všechny počáteční nastavení.
   • Přijměte Podmínky služby, pokud budete vyzváni.

Upravte konfiguraci Claude Desktop.

1. Najděte konfigurační soubor:
   • Použijte UI Claude Desktop: Menu (vlevo nahoře) > Nastavení > Vývojář > Upravit konfiguraci.
   • Konfigurační soubor můžete také najít zde:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Upravte soubor:

   • Otevřete v textovém editoru (např. Notepad++, VS Code, TextEdit).

   • Přidejte konfiguraci MCP Serveru, jak je uvedeno v dialogu MCP Assistant. Například:

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

   • Nahraďte  /path/to/qmcp-folder/qmcp  skutečnou cestou k vašemu extrahovanému spustitelnému souboru MCP Serveru.

   • Na Windows použijte dvojité zpětné lomítko (\\) místo jednoduchého zpětného lomítka (\). Například: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Uložte konfigurační soubor.

Povolte spuštění MCP Serveru.

1. Uživatelé macOS:
   • Při spuštění spustitelného souboru MCP Serveru se může zobrazit bezpečnostní varování. Klikněte na Hotovo pro zavření varování.
   • Přejděte na Apple Menu > Nastavení systému > Soukromí a bezpečnost > Zabezpečení.
   • Klikněte na Povolit přesto vedle blokovaného spustitelného souboru qmcp.
   • Povolte pouze spustitelné soubory z důvěryhodných zdrojů, abyste se vyhnuli rizikům.
      
      
      
2. Uživatelé Windows:
   • Ujistěte se, že antivirus nebo Brána firewall software neblokuje spustitelný soubor MCP Serveru.
   • Přidejte výjimky, pokud je to nutné.

1. Chcete-li načíst předchozí konfiguraci, úplně ukončete Claude Desktop a znovu jej otevřete.
   1. macOS: Vynutit ukončení aplikace nebo zavřít aplikaci v Monitoru aktivity.
   2. Windows: otevřete Správce úloh, najděte aplikaci a vyberte Ukončit úlohu.

      Pokud to nefunguje, restartujte počítač.

2. Otestujte s výzvami, jako jsou:
   • Můžete se připojit k mému QNAP NAS?
   • Ukažte mi stav mého NAS Úložiště.
   • Vyjmenujte soubory v mých sdílených složkách.
3. Ověřte, že Claude reaguje úspěšnými interakcemi souvisejícími s vaším NAS.
4. Pokud se objeví chyby, zkontrolujte podrobnosti v uživatelském rozhraní.