Claude Desktop だけで Scalebase MCP サーバーを使う場合の 短縮手順 です。.mcpb ファイルをダブルクリック → UI で API キーを入れるだけで完了します。
他のクライアント（Claude Code (CLI) / Cursor / Claude Cowork / Claude Chat）も使う方は本ドキュメントの対象外です。 従来手順の
install-macos-mcp.mdに進んでください（バイナリの手動配置と JSON 設定ファイルの編集が必要です）。
| クライアント | 推奨手順 |
|---|---|
| Claude Desktop | install-macos-mcpb.md（本ドキュメント） |
| Claude Code (CLI) | install-macos-mcp.md |
| Cursor | install-macos-mcp.md |
| Claude Cowork | install-macos-mcp.md |
| Claude Chat | install-macos-mcp.md |
<aside> ⚠️
現在配布している .mcpb は、社内アルファテスト向けのビルドです。
本ドキュメントの手順 3 で Gatekeeper の警告を一度許可していただく必要があります。正式版では署名・自動アップデートを含むパッケージ配布を予定しています。アルファテスト期間中に詰まった点があれば、遠慮なくフィードバックをお願いします。
</aside>
<aside>
現在 MCP として公開しているツールは read 系 32 種 + write 系 29 種 = 計 61 種 で、Scalebase の主要リソースをほぼ網羅しています。代表例:
scalebase_provider_get / scalebase_customer_list / scalebase_contract_v2_get / scalebase_billing_search / scalebase_amendment_list ほかscalebase_customer_create / scalebase_contract_v2_create / scalebase_amendment_change_quantity / scalebase_billing_create / scalebase_billing_batch_record_payments ほか既定はリードオンリー: インストール画面の Read-only mode が ON の状態では tools/list に read 系 32 種のみが公開されます。write 系も使うには Read-only mode を OFF にしてください。
既定環境は sandbox: Environment フィールドの既定は sandbox です。Production を使う場合は production に書き換えてください。
destructive 操作: cancel_* / delete_* / unlink_* / update_* / batch_* には MCP の destructiveHint=true annotation が自動付与され、Claude Desktop で実行前確認ダイアログが表示されます。
</aside>
Scalebase ダッシュボードで API キーを発行します。利用する環境に応じて、以下のURLにアクセスしてください:
「連携サービス」設定画面で API キーを発行し、安全な場所に控えておいてください（手順 4 で Claude Desktop の UI に貼り付けます）。
APIキーは機密情報です。チャットやスクリーンショットなどで共有しないようご注意ください。
.mcpb のダウンロードブラウザで以下の URL にアクセスしてください:
お使いの Mac がどちらか分からない場合: 画面左上の Apple メニュー →「この Mac について」で「チップ」欄を確認してください。Apple M1/M2/M3/M4 と表示されていれば Apple Silicon、Intel Core と表示されていれば Intel Mac です。
Basic 認証ダイアログが表示されるので、運用担当者から受け取ったユーザー名・パスワードを入力します。認証に成功すると .mcpb ファイルがダウンロードされます。
ダウンロードした .mcpb ファイルを ダブルクリック してください。Claude Desktop が起動して、インストール画面が開きます。