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

Wie richte ich den MCP-Assistenten für Claude ein, damit er mein NAS mit natürlichen Sprachbefehlen bedienen kann?

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. Wenn Ihr NAS QTS/QuTS hero 5.2.1 oder neuere Versionen ausführt:
   1. Melden Sie sich bei Ihrem QNAP NAS an.
   2. Gehen Sie zu App Center.
   3. Klicken Sie in der oberen rechten Ecke auf  
   4. Wählen Sie Am QNAP App Beta-Programm teilnehmen  und klicken Sie auf  Anwenden.
   5. Geben Sie in der Suchleiste MCP Assistant ein.
   6. Klicken Sie auf Installieren.
2. Wenn Ihr NAS QTS/QuTS hero 5.2.0 ausführt:
   1. Gehen Sie zu die Webseite des App Centers.
   2. Suchen Sie nach MCP Assistant.
   3. Klicken Sie auf MCP Assistant aus dem Suchergebnis.
   4. Wählen Sie Ihr NAS-Modell aus.
   5. Laden Sie die Installationsdatei herunter.
   6. Melden Sie sich bei Ihrem QNAP NAS an.
   7. Gehen Sie zu App Center.
   8. Klicken Sie in der oberen rechten Ecke auf  
   9. Wählen Sie Manuell installieren.
   10. Klicken Sie auf Durchsuchen und laden Sie die Installationsdatei hoch, die Sie gerade von der QNAP-Website heruntergeladen haben.
   11. Klicken Sie auf Installieren.

1. Finden Sie den MCP-Assistenten im Hauptmenü.
2. Starten Sie MCP-Assistent.
    

1. Gehen Sie im MCP-Assistenten zum Tab Anmeldeinformationen.
2. Klicken Sie auf Erstellen, um einen neuen Schlüssel zu generieren.
3. Geben Sie einen beschreibenden Namen für den Schlüssel ein, wählen Sie den Schlüsseltyp und das Benutzerkonto, das mit diesem Schlüssel verknüpft werden soll.
   Tipp

   Standardmäßig ist der Nur-Lese-Modus aktiviert. Um einem vertrauenswürdigen Benutzer mehr Berechtigungen zu gewähren, können Sie diese Option deaktivieren.
4. Geben Sie an, auf welche MCP-Tools der Benutzer zugreifen kann.
5. Klicken Sie auf Erstellen, um die Schlüsselerstellung abzuschließen.
6. Nachdem der Schlüssel erstellt wurde, klicken Sie auf den Download-Pfeil unter Aktionen. 
   • Der Dialog zum Herunterladen von Schlüssel und MCP-Server erscheint, der es Ihnen ermöglicht, den Authentifizierungsschlüssel und die MCP-Server-Dateien auf Ihren Computer herunterzuladen.
      
      
      
7. Wählen Sie Ihr Betriebssystem:
8. • Windows – Für Windows-basierte Computer
   • macOS (M1 und höher) – Für Apple Silicon Macs
   • macOS (Intel) – Für Intel-basierte Macs
   • Linux – Claude Desktop ist nicht für Linux verfügbar; verwenden Sie andere MCP-Hosts.
   • Klicken Sie auf die Schaltfläche, die Ihrem Betriebssystem entspricht, um das Paket herunterzuladen, das sowohl Ihren Benutzerschlüssel als auch die MCP-Server-Dateien enthält.

1. Finden Sie die heruntergeladene Datei:
   • Der Dateiname variiert (z.B. qmcp-darwin-arm64-250630_1502.zip).
   • Überprüfen Sie Ihren Downloads-Ordner oder den von Ihnen gewählten Speicherort.
2. Extrahieren Sie die ZIP-Datei:
   • Windows: Klicken Sie mit der rechten Maustaste auf die ZIP-Datei und wählen Sie Alle extrahieren oder verwenden Sie Ihr bevorzugtes Extraktionstool.
   • macOS: Doppelklicken Sie auf die ZIP-Datei, um sie automatisch zu extrahieren, oder verwenden Sie ein Tool wie The Unarchiver.
3. Extraktion überprüfen:
   • Sie sollten einen Ordner sehen, der die MCP Server ausführbare Datei und Konfigurationsdateien enthält.
   • Notieren Sie sich den Ordnerpfad; Sie benötigen ihn für die Claude Desktop-Konfiguration.
     Wichtig

     Behalten Sie den Speicherort des extrahierten Ordners für spätere Konfigurationsschritte im Auge.

1. Besuchen Sie die offizielle Anthropic-Website unter claude.ai.
2. Navigieren Sie zum Claude Desktop-Downloadbereich.
3. Laden Sie das passende Installationsprogramm für Ihr Betriebssystem herunter:
   • Windows: Laden Sie das .exe-Installationsprogramm herunter.
   • macOS: Laden Sie das .dmg-Installationsprogramm herunter.

1. Windows:
   • Führen Sie das heruntergeladene .exe-Installationsprogramm aus.
   • Folgen Sie den Anweisungen des Installationsassistenten und akzeptieren Sie die Lizenz-Vereinbarung.
   • Wählen Sie den Installationsort und schließen Sie den Vorgang ab.
2. macOS:
   • Öffnen Sie die heruntergeladene .dmg-Datei.
   • Ziehen Sie Claude Desktop in den Ordner Anwendungen.
   • Falls erforderlich, gehen Sie zu Systemeinstellungen > Sicherheit & Datenschutz und erlauben Sie die Ausführung der Anwendung.

1. Starten Sie Claude Desktop über Ihr Desktop-Shortcut.
2. Wenn Sie Claude zum ersten Mal starten:
   • Melden Sie sich mit Ihrem Anthropic-Konto an.
   • Führen Sie alle anfänglichen Einrichtungsverfahren durch.
   • Akzeptieren Sie Nutzungsbedingungen, falls erforderlich.

Bearbeiten Sie die Konfiguration von Claude Desktop.

1. Finden Sie die Konfigurationsdatei:
   • Verwenden Sie die Claude Desktop-Benutzeroberfläche: Menü (oben links) > Einstellungen > Entwickler > Konfiguration bearbeiten.
   • Sie können die Konfigurationsdatei auch hier finden:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Bearbeiten Sie die Datei:

   • Öffnen Sie sie in einem Texteditor (z.B. Notepad++, VS Code, TextEdit).

   • Fügen Sie die MCP-Server-Konfiguration wie im MCP-Assistenten-Dialog gezeigt hinzu. Zum Beispiel:

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

   • Ersetzen Sie  /path/to/qmcp-folder/qmcp  durch den tatsächlichen Pfad zu Ihrer extrahierten MCP-Server-Ausführungsdatei.

   • Unter Windows verwenden Sie doppelte Backslashes (\\) anstelle von einfachen Backslashes (\). Zum Beispiel: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Speichern Sie die Konfigurationsdatei.

Erlauben Sie die Ausführung des MCP-Servers.

1. macOS-Benutzer:
   • Sie könnten eine Sicherheitswarnung sehen, wenn Sie die MCP-Server-Ausführungsdatei ausführen. Klicken Sie auf Fertig, um die Warnung zu schließen.
   • Gehen Sie zu Apple Menü > Systemeinstellungen > Datenschutz & Sicherheit > Sicherheit.
   • Klicken Sie auf Trotzdem erlauben neben der blockierten qmcp-Ausführungsdatei.
   • Erlauben Sie nur Ausführungsdateien aus vertrauenswürdigen Quellen, um Risiken zu vermeiden.
      
      
      
2. Windows-Benutzer:
   • Stellen Sie sicher, dass Antivirus- oder Firewall-Software die MCP-Server-Ausführungsdatei nicht blockiert.
   • Fügen Sie bei Bedarf Ausnahmen hinzu.

1. Um Ihre vorherige Konfiguration zu laden, beenden Sie Claude Desktop vollständig und öffnen Sie es erneut.
   1. macOS: Beenden Sie die App erzwingen oder schließen Sie die App im Aktivitätsmonitor.
   2. Windows: Öffnen Sie den Task-Manager, suchen Sie die App und wählen Sie Task beenden.

      Wenn dies nicht funktioniert, starten Sie Ihren Computer neu.

2. Testen Sie mit Eingabeaufforderungen wie:
   • Können Sie auf mein QNAP NAS zugreifen?
   • Zeigen Sie mir den Status meines NAS Speicher.
   • Listen Sie die Dateien in meinen freigegebenen Ordnern auf.
3. Überprüfen Sie, ob Claude mit erfolgreichen Interaktionen in Bezug auf Ihr NAS antwortet.
4. Wenn Fehler auftreten, überprüfen Sie die Benutzeroberfläche auf Details.