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

Claude'un NAS'ımı doğal dil komutlarıyla çalıştırması için MCP Asistanı nasıl kurulur?

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. NAS'ınız QTS/QuTS hero 5.2.1 veya daha yeni sürümler çalıştırıyorsa:
   1. QNAP NAS'ınıza giriş yapın.
   2. App Center 'e gidin.
   3. Sağ üst köşede,   tıklayın
   4. QNAP Uygulama Beta Programına Katıl  'ı seçin ve  Uygula'ya tıklayın.
   5. Arama çubuğunda, MCP Assistant arayın.
   6. Yükle 'ye tıklayın.
2. NAS'ınız QTS/QuTS hero 5.2.0 çalıştırıyorsa:
   1. App Center'ın web sayfası 'a gidin.
   2. MCP Assistant arayın.
   3. Arama sonucundan MCP Assistant 'a tıklayın.
   4. NAS modelinizi seçin.
   5. Kurulum dosyasını indirin.
   6. QNAP NAS'ınıza giriş yapın.
   7. App Center'ye gidin.
   8. Sağ üst köşede,   tıklayın
   9. Manuel Yükle 'yi seçin.
   10. Gözat 'a tıklayın ve QNAP web sitesinden indirdiğiniz kurulum dosyasını yükleyin.
   11. Yükle öğesine tıklayın.

1. Ana Menüden MCP Asistanı'nı bulun.
2. MCP Asistanı başlatın.
    

1. MCP Asistanı'nda, Kimlik Bilgileri sekmesine gidin.
2. Yeni bir anahtar oluşturmak için Oluştur öğesine tıklayın.
3. Anahtar için açıklayıcı bir ad girin, anahtar türünü seçin ve bu anahtarla ilişkilendirilecek kullanıcı hesabını seçin.
   İpucu

   Varsayılan olarak, Salt Okunur Mod etkindir. Güvenilir bir kullanıcıya daha fazla ayrıcalık vermek için bu seçeneği kaldırabilirsiniz.
4. Kullanıcının erişebileceği MCP araçlarını belirtin.
5. Anahtar oluşturmayı tamamlamak için Oluştur öğesine tıklayın.
6. Anahtar oluşturulduktan sonra, Eylemler altındaki indirme okuna tıklayın. 
   • Anahtarı ve MCP Sunucusunu İndir iletişim kutusu görünecek, bu da kimlik doğrulama anahtarını ve MCP Sunucusu dosyalarını bilgisayarınıza indirmenizi sağlar.
      
      
      
7. İşletim sisteminizi seçin:
8. • Windows – Windows tabanlı bilgisayarlar için
   • macOS (M1 ve üstü) – Apple Silicon Mac'ler için
   • macOS (Intel) – Intel tabanlı Mac'ler için
   • Linux – Claude Desktop Linux için mevcut değil; diğer MCP ana bilgisayarlarını kullanın.
   • Paketinizi indirmek için işletim sisteminize uygun düğmeye tıklayın, bu paket hem kullanıcı anahtarınızı hem de MCP Sunucusu dosyalarını içerir.

1. İndirilen dosyayı bulun:
   • Dosya adı değişiklik gösterebilir (örneğin, qmcp-darwin-arm64-250630_1502.zip).
   • İndirilenler klasörünüzü veya seçtiğiniz konumu kontrol edin.
2. ZIP dosyasını çıkarın:
   • Windows: ZIP dosyasına sağ tıklayın ve Tümünü Çıkart seçeneğini veya tercih ettiğiniz çıkarma aracını kullanın.
   • macOS: ZIP dosyasına çift tıklayarak otomatik olarak çıkarın veya The Unarchiver gibi bir araç kullanın.
3. Çıkarma işlemini doğrulayın:
   • MCP Server çalıştırılabilir dosyasını ve yapılandırma dosyalarını içeren bir klasör görmelisiniz.
   • Klasör yolunu not edin; Claude Desktop yapılandırması için buna ihtiyacınız olacak.
     Önemli

     Çıkarılan klasör konumunu daha sonraki yapılandırma adımları için takip edin.

1. Resmi Anthropic web sitesini claude.ai adresinden ziyaret edin.
2. Claude Desktop indirme bölümüne gidin.
3. İşletim sisteminize uygun yükleyiciyi indirin:
   • Windows: .exe yükleyicisini indirin.
   • macOS: .dmg yükleyicisini indirin.

1. Windows:
   • İndirilen .exe yükleyicisini çalıştırın.
   • Kurulum sihirbazı talimatlarını izleyin ve Lisans sözleşmesini kabul edin.
   • Kurulum yerini seçin ve işlemi tamamlayın.
2. macOS:
   • İndirilen .dmg dosyasını açın.
   • Claude Desktop'u Uygulamalar klasörüne sürükleyin.
   • Eğer istenirse, Sistem Tercihleri > Güvenlik ve Gizlilik bölümüne gidin ve uygulamanın çalışmasına izin verin.

1. Masaüstü kısayolundan Claude Desktop'u başlatın.
2. Eğer Claude'u ilk kez başlatıyorsanız:
   • Anthropic hesabınızla oturum açın.
   • Herhangi bir ilk kurulum prosedürünü tamamlayın.
   • Eğer istenirse Hizmet Koşulları kabul edin.

Claude Desktop'un yapılandırmasını düzenleyin.

1. Yapılandırma dosyasını bulun:
   • Claude Desktop UI kullanın: Menü (sol üst) > Ayarlar > Geliştirici > Yapılandırmayı Düzenle.
   • Yapılandırma dosyasını burada da bulabilirsiniz:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Dosyayı düzenle:

   • Bir metin düzenleyicide açın (örneğin, Notepad++, VS Code, TextEdit).

   • MCP Sunucu yapılandırmasını MCP Asistanı diyalogunda gösterildiği gibi ekleyin. Örneğin:

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

   •  /path/to/qmcp-folder/qmcp  'ü çıkarılmış MCP Sunucu çalıştırılabilir dosyanızın gerçek yolu ile değiştirin.

   • Windows'ta, tek ters eğik çizgi (\) yerine çift ters eğik çizgi (\\) kullanın. Örneğin: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Yapılandırma dosyasını kaydedin.

MCP Sunucusunun çalıştırılmasına izin verin.

1. macOS kullanıcıları:
   • MCP Sunucu çalıştırılabilir dosyasını çalıştırırken bir güvenlik uyarısı görebilirsiniz. Uyarıyı kapatmak için Tamam 'a tıklayın.
   • Apple Menüsü > Sistem Ayarları > Gizlilik ve Güvenlik > Güvenlik bölümüne gidin.
   • Engellenen qmcp çalıştırılabilir dosyasının yanındaki Yine de İzin Ver 'e tıklayın.
   • Risklerden kaçınmak için yalnızca güvenilir kaynaklardan gelen çalıştırılabilir dosyalara izin verin.
      
      
      
2. Windows kullanıcıları:
   • Antivirüs veya Güvenlik Duvarı yazılımının MCP Sunucu çalıştırılabilir dosyasını engellemediğinden emin olun.
   • Gerekirse istisnalar ekleyin.

1. Önceki yapılandırmanızı yüklemek için Claude Desktop'u tamamen kapatın ve yeniden açın.
   1. macOS: Uygulamayı Zorla Çık veya Etkinlik Monitörü'nde uygulamayı kapat.
   2. Windows: Görev Yöneticisi'ni açın, uygulamayı bulun ve Görevi sonlandır seçeneğini seçin.

      Bu işe yaramazsa, bilgisayarınızı yeniden başlatın.

2. Aşağıdaki gibi istemlerle test edin:
   • QNAP NAS'ıma erişebilir misiniz?
   • NAS'ımın durumunu göster Depolama.
   • Paylaşılan klasörlerimdeki dosyaları listele.
3. Claude'un NAS'ınızla ilgili başarılı etkileşimler yanıtladığını doğrulayın.
4. Hatalar görünüyorsa, ayrıntılar için kullanıcı arayüzünü kontrol edin.