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

Jak skonfigurować MCP Assistant dla Claude, aby obsługiwał mój NAS za pomocą poleceń w języku naturalnym?

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. Jeśli Twój NAS działa na QTS/QuTS hero 5.2.1 lub nowszych wersjach:
   1. Zaloguj się na swój serwer QNAP NAS.
   2. Przejdź do App Center.
   3. W prawym górnym rogu kliknij  
   4. Wybierz Dołącz do programu beta aplikacji QNAP  i kliknij  Zastosuj.
   5. W pasku wyszukiwania, wyszukaj MCP Assistant.
   6. Kliknij Zainstaluj.
2. Jeśli Twój NAS działa na QTS/QuTS hero 5.2.0:
   1. Przejdź do strona internetowa App Center.
   2. Wyszukaj MCP Assistant.
   3. Kliknij MCP Assistant z wyników wyszukiwania.
   4. Wybierz model swojego NAS.
   5. Pobierz plik instalacyjny.
   6. Zaloguj się na swój serwer QNAP NAS.
   7. Przejdź do App Center.
   8. W prawym górnym rogu kliknij  
   9. Wybierz Zainstaluj ręcznie.
   10. Kliknij Przeglądaj i prześlij plik instalacyjny, który właśnie pobrałeś z witryny QNAP.
   11. Kliknij Instaluj.

1. Zlokalizuj MCP Assistant w menu głównym.
2. Uruchom MCP Assistant.
    

1. W MCP Assistant przejdź do zakładki Credentials.
2. Kliknij Utwórz, aby wygenerować nowy klucz.
3. Wprowadź opisową nazwę dla klucza, wybierz typ klucza i wybierz konto użytkownika, z którym chcesz powiązać ten klucz.
   Wskazówka

   Domyślnie Tryb tylko do odczytu jest włączony. Aby przyznać więcej uprawnień zaufanemu użytkownikowi, możesz odznaczyć tę opcję.
4. Określ, do których narzędzi MCP użytkownik ma dostęp.
5. Kliknij Utwórz, aby zakończyć tworzenie klucza.
6. Po utworzeniu klucza kliknij strzałkę pobierania pod Akcje. 
   • Pojawi się okno dialogowe Pobierz klucz i MCP Server, które pozwala pobrać klucz uwierzytelniający i pliki MCP Server na komputer.
      
      
      
7. Wybierz swój system operacyjny:
8. • Windows – Dla komputerów z systemem Windows
   • macOS (M1 i nowsze) – Dla Apple Silicon Macs
   • macOS (Intel) – Dla komputerów Mac z procesorem Intel
   • Linux – Claude Desktop nie jest dostępny dla Linux; użyj innych hostów MCP.
   • Kliknij przycisk odpowiadający Twojemu systemowi operacyjnemu, aby pobrać pakiet, który zawiera zarówno klucz użytkownika, jak i pliki MCP Server.

1. Zlokalizuj pobrany plik:
   • Nazwa pliku będzie się różnić (np. qmcp-darwin-arm64-250630_1502.zip).
   • Sprawdź folder Pobrane lub lokalizację, którą wybrałeś.
2. Wyodrębnij plik ZIP:
   • Windows: Kliknij prawym przyciskiem myszy na plik ZIP i wybierz Wyodrębnij wszystko lub użyj preferowanego narzędzia do wyodrębniania.
   • macOS: Kliknij dwukrotnie na plik ZIP, aby automatycznie go wyodrębnić lub użyj narzędzia takiego jak The Unarchiver.
3. Zweryfikuj wyodrębnienie:
   • Powinieneś zobaczyć folder zawierający plik wykonywalny MCP Server oraz pliki konfiguracyjne.
   • Zanotuj ścieżkę do folderu; będzie potrzebna do konfiguracji Claude Desktop.
     Ważne

     Śledź lokalizację wyodrębnionego folderu na potrzeby późniejszych kroków konfiguracji.

1. Odwiedź oficjalną stronę Anthropic pod adresem claude.ai.
2. Przejdź do sekcji pobierania Claude Desktop.
3. Pobierz odpowiedni instalator dla swojego systemu operacyjnego:
   • Windows: Pobierz instalator .exe.
   • macOS: Pobierz instalator .dmg.

1. Windows:
   • Uruchom pobrany instalator .exe.
   • Postępuj zgodnie z instrukcjami kreatora instalacji i zaakceptuj Licencja umowę.
   • Wybierz lokalizację instalacji i zakończ proces.
2. macOS:
   • Otwórz pobrany plik .dmg.
   • Przeciągnij Claude Desktop do folderu Aplikacje.
   • Jeśli pojawi się komunikat, przejdź do Preferencje systemowe > Bezpieczeństwo i prywatność i zezwól na uruchomienie aplikacji.

1. Uruchom Claude Desktop z skrótu na pulpicie.
2. Jeśli uruchamiasz Claude po raz pierwszy:
   • Zaloguj się na swoje konto Anthropic.
   • Ukończ wszelkie początkowe procedury konfiguracji.
   • Zaakceptuj Warunki usługi jeśli pojawi się komunikat.

Edytuj konfigurację Claude Desktop.

1. Zlokalizuj plik konfiguracyjny:
   • Użyj interfejsu Claude Desktop: Menu (lewy górny róg) > Ustawienia > Developer > Edytuj konfigurację.
   • Możesz również znaleźć plik konfiguracyjny tutaj:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Edytuj plik:

   • Otwórz w edytorze tekstu (np. Notepad++, VS Code, TextEdit).

   • Dodaj konfigurację serwera MCP, jak pokazano w oknie dialogowym MCP Assistant. Na przykład:

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

   • Zastąp  /path/to/qmcp-folder/qmcp  rzeczywistą ścieżką do wyodrębnionego pliku wykonywalnego serwera MCP.

   • Na Windows użyj podwójnych ukośników (\\) zamiast pojedynczych ukośników (\). Na przykład: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Zapisz plik konfiguracyjny.

Zezwól na wykonanie serwera MCP.

1. Użytkownicy macOS:
   • Możesz zobaczyć ostrzeżenie o bezpieczeństwie podczas uruchamiania pliku wykonywalnego serwera MCP. Kliknij Gotowe, aby zamknąć ostrzeżenie.
   • Przejdź do Apple Menu > Ustawienia systemowe > Prywatność i bezpieczeństwo > Bezpieczeństwo.
   • Kliknij Zezwól mimo to obok zablokowanego pliku wykonywalnego qmcp.
   • Zezwalaj tylko na pliki wykonywalne z zaufanych źródeł, aby uniknąć ryzyka.
      
      
      
2. Użytkownicy Windows:
   • Upewnij się, że oprogramowanie antywirusowe lub Zapora nie blokuje pliku wykonywalnego serwera MCP.
   • Dodaj wyjątki, jeśli to konieczne.

1. Aby załadować poprzednią konfigurację, całkowicie zamknij Claude Desktop i otwórz go ponownie.
   1. macOS: Wymuś zamknięcie aplikacji lub zamknij ją w Monitorze aktywności.
   2. Windows: otwórz Menedżer zadań, znajdź aplikację i wybierz Zakończ zadanie.

      Jeśli to nie zadziała, zrestartuj komputer.

2. Testuj za pomocą takich poleceń jak:
   • Czy możesz uzyskać dostęp do mojego QNAP NAS?
   • Pokaż mi status mojego NAS Pamięć masowa.
   • Wymień pliki w moich folderach udostępnionych.
3. Sprawdź, czy Claude odpowiada na interakcje związane z Twoim NAS.
4. Jeśli pojawią się błędy, sprawdź interfejs użytkownika, aby uzyskać szczegóły.