Claude Desktop で Biblon を使う

1. 前提条件

• Claude Desktop インストール済み（macOS / Windows）。https://claude.ai/download
  Claude Desktop 自身が Node.js を内蔵しているため、別途 Node を入れる必要はありません。
• Biblon API キー — 管理者に連絡してください。通常権限（isAdmin=false）で充分です。

2. インストール

1. 入手: biblon-mcp.mcpb をクリックしてダウンロードします。
2. ダブルクリック: 保存した biblon-mcp.mcpb をダブルクリックすると、Claude Desktop が起動してインストールダイアログが開きます。
   • ダブルクリックしても何も起きない場合（Windows でファイルの関連付けがされていないとき）は、Claude Desktop を開き、設定 → Extensions（拡張機能）→ ファイルから追加 で biblon-mcp.mcpb を選んでください。
3. 設定を入力:
   • Biblon API キー: 管理者から受け取ったキーを貼り付け。
   • 「開発環境を使う」で始まるチェックボックス（正式名称「開発環境を使う（社内テスター専用 / 通常はオフ）」）: チェックを入れない（通常利用は本番）。
4. Install を押す。

3. 動作確認

1. 入力欄横の 🛠 ハンマーアイコン をクリックし、biblon の下に 5 つのツール（search_by_theme, get_trending_books, find_related_books, get_facets, get_book_detail）が出ていれば成功。
2. 最初の会話を試す:
   最近、10代に流行りの本を5冊おすすめして
   Claude が get_trending_books または search_by_theme を呼び、結果を日本語で要約します。

4. トラブルシューティング

• ハンマーアイコンに biblon が出ない: Claude Desktop を完全終了して再起動。改善しなければ管理者に連絡してください。
• 401 / API キーのエラー: キー失効・スコープ違いの可能性。管理者に連絡してください。前後の空白に注意。
• Connection refused / ネットワークエラー: 本番 API は社内ネットワーク専用です。リモート作業中なら VPN に接続。
• ダウンロード時 / インストール時に Windows の警告が出る: 「SmartScreen」や「発行元を確認できません / 不明な発行元」と表示されることがあります。社内配布の正規ファイルなので、SmartScreen は「詳細情報」→「実行」、インストールダイアログの確認はそのまま続行して問題ありません。不安な場合は管理者に連絡してください。
• ログ（必要時）: macOS ~/Library/Logs/Claude/mcp*.log / Windows %APPDATA%\Claude\logs\mcp*.log。

5. 一時停止 / アンインストール

Claude Desktop の設定 → Extensions（拡張機能）から biblon を無効化または削除し、再起動するだけです。Claude Desktop 本体には影響しません。