Claude Desktop で使う

Claude Desktop での hocg-analyze MCP サーバーの接続設定手順

Claude Desktop から hocg-analyze MCP サーバーに接続する方法を説明します。

前提条件

Claude Desktop がインストール済みであること
Node.js がインストール済みであること（npx 経由で mcp-remote を実行するため）

:::note Claude Desktop はネイティブでは stdio トランスポートのみを扱います。本サーバーはリモート HTTP 型のため、mcp-remote プロキシを経由して stdio ↔ HTTP をブリッジします。 :::

接続設定

Claude Desktop の Settings を開く（メニューバー → Claude → Settings）
Developer タブを選択
Edit Config をクリックして設定ファイルを開く
以下の JSON を mcpServers に追加する:

{
  "mcpServers": {
    "hocg-analyze": {
      "command": "npx",
      "args": ["mcp-remote", "https://hocg-analyze.holotune.jp/mcp"]
    }
  }
}

Claude Desktop を再起動する

接続確認

Claude Desktop を再起動したら、チャット画面で以下を試してください:

hocg-analyze で利用できるツールの一覧を教えてください

14 個のツールが表示されれば接続成功です。

トラブルシューティング

ツールが表示されない

設定ファイルの JSON が正しいか確認してください（カンマの過不足など）
Claude Desktop を完全に終了し、再起動してください
Settings → Developer で hocg-analyze が一覧に表示されているか確認してください
初回起動時は npx が mcp-remote をダウンロードするため、表示まで数十秒かかることがあります

接続エラーが表示される

インターネット接続を確認してください
https://hocg-analyze.holotune.jp/mcp にアクセスできるか確認してください
ファイアウォールやプロキシの設定を確認してください

`npx` コマンドが見つからない

Node.js がインストールされているか node --version で確認してください
PATH に npx が含まれているか確認してください（Claude Desktop は GUI 起動時にシェルの PATH を完全には継承しません）
問題が続く場合、command を npx の絶対パス（例: /usr/local/bin/npx）に書き換えてください

別案: claude.ai の Connectors

GUI で完結させたい場合、claude.ai の Settings → Connectors → Add custom connector から https://hocg-analyze.holotune.jp/mcp を直接登録することもできます（Claude Web のみ、設定ファイル編集は不要）。