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

Come configurare MCP Assistant per consentire a Claude di operare il mio NAS con comandi in linguaggio naturale?

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. Se il tuo NAS esegue QTS/QuTS hero 5.2.1 o versioni successive:
   1. Accedi al tuo NAS QNAP.
   2. Vai a App Center.
   3. Nell'angolo in alto a destra, fai clic su  
   4. Seleziona Unisciti al Programma Beta delle App QNAP  e fai clic su  Applica.
   5. Nella barra di ricerca, cerca MCP Assistant.
   6. Fai clic su Installa.
2. Se il tuo NAS esegue QTS/QuTS hero 5.2.0:
   1. Vai a la pagina web di App Center.
   2. Cerca MCP Assistant.
   3. Fai clic su MCP Assistant dai risultati della ricerca.
   4. Seleziona il modello del tuo NAS.
   5. Scarica il file di installazione.
   6. Accedi al tuo NAS QNAP.
   7. Vai a App Center.
   8. Nell'angolo in alto a destra, fai clic su  
   9. Seleziona Installa manualmente.
   10. Fai clic su Sfoglia e carica il file di installazione che hai appena scaricato dal sito web di QNAP.
   11. Fare clic su Installa.

1. Individua MCP Assistant dal menu principale.
2. Avvia MCP Assistant.
    

1. In MCP Assistant, vai alla scheda Credenziali.
2. Fare clic su Crea per generare una nuova chiave.
3. Inserisci un nome descrittivo per la chiave, seleziona il tipo di chiave e scegli l'account utente da associare a questa chiave.
   Suggerimento

   Per impostazione predefinita, Modalità sola lettura è abilitata. Per concedere più privilegi a un utente fidato, puoi deselezionare questa opzione.
4. Specifica quali strumenti MCP l'utente può accedere.
5. Fare clic su Crea per completare la creazione della chiave.
6. Dopo che la chiave è stata creata, fai clic sulla freccia di download sotto Azioni. 
   • Il dialogo Scarica Chiave e MCP Server apparirà, permettendoti di scaricare la chiave di autenticazione e i file del MCP Server sul tuo computer.
      
      
      
7. Seleziona il tuo sistema operativo:
8. • Windows – Per computer basati su Windows
   • macOS (M1 e superiori) – Per Apple Silicon Macs
   • macOS (Intel) – Per Mac basati su Intel
   • Linux – Claude Desktop non è disponibile per Linux; usa altri host MCP.
   • Fare clic sul pulsante corrispondente al tuo sistema operativo per scaricare il pacchetto, che include sia la tua chiave utente che i file del MCP Server.

1. Individua il file scaricato:
   • Il nome del file varierà (ad es., qmcp-darwin-arm64-250630_1502.zip).
   • Controlla la cartella Download o la posizione che hai selezionato.
2. Estrai il file ZIP:
   • Windows: Fai clic con il tasto destro sul file ZIP e seleziona Estrai tutto o utilizza il tuo strumento di estrazione preferito.
   • macOS: Fai doppio clic sul file ZIP per estrarlo automaticamente o utilizza uno strumento come The Unarchiver.
3. Verifica l'estrazione:
   • Dovresti vedere una cartella contenente l'eseguibile del server MCP e i file di configurazione.
   • Nota il percorso della cartella; ti servirà per la configurazione di Claude Desktop.
     Importante

     Tieni traccia della posizione della cartella estratta per i passaggi di configurazione successivi.

1. Visita il sito ufficiale di Anthropic su claude.ai.
2. Vai alla sezione di download di Claude Desktop.
3. Scarica l'installer appropriato per il tuo sistema operativo:
   • Windows: Scarica l'installer .exe.
   • macOS: Scarica l'installer .dmg.

1. Windows:
   • Esegui l'installer .exe scaricato.
   • Segui le istruzioni della procedura guidata di installazione e accetta l'accordo Licenza.
   • Scegli la posizione di installazione e completa il processo.
2. macOS:
   • Apri il file .dmg scaricato.
   • Trascina Claude Desktop nella cartella Applicazioni.
   • Se richiesto, vai a Preferenze di Sistema > Sicurezza e Privacy e consenti l'esecuzione dell'applicazione.

1. Avvia Claude Desktop dal collegamento sul desktop.
2. Se è la prima volta che avvii Claude:
   • Accedi con il tuo account Anthropic.
   • Completa eventuali procedure di configurazione iniziale.
   • Accetta Condizioni di servizio se richiesto.

Modifica la configurazione di Claude Desktop.

1. Individua il file di configurazione:
   • Usa l'interfaccia utente di Claude Desktop: Menu (in alto a sinistra) > Impostazioni > Sviluppatore > Modifica Config.
   • Puoi anche trovare il file di configurazione qui:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Modifica il file:

   • Apri in un editor di testo (ad esempio, Notepad++, VS Code, TextEdit).

   • Aggiungi la configurazione del server MCP come mostrato nella finestra di dialogo dell'Assistente MCP. Ad esempio:

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

   • Sostituisci  /path/to/qmcp-folder/qmcp  con il percorso effettivo del tuo eseguibile del server MCP estratto.

   • Su Windows, usa doppie barre rovesciate (\\) invece di singole barre rovesciate (\). Ad esempio: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Salva il file di configurazione.

Consenti l'esecuzione del server MCP.

1. Utenti macOS:
   • Potresti vedere un avviso di sicurezza quando esegui l'eseguibile del server MCP. Fai clic su Fatto per chiudere l'avviso.
   • Vai a Apple Menu > Impostazioni di sistema > Privacy e sicurezza > Sicurezza.
   • Fai clic su Consenti comunque accanto all'eseguibile qmcp bloccato.
   • Consenti solo eseguibili da fonti attendibili per evitare rischi.
      
      
      
2. Utenti Windows:
   • Assicurati che l'antivirus o il software Firewall non blocchi l'eseguibile del server MCP.
   • Aggiungi eccezioni se necessario.

1. Per caricare la tua configurazione precedente, chiudi completamente Claude Desktop e riaprilo.
   1. macOS: Forza l'uscita dall'app o chiudi l'app in Monitoraggio Attività.
   2. Windows: apri Gestione attività, individua l'app e seleziona Termina attività.

      Se questo non funziona, riavvia il computer.

2. Testa con prompt come:
   • Puoi accedere al mio QNAP NAS?
   • Mostrami lo stato del mio NAS Archiviazione.
   • Elenca i file nelle mie cartelle condivise.
3. Verifica che Claude risponda con interazioni di successo relative al tuo NAS.
4. Se compaiono errori, controlla l'interfaccia utente per i dettagli.