このガイドは、内部使用、プライベート配布、またはAnthropicのコネクタディレクトリへの提出の基盤として、デスクトップ拡張機能を作成するためのMCPバンドル(.mcpb)を構築するのに役立ちます。
1. はじめに
MCPBとは何ですか?
MCPB(.mcpb)ファイルは、ローカルMCPサーバーとmanifest.jsonを含むzipアーカイブです。ブラウザ拡張機能と同様に、Claude Desktopでワンクリックインストールを可能にします。
主な特徴:
ユーザーのマシン上でローカルに実行
stdioトランスポート経由で通信
すべての依存関係をバンドル
オフラインで動作
OAuthは不要
詳細情報:
MCPBリポジトリ - 完全な仕様とアーキテクチャ
デスクトップ拡張機能ブログ投稿 - 概要とユースケース
ローカルサーバー(MCPB)とリモートサーバーはどちらを使うべきですか?
以下の場合はローカルサーバー(MCPB)を選択してください:
内部システムとセキュリティ
ファイアウォール内のシステムにアクセス(JIRA、Confluence、内部wiki、プライベートデータベース)
シームレスな認証 - 既存のSSOとブラウザセッションを自動的に使用、トークン管理は不要
ゼロトラストコンプライアンス - 内部リソースを公開せずに企業ネットワーク境界内で動作
ローカルリソース
コード編集とGit操作のための直接ファイルシステムアクセス
ローカルにインストールされたツール(Docker、IDE、データベース)との統合
ハードウェア統合とデスクトップアプリケーション制御
ユーザーのマシンから外に出すべきではないプライバシーに関連する操作
エンタープライズデプロイメント
組み込みNode.jsランタイムでのワンクリックインストール(依存関係の管理は不要)
クラウドインフラストラクチャ、VPN設定、またはファイアウォールルールは不要
組織レベルの制御 - 管理者はカスタム拡張機能をアップロードし、許可リストを使用してアクセスを管理可能
認証、認可、監査ログの完全な制御
以下の場合はリモートコネクタを選択してください:
集中インフラストラクチャが必要なクラウドサービスとパブリックAPI
Claude on web、モバイル、デスクトップ全体での配布
すべてのユーザー全体での集中更新が必要なサービス
サーバー側のトークン管理が必要なOAuthフロー
複数の組織で使用される公開統合
主な違い: MCPBはstdioトランスポート経由でユーザーのマシン上で実行され、ローカルおよび内部リソースにアクセスできます。リモートコネクタはあなたのサーバー上でHTTPS経由で実行され、Anthropicのインフラストラクチャを通じてアクセスされます。
実際の使用例: 組織は、内部MCPサーバーへのセキュアプロキシとして、内部ドキュメントアクセス用として、また開発ツールを接続しながらセキュリティアーキテクチャを維持するためにMCPBを構築しています。
リモートコネクタのガイダンス: MCPパートナーFAQを参照して、完全なリモートコネクタドキュメントを確認してください。
2. はじめに
どのプログラミング言語を使うべきですか?
Node.jsを強くお勧めします理由は以下の通りです:
macOSおよびWindowsのClaudeに付属(ユーザーのインストール手間がゼロ)
ユーザーは別のランタイムインストールが不要
Claude Desktopとの最高の互換性と信頼性
広範なMCP SDKサポート
どのプラットフォームをサポートすべきですか?
Claude Desktopは以下で実行されます:
macOS(darwin)
Windows(win32)
manifest.jsonの互換性セクションでサポートされているプラットフォームを指定してください。
ベストプラクティス: 主に1つのプラットフォームで開発している場合でも、両方のプラットフォームでテストしてください。
プラットフォーム互換性の詳細: MCPBマニフェスト仕様 - 互換性を参照して、プラットフォーム仕様とランタイム要件を確認してください。
最初のMCPBを作成するにはどうすればよいですか?
以下の5段階のプロセスに従ってください:
1. MCPB CLIをインストール:npm install -g @anthropic-ai/mcpb
2. MCPサーバーを作成(MCP SDKを参照)
3. mcpb initを実行してmanifest.jsonを作成
4. mcpb packを実行してバンドル
5. Claude Desktopでインストールしてテスト
詳細な実装ガイダンス:
開発、テスト、ベストプラクティスに関する包括的なガイダンスについては、MCPBREADMEの「バンドル開発者向け」セクションを参照してください。
重要: MCPBを配布する前に、MCPBREADMEのテストとベストプラクティスガイダンスを確認して、品質を確保してください。
3. 設定
manifest.jsonとは何ですか?
manifest.jsonファイルは、MCPBが何をするか、どのように実行するか、どのツールを提供するか、どのような設定が必要かを説明する必須メタデータです。
最新の情報については、公式MCPB仕様を参照してください。
MCPBマニフェスト仕様 - 完全なスキーマとすべてのフィールド
マニフェストの例 - 実装例
CLIドキュメント - コマンドリファレンス
アイコンを追加するにはどうすればよいですか?
アイコンはオプションですが、プロフェッショナルな外観のために推奨されます。
基本的なアプローチ: バンドルのルートディレクトリにicon.pngファイルを含め、manifest.jsonで参照してください。
要件:
ファイル名: icon.png(またはカスタムパス)
サイズ: 512×512pxを推奨(最小256×256px)
形式: 透明度をサポートするPNG
場所: バンドルのルートまたは指定されたパス
高度なオプション: 異なるサイズとテーマ(ライト/ダークモード対応)用の複数のアイコンバリアント。
実装の詳細: MCPBマニフェスト仕様 - アイコンを参照して、以下を確認してください:
アイコンフィールド設定
複数のアイコンバリアント構文
サイズとテーマ仕様
ベストプラクティスと要件
ユーザーはMCPBをどのように設定しますか?
manifest.jsonでuser_configセクションを定義してください。Claude Desktopは自動的に設定UIを作成し、ユーザーが拡張機能を設定できるようにします。
MCPBマニフェスト仕様 - ユーザー設定を参照して、完全な実装を確認してください:
完全なスキーマと例
すべての設定タイプとプロパティ
検証制約
機密データの処理
複数選択パターン
ユーザーはMCPBをどのようにインストールしますか?
3つの異なるインストール方法があります:
ダブルクリック - .mcpbファイルをダウンロードしてダブルクリックして開く
ドラッグアンドドロップ - .mcpbファイルをClaude Desktopウィンドウにドラッグ
ファイルメニュー - 開発者 → 拡張機能 → 拡張機能をインストール → .mcpbファイルを選択
すべての方法でインストールUIが開きますユーザーは以下を実行できます:
拡張機能の詳細とアクセス許可を確認
必要な設定を構成
必要なアクセス許可を付与
インストールを完了
インストール範囲: ユーザーごとのインストール - 各ユーザーは自分のシステムに個別にインストールする必要があります。
ユーザーエクスペリエンスと管理者制御: エンドユーザーのインストール体験とエンタープライズ管理者制御(チーム/エンタープライズ組織管理とポリシー設定を含む)に関する詳細情報については、以下を参照してください:
Claude DesktopでのローカルMCPサーバーの開始 - ディレクトリ参照、インストールUI、トラブルシューティング、管理者制御をカバーする完全なユーザーガイド。
4. リソース
公式ドキュメント
MCPBフレームワーク:
MCPBリポジトリ - 完全な仕様とツール
MCPBマニフェスト仕様 - 完全なマニフェストスキーマ
MCPB CLIドキュメント - コマンドラインツールリファレンス
MCPBの例 - 実装例
MCPプロトコル:
MCP仕様 - プロトコルドキュメント
MCPクイックスタート - はじめにガイド
TypeScript SDK - Node.js実装
Python SDK - Python実装
Claude Desktop:
リリースノート - バージョン更新
デスクトップ拡張機能ブログ - アーキテクチャ概要
ヘルプを得る
サポートチャネル:
MCPB GitHubイシュー - バグレポートと機能リクエスト
MCP仕様 - プロトコルに関する質問
Claudeサポート - Claude Desktopの一般的なサポート
コミュニティリソース:
リポジトリのディスカッションでコミュニティQ&Aを確認
最新の更新についてリリースノートをフォロー
実装パターンについて例を確認
公開配布の準備はできていますか?
MCPBを構築し、より広い配布と発見可能性のためにAnthropicディレクトリに提出したい場合は、付属ガイドを参照してください:Anthropicディレクトリへの提出。
ディレクトリガイドは以下を含む追加要件をカバーしています:
すべてのツールの必須ツール注釈
プライバシーポリシー要件
最低3つの動作例
テスト認証情報(該当する場合)
完全な提出プロセスとレビュータイムライン
