1. 前提条件
- Claude Desktop インストール済み（macOS / Windows）。https://claude.ai/download
Claude Desktop 自身が Node.js を内蔵しているため、別途 Node を入れる必要はありません。 - Biblon API キー — 管理者に連絡してください。通常権限（
isAdmin=false）で充分です。
2. インストール
- 入手:
biblon-mcp.mcpbをクリックしてダウンロードします。 - ダブルクリック: 保存した
biblon-mcp.mcpbをダブルクリックすると、Claude Desktop が起動してインストールダイアログが開きます。- ダブルクリックしても何も起きない場合（Windows でファイルの関連付けがされていないとき）は、Claude Desktop を開き、設定 → Extensions（拡張機能）→ ファイルから追加 で
biblon-mcp.mcpbを選んでください。
- ダブルクリックしても何も起きない場合（Windows でファイルの関連付けがされていないとき）は、Claude Desktop を開き、設定 → Extensions（拡張機能）→ ファイルから追加 で
- 設定を入力:
- Biblon API キー: 管理者から受け取ったキーを貼り付け。
- 「開発環境を使う」で始まるチェックボックス（正式名称「開発環境を使う（社内テスター専用 / 通常はオフ）」）: チェックを入れない（通常利用は本番。社内テスターは 6. 開発環境で使う を参照）。
- Install を押す。
3. 動作確認
- 入力欄横の 🛠 ハンマーアイコン をクリックし、
biblonの下に 5 つのツール（search_by_theme,get_trending_books,find_related_books,get_facets,get_book_detail）が出ていれば成功。 - 最初の会話を試す:
最近、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 本体には影響しません。
6. 開発環境で使う（社内テスター専用）
開発環境（biblon-dev.valuebooks.jp）では、テーマ検索（自然文でのおすすめ・関連本・トレンド）が有効で、改善中のランキングを試せます。本番ではテーマ検索は無効なので、テーマ検索のテストはこちらで行います。通常のご利用は本番のままにしてください。
- 開発用 API キーを管理者に発行してもらう。
biblon_dev_で始まるキーです。本番用（biblon_prod_）のキーは開発環境では使えません（環境ごとに別のキーです）。 - Claude Desktop の 設定 → Extensions（拡張機能）→
biblon→ 設定（Configure） を開く。初回インストール時なら、2. インストール の「設定を入力」画面で同じ操作ができます。 - 「開発環境を使う（社内テスター専用 / 通常はオフ）」にチェックを入れ、Biblon API キーを開発用キーに差し替える。
- 保存して Claude Desktop を再起動（拡張機能は起動時に設定を読みます）。
- 確認: 自然文で聞いてみる。
雨の日に読みたい静かな小説を5冊
search_by_themeが呼ばれて結果が返れば、開発環境に接続できています。本番に接続したままだと、この種の問い合わせは「未対応」のエラーになります。
本番に戻すときは、同じ設定画面でチェックを外し、本番用キーに戻して再起動するだけです。開発環境のデータは検証用で、検索結果や応答時間が本番と異なることがあります。