Important
In response to recent Claude Desktop updates, we are greatly streamlining the current workflow of MCP installation to enhance your experience. You will soon be able to complete the MCP setup with just a few clicks. We plan to add this enhancement in the next release of MCP Assistant. Please stay tuned.
Applicable Products
- QNAP NAS devices running QTS 5.2, QuTS hero h5.2, or later versions
- MCP Assistant
Introduction
This tutorial guides you through the process of setting up QNAP's MCP Assistant to work with Claude Desktop, which enables seamless integration between your QNAP NAS and Claude's AI capabilities. You can then use natural language commands to operate your NAS.
Prerequisites
Before your start, ensure that you have the following setup:
- QNAP NAS device with QTS 5.2, QuTS hero h5.2, or later versions
- Computer with internet connection (Windows or macOS; Claude Desktop is not available for Linux)
- Administrator access to your QNAP NAS
- Default MCP Assistant ports: 8442 and 8443
Procedure
- Install MCP Assistant (beta) from App Center.
- If your NAS runs QTS/QuTS hero 5.2.1 or later versions:
- Log in to your QNAP NAS.
- Go to the App Center.
- On the top-right corner, click

- Select Join the QNAP App Beta Program and click Apply.
- In the search bar, search for MCP Assistant.
- Click Install.
- If your NAS runs QTS/QuTS hero 5.2.0:
- Go to the webpage of App Center.
- Search for MCP Assistant.
- Click MCP Assistant from the search result.
- Select your NAS model.
- Download the installation file.
- Log in to your QNAP NAS.
- Go to App Center.
- On the right-top corner, click

- Select Install Manually.
- Click Browse and upload the installation file that you just downloaded from the QNAP website.
- Click Install.
- Open MCP Assistant.
- Locate the MCP Assistant from the Main Menu.
- Launch MCP Assistant.

- Create credentials and download MCP Server.
- In the MCP Assistant, go to the Credentials tab.
- Click Create to generate a new key.
- 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.
- Specify which MCP tools the user can access.
- Click Create to complete key creation.
- 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.



- Select your operating system:
- 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.
- Extract the MCP Server ZIP package.
- 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.
- 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.
- 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.
- Download Claude Desktop.
- Visit the official Anthropic website at claude.ai.
- Navigate to the Claude Desktop download section.
- Download the appropriate installer for your operating system:
- Windows: Download the .exe installer.
- macOS: Download the .dmg installer.
- Install Claude Desktop.
- Windows:
- Run the downloaded .exe installer.
- Follow the installation wizard prompts and accept the license agreement.
- Choose the installation location and complete the process.
- 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.
- Open Claude Desktop.
- Launch Claude Desktop from your desktop shortcut.
- 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.
- 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


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.
Save the configuration file.
Allow execution of the MCP Server.
- 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.



- Windows users:
- Ensure antivirus or firewall software does not block the MCP Server executable.
- Add exceptions if necessary.
- Re-open Claude Desktop and test the setup.
- To load your previous configuration, completely quit Claude Desktop and reopen it.
- macOS: Force Quit the app or close the app in Activity Monitor.
- Windows: open Task Manager, locate the app, and select End task.
If this does not work, restart your computer.
- 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.
- Verify Claude responds with successful interactions related to your NAS.
- If errors appear, check the user interface for details.
Troubleshooting Tips
Below are tips for quickly troubleshooting common issues.
- Connection issues: Ensure that the MCP Server path in the configuration file is correct.
- Permission errors: Ensure that the MCP Server executable has appropriate permissions.
- Authentication problems: Ensure that the authentication key from MCP Assistant is in the correct location.
- Firewall blocking: Ensure that your firewall allows MCP Server communication.
Conclusion
You have successfully set up QNAP MCP Assistant with Claude Desktop. You can now leverage Claude's AI capabilities to interact with your QNAP NAS through natural language commands, including file management and system monitoring.
重要
最近の Claude Desktop の更新に対応して、MCP インストールのワークフローを大幅に簡素化し、ユーザー体験を向上させます。まもなく、数回のクリックで MCP のセットアップを完了できるようになります。この機能強化は次回の MCP Assistant のリリースに追加する予定です。どうぞご期待ください。
対象製品
- QNAP NAS devices running QTS 5.2, QuTS hero h5.2, or later versions
- MCP Assistant
導入
このチュートリアルでは、QNAP の MCP Assistant を Claude Desktop と連携させる設定手順を案内します。これにより、QNAP NAS と Claude の AI 機能がシームレスに統合され、自然言語コマンドで NAS を操作できるようになります。
前提条件
始める前に、以下のセットアップを確認してください:
- QNAP NAS デバイス(QTS 5.2、QuTS hero h5.2、またはそれ以降のバージョン)
- インターネット接続されたコンピュータ(Windows または macOS;Claude Desktop は Linux では利用できません)
- 管理者 QNAP NAS へのアクセス
- デフォルトの MCP Assistant ポート:8442 および 8443
手順
- App Center から MCP Assistant(ベータ版)をインストールします。
- NAS が QTS/QuTS hero 5.2.1 以降のバージョンを実行している場合:
- QNAP NAS にログインします。
- App Centerに移動します。
- 右上の隅をクリック

- QNAP App Beta Program に参加を選択し、 適用をクリックします。
- 検索バーでMCP Assistantを検索します。
- インストールをクリックします。
- NAS が QTS/QuTS hero 5.2.0 を実行している場合:
- App Center のウェブページに移動します。
- MCP Assistantを検索します。
- 検索結果からMCP Assistantをクリックします。
- NAS モデルを選択します。
- インストールファイルをダウンロードします。
- QNAP NAS にログインします。
- App Center に移動します。
- 右上の隅をクリック

- 手動でインストールを選択します。
- 参照をクリックし、QNAP ウェブサイトからダウンロードしたインストールファイルをアップロードします。
- インストールをクリックします。
- MCP Assistant を開きます。
- メインメニューから MCP Assistant を見つけます。
- MCP Assistantを起動します。

- 資格情報を作成し、MCP サーバーをダウンロードします。
- MCP Assistant で資格情報タブに移動します。
- 作成をクリックして新しいキーを生成します。
- キーの説明名を入力し、キーの種類を選択し、このキーに関連付けるユーザーアカウントを選びます。
ヒント
デフォルトでは、読み取り専用モードが有効です。信頼できるユーザーにより多くの権限を与えるには、このオプションのチェックを外すことができます。
- ユーザーがアクセスできる MCP ツールを指定します。
- 作成をクリックしてキーの作成を完了します。
- キーが作成された後、アクションの下にあるダウンロード矢印をクリックします。
- キーと MCP サーバーのダウンロードダイアログが表示され、認証キーと MCP サーバーファイルをコンピュータにダウンロードできます。



- オペレーティングシステムを選択します:
- Windows – Windows ベースのコンピュータ用
- macOS (M1 以上) – Apple Silicon Mac 用
- macOS (Intel) – Intel ベースの Mac 用
- Linux – Claude Desktop は Linux では利用できません。他の MCP ホストを使用してください。
- OS に対応するボタンをクリックして、ユーザーキーと MCP サーバーファイルを含むパッケージをダウンロードします。
- MCP サーバーの ZIP パッケージを解凍します。
- ダウンロードしたファイルを見つけます:
- ファイル名は異なる場合があります(例:qmcp-darwin-arm64-250630_1502.zip)。
- ダウンロードフォルダまたは選択した場所を確認します。
- ZIP ファイルを抽出します:
- Windows: ZIP ファイルを右クリックして、すべて展開を選択するか、お好みの抽出ツールを使用します。
- macOS: ZIP ファイルをダブルクリックして自動的に抽出するか、The Unarchiver のようなツールを使用します。
- 抽出を確認します:
- MCP サーバーの実行ファイルと設定ファイルを含むフォルダーが表示されるはずです。
- フォルダーパスをメモしておいてください。Claude Desktop の設定に必要です。
重要
後の設定手順のために、抽出したフォルダーの場所を把握しておいてください。
- Claude Desktop をダウンロードします。
- 公式 Anthropic ウェブサイトにアクセスしますclaude.ai。
- Claude Desktop のダウンロードセクションに移動します。
- お使いのオペレーティングシステムに適したインストーラーをダウンロードします:
- Windows: .exe インストーラーをダウンロードします。
- macOS: .dmg インストーラーをダウンロードします。
- Claude Desktop をインストールします。
- Windows:
- ダウンロードした.exe インストーラーを実行します。
- インストールウィザードの指示に従い、ライセンス契約に同意します。
- インストール場所を選択し、プロセスを完了します。
- macOS:
- ダウンロードした.dmg ファイルを開きます。
- Claude Desktop をアプリケーションフォルダーにドラッグします。
- プロンプトが表示された場合は、システム環境設定 > セキュリティとプライバシーに移動し、アプリケーションの実行を許可します。
- Claude Desktop を開きます。
- デスクトップショートカットから Claude Desktop を起動します。
- Claude を初めて起動する場合:
- Anthropic アカウントでサインインします。
- 初期設定手順を完了します。
- プロンプトが表示された場合は、サービス利用条件に同意します。
Claude Desktop の設定を編集します。
- 設定ファイルを見つけます:
- Claude Desktop UI を使用: メニュー (左上) > 設定 > 開発者 > 設定を編集。
- 設定ファイルはここにもあります:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json


ファイルを編集:
- テキストエディタで開く(例:Notepad++、VS Code、TextEdit)。
MCP Assistant ダイアログに表示される MCP サーバーの設定を追加します。例:
{
"mcpServers": {
"qnap-nas": {"command": "/path/to/qmcp-folder/qmcp"}
}
}
/path/to/qmcp-folder/qmcp を、抽出した MCP サーバー実行ファイルの実際のパスに置き換えます。
- Windows では、単一のバックスラッシュ(\)の代わりに二重バックスラッシュ(\\)を使用します。例:
C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe。
設定ファイルを保存します。
MCP サーバーの実行を許可します。
- macOS ユーザー:
- MCP サーバー実行ファイルを実行すると、セキュリティ警告が表示されることがあります。警告を閉じるには完了をクリックします。
- Apple メニュー > システム設定 > プライバシーとセキュリティ > セキュリティに移動します。
- ブロックされた qmcp 実行ファイルの横にあるとにかく許可をクリックします。
- リスクを避けるために、信頼できるソースからの実行ファイルのみを許可してください。



- Windows ユーザー:
- ウイルス対策またはファイアウォールソフトウェアが MCP サーバー実行ファイルをブロックしないようにしてください。
- 必要に応じて例外を追加します。
- Claude Desktop を再度開き、セットアップをテストします。
- 以前の設定を読み込むには、Claude Desktop を完全に終了して再度開きます。
- macOS: アプリを強制終了するか、アクティビティモニタでアプリを閉じます。
- Windows: タスクマネージャーを開き、アプリを見つけてタスクの終了を選択します。
これがうまくいかない場合は、コンピュータを再起動してください。
- 次のようなプロンプトでテストします:
- 私の QNAP NAS にアクセスできますか?
- 私の NAS のストレージの状態を見せてください。
- 共有フォルダ内のファイルを一覧表示してください。
- Claude が NAS に関連する操作に成功して応答することを確認します。
- エラーが表示された場合は、詳細をユーザーインターフェースで確認してください。
トラブルシューティングのヒント
以下は、一般的な問題を迅速にトラブルシューティングするためのヒントです。
- 接続の問題:設定ファイルの MCP サーバーパスが正しいことを確認してください。
- 権限エラー: MCP サーバーの実行ファイルに適切な権限があることを確認してください。
- 認証の問題: MCP アシスタントからの認証キーが正しい場所にあることを確認してください。
- ファイアウォールのブロック: あなたのファイアウォールが MCP サーバーの通信を許可していることを確認してください。
結論
QNAP MCP アシスタントを Claude Desktop で正常に設定しました。これで、ファイル管理やシステム監視を含む自然言語コマンドを通じて、Claude の AI 機能を活用して QNAP NAS と対話できます。