メインコンテンツにスキップ

MCPBを使用したデスクトップ拡張機能の構築

昨日アップデートされました

このガイドは、内部使用、プライベート配布、またはAnthropicのコネクタディレクトリへの提出の基盤として、デスクトップ拡張機能を作成するためのMCPバンドル(.mcpb)を構築するのに役立ちます。


1. はじめに

MCPBとは何ですか?

MCPB(.mcpb)ファイルは、ローカルMCPサーバーとmanifest.jsonを含むzipアーカイブです。ブラウザ拡張機能と同様に、Claude Desktopでワンクリックインストールを可能にします。

主な特徴:

  • ユーザーのマシン上でローカルに実行

  • stdioトランスポート経由で通信

  • すべての依存関係をバンドル

  • オフラインで動作

  • OAuthは不要

詳細情報:


ローカルサーバー(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仕様を参照してください。


アイコンを追加するにはどうすればよいですか?

アイコンはオプションですが、プロフェッショナルな外観のために推奨されます。

基本的なアプローチ: バンドルのルートディレクトリにicon.pngファイルを含め、manifest.jsonで参照してください。

要件:

  • ファイル名: icon.png(またはカスタムパス)

  • サイズ: 512×512pxを推奨(最小256×256px)

  • 形式: 透明度をサポートするPNG

  • 場所: バンドルのルートまたは指定されたパス

高度なオプション: 異なるサイズとテーマ(ライト/ダークモード対応)用の複数のアイコンバリアント。

実装の詳細: MCPBマニフェスト仕様 - アイコンを参照して、以下を確認してください:

  • アイコンフィールド設定

  • 複数のアイコンバリアント構文

  • サイズとテーマ仕様

  • ベストプラクティスと要件


ユーザーはMCPBをどのように設定しますか?

manifest.jsonでuser_configセクションを定義してください。Claude Desktopは自動的に設定UIを作成し、ユーザーが拡張機能を設定できるようにします。

MCPBマニフェスト仕様 - ユーザー設定を参照して、完全な実装を確認してください:

  • 完全なスキーマと例

  • すべての設定タイプとプロパティ

  • 検証制約

  • 機密データの処理

  • 複数選択パターン


ユーザーはMCPBをどのようにインストールしますか?

3つの異なるインストール方法があります:

  1. ダブルクリック - .mcpbファイルをダウンロードしてダブルクリックして開く

  2. ドラッグアンドドロップ - .mcpbファイルをClaude Desktopウィンドウにドラッグ

  3. ファイルメニュー - 開発者 → 拡張機能 → 拡張機能をインストール → .mcpbファイルを選択

すべての方法でインストールUIが開きますユーザーは以下を実行できます:

  • 拡張機能の詳細とアクセス許可を確認

  • 必要な設定を構成

  • 必要なアクセス許可を付与

  • インストールを完了

インストール範囲: ユーザーごとのインストール - 各ユーザーは自分のシステムに個別にインストールする必要があります。

ユーザーエクスペリエンスと管理者制御: エンドユーザーのインストール体験とエンタープライズ管理者制御(チーム/エンタープライズ組織管理とポリシー設定を含む)に関する詳細情報については、以下を参照してください:


4. リソース

公式ドキュメント

MCPBフレームワーク:

MCPプロトコル:

Claude Desktop:


ヘルプを得る

サポートチャネル:

コミュニティリソース:

  • リポジトリのディスカッションでコミュニティQ&Aを確認

  • 最新の更新についてリリースノートをフォロー

  • 実装パターンについて例を確認


公開配布の準備はできていますか?

MCPBを構築し、より広い配布と発見可能性のためにAnthropicディレクトリに提出したい場合は、付属ガイドを参照してください:Anthropicディレクトリへの提出

ディレクトリガイドは以下を含む追加要件をカバーしています:

  • すべてのツールの必須ツール注釈

  • プライバシーポリシー要件

  • 最低3つの動作例

  • テスト認証情報(該当する場合)

  • 完全な提出プロセスとレビュータイムライン

こちらの回答で解決しましたか?