このガイドは、社内利用、プライベート配布、またはAnthropicのConnectors Directoryへの提出の基盤として、デスクトップ拡張機能を作成するためのMCPバンドル(.mcpb)の構築を支援します。
1. はじめに
MCPBとは何ですか?
MCPB(.mcpb)ファイルは、ローカルMCPサーバーとmanifest.jsonを含むzipアーカイブです。ブラウザ拡張機能と同様に、Claude Desktopでワンクリックインストールを可能にします。
主な特徴:
ユーザーのマシン上でローカルに実行
stdioトランスポート経由で通信
すべての依存関係をバンドル
オフラインで動作
OAuthは不要
詳細情報:
MCPBリポジトリ - 完全な仕様とアーキテクチャ
Desktop Extensionsブログ記事 - 概要とユースケース
ローカルサーバー(MCPB)とリモートサーバーのどちらを使用すべきですか?
以下の場合はローカルサーバー(MCPB)を選択してください:
内部システムとセキュリティ
ファイアウォールの内側のシステムへのアクセス(JIRA、Confluence、社内wiki、プライベートデータベース)
シームレスな認証 - 既存のSSOとブラウザセッションを自動的に使用し、トークン管理は不要
ゼロトラストコンプライアンス - 内部リソースを公開せずに企業ネットワーク境界内で動作
ローカルリソース
コード編集とGit操作のための直接的なファイルシステムアクセス
ローカルにインストールされたツール(Docker、IDE、データベース)との統合
ハードウェア統合とデスクトップアプリケーション制御
ユーザーのマシンから離れるべきではないプライバシーに敏感な操作
エンタープライズ展開
組み込みのNode.jsランタイムによるワンクリックインストール(管理する依存関係なし)
クラウドインフラストラクチャ、VPN設定、ファイアウォールルールは不要
組織レベルの制御 - 管理者はカスタム拡張機能をアップロードし、許可リストを介してアクセスを管理可能
認証、認可、監査ログの完全な制御
以下の場合はリモートコネクタを選択してください:
集中型インフラストラクチャを必要とするクラウドサービスとパブリックAPI
Web、モバイル、デスクトップ上のclaude全体への配布
すべてのユーザーに対して集中的な更新が必要なサービス
サーバー側のトークン管理を必要とするOAuthフロー
複数の組織で使用される公開統合
主な違い: MCPBはstdioトランスポート経由でユーザーのマシン上で実行され、ローカルおよび内部リソースにアクセスします。リモートコネクタはHTTPS経由でサーバー上で実行され、Anthropicのインフラストラクチャを通じてアクセスされます。
実際の使用例: 組織は、内部MCPサーバーへの安全なプロキシとして、社内ドキュメントアクセスのため、およびセキュリティアーキテクチャを維持しながら開発ツールを接続するためにMCPBを構築しています。
リモートコネクタのガイダンス: 完全なリモートコネクタドキュメントについては、MCP Partner FAQを参照してください。
2. はじめに
どのプログラミング言語を使用すべきですか?
Node.jsを強く推奨します。理由は以下の通りです:
macOSおよびWindows用のClaudeに同梱(ユーザーにとってインストールの摩擦がゼロ)
ユーザーは別途ランタイムをインストールする必要がない
Claude Desktopとの最高の互換性と信頼性
広範なMCP SDKサポート
どのプラットフォームをサポートすべきですか?
Claude Desktopは以下で動作します:
macOS (darwin)
Windows (win32)
manifest.jsonの互換性セクションでサポートするプラットフォームを指定してください。
ベストプラクティス: 主に1つのプラットフォームで開発している場合でも、両方のプラットフォームでテストしてください。
プラットフォーム互換性の詳細: プラットフォーム仕様とランタイム要件については、MCPB Manifest仕様 - 互換性を参照してください。