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

ważne
W odpowiedzi na ostatnie aktualizacje Claude Desktop znacznie upraszczamy obecny proces instalacji MCP, aby poprawić komfort korzystania z aplikacji. Wkrótce będzie można ukończyć konfigurację MCP w zaledwie kilku kliknięciach. Planujemy dodać to usprawnienie w kolejnym wydaniu MCP Assistant. Śledź nasze aktualizacje.


Wprowadzenie​


Ten samouczek przeprowadzi Cię przez proces konfigurowania aplikacji QNAP MCP Assistant do współpracy z Claude Desktop, umożliwiając bezproblemową integrację między urządzeniem QNAP NAS a możliwościami sztucznej inteligencji Claude. Następnie możesz używać poleceń w języku naturalnym do obsługi NAS.


Wymagania wstępne​


Przed rozpoczęciem upewnij się, że masz następującą konfigurację:

  • Urządzenie QNAP NAS z systemem QTS 5.2, QuTS hero h5.2 lub nowszą wersją
  • Komputer z dostępem do Internetu (Windows lub macOS; Claude Desktop nie jest dostępny dla systemu Linux)
  • Dostęp administratora do urządzenia QNAP NAS
  • Domyślne porty MCP Assistant: 8442 i 8443


Procedura​


  1. Zainstaluj MCP Assistant (beta) z App Center.
    1. Jeśli NAS działa pod kontrolą systemu QTS/QuTS hero 5.2.1 lub nowszej wersji:
      1. Zaloguj się do urządzenia QNAP NAS.
      2. Przejdź do App Center.
      3. W prawym górnym rogu kliknij
        031a191beb05b98ca1bb5766ff8b162a.png
      4. Wybierz Join the QNAP App Beta Program i kliknij Apply.
      5. Na pasku wyszukiwania wyszukaj MCP Assistant.
      6. Kliknij Instaluj.
    2. Jeśli NAS działa pod kontrolą systemu QTS/QuTS hero 5.2.0:
      1. Przejdź do strony internetowej App Center.
      2. Wyszukaj MCP Assistant.
      3. Kliknij MCP Assistant w wynikach wyszukiwania.
      4. Wybierz model swojego urządzenia NAS.
      5. Pobierz plik instalacyjny.
      6. Zaloguj się do urządzenia QNAP NAS.
      7. Przejdź do App Center.
      8. W prawym górnym rogu kliknij
        ffe6e5a03ad3850f4e652f6ee342b862.png
      9. Wybierz Instaluj ręcznie.
      10. Kliknij Przeglądaj i prześlij plik instalacyjny pobrany ze strony QNAP.
      11. Kliknij Instaluj.
  2. Otwórz MCP Assistant.
    1. Znajdź MCP Assistant w Menu głównym.
    2. Uruchom MCP Assistant.

      236db03cbac2abe81acf63787a22ee19.png
  3. Utwórz poświadczenia i pobierz MCP Server.
    1. W MCP Assistant przejdź do zakładki Poświadczenia.
    2. Kliknij Utwórz, aby wygenerować nowy klucz.
    3. Wprowadź opisową nazwę klucza, wybierz typ klucza i wskaż konto użytkownika, które ma być powiązane z tym kluczem.
      wskazówka
      Domyślnie włączony jest Tryb tylko do odczytu. 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 mieć dostęp.
    5. Kliknij Utwórz, aby zakończyć tworzenie klucza.
    6. Po utworzeniu klucza kliknij strzałkę pobierania w kolumnie Działania.
      • Zostanie wyświetlone okno dialogowe Pobierz klucz i MCP Server, które umożliwia pobranie klucza uwierzytelniającego i plików MCP Server na komputer.

        84e8cd25bd88ae24af06d04adfa474e9.png


        861ac76c2b4a5f3dc01072b0aa1f60d5.png


        e78eb04b35aa9fae188b2a6694ad4f96.png
    7. Wybierz swój system operacyjny:
      • Windows – dla komputerów z systemem Windows
      • macOS (M1 i nowsze) – dla komputerów Mac z układem Apple Silicon
      • macOS (Intel) – dla komputerów Mac z procesorem Intel
      • Linux – Claude Desktop nie jest dostępny dla systemu Linux; używaj innych hostów MCP.
      • Kliknij przycisk odpowiadający Twojemu systemowi operacyjnemu, aby pobrać pakiet zawierający klucz użytkownika oraz pliki MCP Server.
  4. Rozpakuj pakiet ZIP z MCP Server.
    1. Znajdź pobrany plik:
      • Nazwa pliku może być różna (np. qmcp-darwin-arm64-250630_1502.zip).
      • Sprawdź folder Pobrane lub lokalizację, którą wybrałeś.
    2. Rozpakuj plik ZIP:
      • Windows: Kliknij plik ZIP prawym przyciskiem myszy i wybierz Wyodrębnij wszystko lub użyj preferowanego narzędzia do rozpakowywania.
      • macOS: Kliknij dwukrotnie plik ZIP, aby rozpakować go automatycznie, lub użyj narzędzia takiego jak The Unarchiver.
    3. Sprawdź wyodrębnienie:
      • Powinien pojawić się folder zawierający plik wykonywalny MCP Server oraz pliki konfiguracyjne.
      • Zanotuj ścieżkę do folderu – będzie potrzebna podczas konfiguracji Claude Desktop.WażneZapamiętaj lokalizację wyodrębnionego folderu, ponieważ będzie potrzebna w kolejnych krokach konfiguracji.
  5. Pobierz Claude Desktop.
    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.
  6. Zainstaluj Claude Desktop.
    1. Windows:
      • Uruchom pobrany instalator .exe.
      • Postępuj zgodnie z instrukcjami kreatora instalacji i zaakceptuj umowę licencyjną.
      • Wybierz lokalizację instalacji i zakończ proces.
    2. macOS:
      • Otwórz pobrany plik .dmg.
      • Przeciągnij Claude Desktop do folderu Aplikacje.
      • Jeśli zostanie wyświetlony monit, przejdź do Preferencji systemowych > Prywatność i bezpieczeństwo i zezwól aplikacji na uruchomienie.
  7. Otwórz Claude Desktop.
    1. Uruchom Claude Desktop ze skrótu na pulpicie.
    2. Jeśli uruchamiasz Claude po raz pierwszy:
      • Zaloguj się na konto Anthropic.
      • Wykonaj wszystkie wstępne procedury konfiguracyjne.
      • Zaakceptuj warunki korzystania z usługi, jeśli zostanie wyświetlony odpowiedni monit.
  8. Edytuj konfigurację Claude Desktop.
    1. Znajdź plik konfiguracyjny:
      • Użyj interfejsu Claude Desktop: Menu (lewy górny róg) > Ustawienia > Deweloper > Edytuj konfigurację.
      • Plik konfiguracyjny możesz również znaleźć tutaj:
        • Windows: %APPDATA%\Claude\claude_desktop_config.json
        • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

          22f90105c4353e042c773571d7ba3865.png


          7938eb8bea2bf5700dc55b9961d5f925.png
    2. Edytuj plik:
      • Otwórz go w edytorze tekstu (np. Notepad++, VS Code, TextEdit).
      • Dodaj konfigurację MCP Server zgodnie z tym, co pokazuje okno dialogowe MCP Assistant. Na przykład:

        Kod: 
        {
"mcpServers": {
"qnap-nas": {
"command": "/path/to/qmcp-folder/qmcp"
}
}
}
      • Zastąp /path/to/qmcp-folder/qmcp rzeczywistą ścieżką do wyodrębnionego pliku wykonywalnego MCP Server.
      • W systemie Windows używaj podwójnych ukośników wstecznych (\\) zamiast pojedynczych (\). Na przykład: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.
    3. Zapisz plik konfiguracyjny.
  9. Zezwól na wykonywanie MCP Server.
    1. Użytkownicy systemu macOS:
      • Podczas uruchamiania pliku wykonywalnego MCP Server może pojawić się ostrzeżenie dotyczące bezpieczeństwa. Kliknij Gotowe, aby zamknąć ostrzeżenie.
      • Przejdź do Menu Apple > Ustawienia systemowe > Prywatność i bezpieczeństwo > Bezpieczeństwo.
      • Kliknij Zezwól mimo to obok zablokowanego pliku wykonywalnego qmcp.
      • Zezwalaj na uruchamianie wyłącznie plików wykonywalnych z zaufanych źródeł, aby uniknąć ryzyka.

        592ac444365a6ecd84b69b1a7e967697.png


        3f5d7c21420bda87c598c47e78f47b7d.png


        4d3da58822d1a03401252fadbc3dba46.png
    2. Użytkownicy systemu Windows:
      • Upewnij się, że oprogramowanie antywirusowe lub zapora sieciowa nie blokuje pliku wykonywalnego MCP Server.
      • W razie potrzeby dodaj wyjątki.
  10. Otwórz ponownie Claude Desktop i przetestuj konfigurację.
    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żera zadań, znajdź aplikację i wybierz Zakończ zadanie.
        Jeśli to nie zadziała, uruchom ponownie komputer.
    2. Przetestuj za pomocą poleceń takich jak:
      • Czy masz dostęp do mojego urządzenia QNAP NAS?
      • Pokaż mi stan pamięci masowej mojego NAS.
      • Wylistuj pliki w moich folderach udostępnionych.
    3. Sprawdź, czy Claude odpowiada poprawnie na zapytania związane z Twoim urządzeniem NAS.
    4. Jeśli pojawią się błędy, sprawdź interfejs użytkownika, aby uzyskać szczegółowe informacje.


Wskazówki dotyczące rozwiązywania problemów​


Poniżej znajdziesz wskazówki dotyczące szybkiego rozwiązywania typowych problemów.

  • Problemy z połączeniem: Upewnij się, że ścieżka do MCP Server w pliku konfiguracyjnym jest prawidłowa.
  • Błędy uprawnień: Upewnij się, że plik wykonywalny MCP Server ma odpowiednie uprawnienia.
  • Problemy z uwierzytelnianiem: Upewnij się, że klucz uwierzytelniający z MCP Assistant znajduje się we właściwej lokalizacji.
  • Blokowanie przez zaporę sieciową: Upewnij się, że zapora sieciowa zezwala na komunikację MCP Server.


Podsumowanie​


Pomyślnie skonfigurowałeś aplikację QNAP MCP Assistant z Claude Desktop. Możesz teraz wykorzystywać możliwości sztucznej inteligencji Claude do interakcji z urządzeniem QNAP NAS za pomocą poleceń w języku naturalnym, w tym do zarządzania plikami i monitorowania systemu.
 
Kliknij, aby rozwinąć...
Musisz się zalogować lub zarejestrować, aby odpowiedzieć tutaj.
Początek strony Dół
Z powrotem