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

Comment configurer l'assistant MCP pour que Claude puisse faire fonctionner mon NAS avec des commandes en langage naturel ?

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. Si votre NAS fonctionne sous QTS/QuTS hero 5.2.1 ou versions ultérieures :
   1. Connectez-vous à votre NAS QNAP.
   2. Allez dans le App Center.
   3. Dans le coin supérieur droit, cliquez sur  
   4. Sélectionnez Rejoindre le programme bêta des applications QNAP  et cliquez sur  Appliquer.
   5. Dans la barre de recherche, recherchez MCP Assistant.
   6. Cliquez sur Installer.
2. Si votre NAS fonctionne sous QTS/QuTS hero 5.2.0 :
   1. Allez à la page web de l'App Center.
   2. Recherchez MCP Assistant.
   3. Cliquez sur MCP Assistant dans le résultat de la recherche.
   4. Sélectionnez votre modèle de NAS.
   5. Téléchargez le fichier d'installation.
   6. Connectez-vous à votre NAS QNAP.
   7. Allez à App Center.
   8. Dans le coin supérieur droit, cliquez sur  
   9. Sélectionnez Installer manuellement.
   10. Cliquez sur Parcourir et téléchargez le fichier d'installation que vous venez de télécharger depuis le site Web de QNAP.
   11. Cliquez sur Installer.

1. Trouvez l'Assistant MCP dans le menu principal.
2. Lancez l'Assistant MCP.
    

1. Dans l'Assistant MCP, allez à l'onglet Identifiants.
2. Cliquez sur Créer pour générer une nouvelle clé.
3. Entrez un nom descriptif pour la clé, sélectionnez le type de clé et choisissez le compte utilisateur à associer à cette clé.
   Conseil

   Par défaut, le Mode lecture seule est activé. Pour accorder plus de privilèges à un utilisateur de confiance, vous pouvez décocher cette option.
4. Spécifiez quels outils MCP l'utilisateur peut accéder.
5. Cliquez sur Créer pour terminer la création de la clé.
6. Après la création de la clé, cliquez sur la flèche de téléchargement sous Actions. 
   • Le dialogue Télécharger la clé et le serveur MCP apparaîtra, vous permettant de télécharger la clé d'authentification et les fichiers du serveur MCP sur votre ordinateur.
      
      
      
7. Sélectionnez votre système d'exploitation :
8. • Windows – Pour les ordinateurs sous Windows
   • macOS (M1 et supérieur) – Pour les Macs Apple Silicon
   • macOS (Intel) – Pour les Macs basés sur Intel
   • Linux – Claude Desktop n'est pas disponible pour Linux ; utilisez d'autres hôtes MCP.
   • Cliquez sur le bouton correspondant à votre OS pour télécharger le package, qui inclut à la fois votre clé utilisateur et les fichiers du serveur MCP.

1. Trouvez le fichier téléchargé :
   • Le nom du fichier variera (par exemple, qmcp-darwin-arm64-250630_1502.zip).
   • Vérifiez votre dossier Téléchargements ou l'emplacement que vous avez sélectionné.
2. Extraire le fichier ZIP :
   • Windows : Faites un clic droit sur le fichier ZIP et sélectionnez Extraire tout ou utilisez votre outil d'extraction préféré.
   • macOS : Double-cliquez sur le fichier ZIP pour l'extraire automatiquement ou utilisez un outil comme The Unarchiver.
3. Vérifier l'extraction :
   • Vous devriez voir un dossier contenant l'exécutable du serveur MCP et les fichiers de configuration.
   • Notez le chemin du dossier ; vous en aurez besoin pour la configuration de Claude Desktop.
     Important

     Gardez une trace de l'emplacement du dossier extrait pour les étapes de configuration ultérieures.

1. Visitez le site officiel d'Anthropic à claude.ai.
2. Accédez à la section de téléchargement de Claude Desktop.
3. Téléchargez l'installateur approprié pour votre système d'exploitation :
   • Windows : Téléchargez l'installateur .exe.
   • macOS : Téléchargez l'installateur .dmg.

1. Windows :
   • Exécutez l'installateur .exe téléchargé.
   • Suivez les instructions de l'assistant d'installation et acceptez l'accord Licence.
   • Choisissez l'emplacement d'installation et terminez le processus.
2. macOS :
   • Ouvrez le fichier .dmg téléchargé.
   • Faites glisser Claude Desktop dans le dossier Applications.
   • Si vous y êtes invité, allez dans Préférences Système > Sécurité et confidentialité et autorisez l'application à s'exécuter.

1. Lancez Claude Desktop depuis votre raccourci sur le bureau.
2. Si c'est la première fois que vous lancez Claude :
   • Connectez-vous avec votre compte Anthropic.
   • Complétez toutes les procédures de configuration initiales.
   • Acceptez Conditions d'utilisation si vous y êtes invité.

Modifiez la configuration de Claude Desktop.

1. Localisez le fichier de configuration :
   • Utilisez l'interface utilisateur de Claude Desktop : Menu (en haut à gauche) > Paramètres > Développeur > Modifier la configuration.
   • Vous pouvez également trouver le fichier de configuration ici :
     • Windows : %APPDATA%\Claude\claude_desktop_config.json
     • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Éditez le fichier :

   • Ouvrez dans un éditeur de texte (par exemple, Notepad++, VS Code, TextEdit).

   • Ajoutez la configuration du serveur MCP comme indiqué dans la boîte de dialogue de l'assistant MCP. Par exemple :

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

   • Remplacez  /path/to/qmcp-folder/qmcp  par le chemin réel vers votre exécutable du serveur MCP extrait.

   • Sur Windows, utilisez des doubles barres obliques inverses (\\) au lieu de simples barres obliques inverses (\). Par exemple : C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Enregistrez le fichier de configuration.

Autorisez l'exécution du serveur MCP.

1. Utilisateurs de macOS :
   • Vous pouvez voir un avertissement de sécurité lors de l'exécution de l'exécutable du serveur MCP. Cliquez sur Terminé pour fermer l'avertissement.
   • Allez dans Apple Menu > Réglages Système > Confidentialité & Sécurité > Sécurité.
   • Cliquez sur Autoriser quand même à côté de l'exécutable qmcp bloqué.
   • N'autorisez que les exécutables provenant de sources fiables pour éviter les risques.
      
      
      
2. Utilisateurs de Windows :
   • Assurez-vous que l'antivirus ou le logiciel Pare-feu ne bloque pas l'exécutable du serveur MCP.
   • Ajoutez des exceptions si nécessaire.

1. Pour charger votre configuration précédente, quittez complètement Claude Desktop et rouvrez-le.
   1. macOS : Forcer la fermeture de l'application ou fermer l'application dans le Moniteur d'activité.
   2. Windows : ouvrez le Gestionnaire des tâches, localisez l'application et sélectionnez Fin de tâche.

      Si cela ne fonctionne pas, redémarrez votre ordinateur.

2. Testez avec des invites telles que :
   • Pouvez-vous accéder à mon NAS QNAP ?
   • Montrez-moi l'état de mon NAS Stockage.
   • Listez les fichiers dans mes dossiers partagés.
3. Vérifiez que Claude répond avec des interactions réussies liées à votre NAS.
4. Si des erreurs apparaissent, vérifiez l'interface utilisateur pour plus de détails.