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

Como configurar o Assistente MCP para Claude operar o meu NAS com comandos de linguagem natural?

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. Se o seu NAS estiver a executar QTS/QuTS hero 5.2.1 ou versões posteriores:
   1. Inicie sessão no seu NAS QNAP.
   2. Vá para o App Center.
   3. No canto superior direito, clique  
   4. Selecione Participar no Programa Beta de Aplicações QNAP  e clique  Aplicar.
   5. No campo de pesquisa, procure por MCP Assistant.
   6. Clique Instalar.
2. Se o seu NAS estiver a executar QTS/QuTS hero 5.2.0:
   1. Vá para a página web do App Center.
   2. Procure por MCP Assistant.
   3. Clique MCP Assistant no resultado da pesquisa.
   4. Selecione o modelo do seu NAS.
   5. Transfira o ficheiro de instalação.
   6. Inicie sessão no seu NAS QNAP.
   7. Vá para App Center.
   8. No canto superior direito, clique  
   9. Selecione Instalar Manualmente.
   10. Clique Procurar e carregue o ficheiro de instalação que acabou de transferir do website da QNAP.
   11. Clique em Instalar.

1. Localize o MCP Assistant no Menu Principal.
2. Inicie MCP Assistant.
    

1. No MCP Assistant, vá ao separador Credenciais.
2. Clique em Criar para gerar uma nova chave.
3. Introduza um nome descritivo para a chave, selecione o tipo de chave e escolha a conta de utilizador a associar a esta chave.
   Sugestão

   Por defeito, o Modo só de leitura está ativado. Para conceder mais privilégios a um utilizador de confiança, pode desmarcar esta opção.
4. Especifique quais as ferramentas MCP a que o utilizador pode aceder.
5. Clique em Criar para concluir a criação da chave.
6. Após a criação da chave, clique na seta de download em Ações. 
   • O diálogo Download Key and MCP Server aparecerá, permitindo-lhe descarregar a chave de autenticação e os ficheiros do MCP Server para o seu computador.
      
      
      
7. Selecione o seu sistema operativo:
8. • Windows – Para computadores baseados em Windows
   • macOS (M1 e superior) – Para Macs Apple Silicon
   • macOS (Intel) – Para Macs baseados em Intel
   • Linux – Claude Desktop não está disponível para Linux; utilize outros hosts MCP.
   • Clique no botão correspondente ao seu SO para descarregar o pacote, que inclui tanto a sua chave de utilizador como os ficheiros do MCP Server.

1. Localize o ficheiro descarregado:
   • O nome do ficheiro irá variar (por exemplo, qmcp-darwin-arm64-250630_1502.zip).
   • Verifique a sua pasta de Downloads ou o local que selecionou.
2. Extraia o ficheiro ZIP:
   • Windows: Clique com o botão direito no ficheiro ZIP e selecione Extrair Tudo ou utilize a sua ferramenta de extração preferida.
   • macOS: Dê um duplo clique no ficheiro ZIP para extraí-lo automaticamente ou utilize uma ferramenta como The Unarchiver.
3. Verifique a extração:
   • Deverá ver uma pasta contendo o executável do MCP Server e ficheiros de configuração.
   • Anote o caminho da pasta; irá precisar dele para a configuração do Claude Desktop.
     Importante

     Mantenha um registo da localização da pasta extraída para passos de configuração posteriores.

1. Visite o site oficial da Anthropic em claude.ai.
2. Navegue até à secção de download do Claude Desktop.
3. Transfira o instalador apropriado para o seu sistema operativo:
   • Windows: Transfira o instalador .exe.
   • macOS: Transfira o instalador .dmg.

1. Windows:
   • Execute o instalador .exe transferido.
   • Siga as instruções do assistente de instalação e aceite o acordo de Licença.
   • Escolha a localização da instalação e complete o processo.
2. macOS:
   • Abra o ficheiro .dmg transferido.
   • Arraste o Claude Desktop para a pasta Aplicações.
   • Se solicitado, vá a System Preferences > Security & Privacy e permita que a aplicação seja executada.

1. Inicie o Claude Desktop a partir do atalho no ambiente de trabalho.
2. Se for a primeira vez que está a iniciar o Claude:
   • Inicie sessão com a sua conta Anthropic.
   • Complete quaisquer procedimentos de configuração inicial.
   • Aceite Termos de Serviço se solicitado.

Edite a configuração do Claude Desktop.

1. Localize o ficheiro de configuração:
   • Utilize a UI do Claude Desktop: Menu (canto superior esquerdo) > Definições > Desenvolvedor > Editar Config.
   • Pode também encontrar o ficheiro de configuração aqui:
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
        
        
       
       

2. Edite o ficheiro:

   • Abra num editor de texto (por exemplo, Notepad++, VS Code, TextEdit).

   • Adicione a configuração do MCP Server conforme mostrado no diálogo do MCP Assistant. Por exemplo:

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

   • Substitua  /path/to/qmcp-folder/qmcp  pelo caminho real para o seu executável extraído do MCP Server.

   • No Windows, use barras invertidas duplas (\\) em vez de barras invertidas simples (\). Por exemplo: C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.

3. Guarde o ficheiro de configuração.

Permita a execução do MCP Server.

1. Utilizadores de macOS:
   • Poderá ver um aviso de segurança ao executar o executável do MCP Server. Clique em Concluído para fechar o aviso.
   • Aceda a Apple Menu > Definições do Sistema > Privacidade & Segurança > Segurança.
   • Clique em Permitir Mesmo Assim ao lado do executável qmcp bloqueado.
   • Permita apenas executáveis de fontes confiáveis para evitar riscos.
      
      
      
2. Utilizadores de Windows:
   • Certifique-se de que o software antivírus ou Firewall não bloqueia o executável do MCP Server.
   • Adicione exceções, se necessário.

1. Para carregar a sua configuração anterior, saia completamente do Claude Desktop e reabra-o.
   1. macOS: Forçar a saída da aplicação ou fechar a aplicação no Monitor de Atividade.
   2. Windows: abra o Gestor de Tarefas, localize a aplicação e selecione Terminar tarefa.

      Se isto não funcionar, reinicie o seu computador.

2. Teste com sugestões como:
   • Consegue aceder ao meu NAS QNAP?
   • Mostre-me o estado do meu NAS Armazenamento.
   • Liste os ficheiros nas minhas pastas partilhadas.
3. Verifique se o Claude responde com interações bem-sucedidas relacionadas com o seu NAS.
4. Se aparecerem erros, verifique a interface do utilizador para obter detalhes.