本指南將幫助您建立 MCP Bundle (.mcpb) 以建立桌面擴充功能，供內部使用、私人發佈，或作為提交至 Anthropic 連接器目錄的基礎。
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 網頁版、行動版和桌面版的發佈
需要跨所有使用者進行集中式更新的服務
需要伺服器端權杖管理的 OAuth 流程
由多個組織使用的面向公眾的整合
主要差異：MCPB 透過 stdio 傳輸在使用者的機器上執行，可存取本機和內部資源。遠端連接器在您的伺服器上透過 HTTPS 執行，並透過 Anthropic 的基礎設施進行存取。
實際應用：組織正在建立 MCPB 作為內部 MCP 伺服器的安全代理、用於內部文件存取，以及連接開發工具，同時維持其安全架構。
遠端連接器指南：請參閱 MCP 合作夥伴常見問題以取得完整的遠端連接器文件。
2. 開始使用
我應該使用哪種程式設計語言？
強烈建議使用 Node.js，原因如下：
隨 Claude macOS 和 Windows 版本一起提供 (使用者零安裝摩擦)
使用者無需單獨安裝執行時
與 Claude Desktop 的最佳相容性和可靠性
廣泛的 MCP SDK 支援
我應該支援哪些平台？
Claude Desktop 執行於：
macOS (darwin)
Windows (win32)
在 manifest.json 相容性部分中指定支援的平台。
最佳實踐：即使您主要在一個平台上開發，也應在兩個平台上進行測試。
平台相容性詳細資訊：請參閱 MCPB Manifest 規格 - 相容性以了解平台規格和執行時要求。
我如何建立我的第一個 MCPB？
遵循以下五個步驟的流程：
1. 安裝 MCPB CLI：npm install -g @anthropic-ai/mcpb
2. 建立您的 MCP 伺服器 (請參閱 MCP SDK)
3. 執行 mcpb init 以建立 manifest.json
4. 執行 mcpb pack 以進行捆綁
5. 在 Claude Desktop 中安裝並測試
如需詳細的實作指南：
如需有關開發、測試和最佳實踐的全面指南，請參閱 MCPB README 的「適用於 Bundle 開發人員」部分。
重要：在發佈您的 MCPB 之前，請查閱 MCPB README 中的測試和最佳實踐指南，以確保品質。
3. 設定
什麼是 manifest.json？
manifest.json 檔案是必需的中繼資料，描述您的 MCPB - 它的功能、如何執行、它提供哪些工具以及它需要什麼設定。
如需最新資訊，請參閱官方 MCPB 規格。
MCPB Manifest 規格 - 完整的架構及所有欄位
範例 Manifest - 實際實作
CLI 文件 - 命令參考
我如何新增圖示？
圖示是可選的，但建議用於專業外觀。
基本方法：在您的 bundle 根目錄中包含 icon.png 檔案，並在 manifest.json 中參考它。
要求：
檔案名稱：icon.png (或自訂路徑)
大小：建議 512×512px (最小 256×256px)
格式：支援透明度的 PNG
位置：Bundle 根目錄或指定的路徑
進階選項：多個圖示變體，用於不同的大小和主題 (淺色/深色模式支援)。
實作詳細資訊：請參閱 MCPB Manifest 規格 - 圖示以了解：
圖示欄位設定
多個圖示變體語法
大小和主題規格
最佳實踐和要求
使用者如何設定我的 MCPB？
在 manifest.json 中定義 user_config 部分。Claude Desktop 會自動建立設定 UI，使用者可在其中設定您的擴充功能。
請參閱 MCPB Manifest 規格 - 使用者設定以了解完整實作：
完整的架構和範例
所有設定類型和屬性
驗證限制
敏感資料處理
多選模式
使用者如何安裝我的 MCPB？
有三種不同的安裝方法：
雙擊 - 下載 .mcpb 檔案並雙擊開啟
拖放 - 將 .mcpb 檔案拖放到 Claude Desktop 視窗中
檔案功能表 - 開發人員 → 擴充功能 → 安裝擴充功能 → 選擇 .mcpb 檔案
所有方法都會開啟安裝 UI，使用者可在其中：
檢視擴充功能詳細資訊和權限
設定必需的設定
授予必要的權限
完成安裝
安裝範圍：按使用者安裝 - 每個使用者必須在其自己的系統上單獨安裝。
使用者體驗和管理員控制：如需有關最終使用者安裝體驗和企業管理員控制 (包括 Team/Enterprise 組織管理和原則設定) 的詳細資訊，請參閱：
Claude Desktop 上的本機 MCP 伺服器入門 - 完整的使用者指南，涵蓋目錄瀏覽、安裝 UI、疑難排解和管理員控制。
4. 資源
官方文件
MCPB 框架：
MCPB 儲存庫 - 完整規格和工具
MCPB Manifest 規格 - 完整的 manifest 架構
MCPB CLI 文件 - 命令列工具參考
MCPB 範例 - 參考實作
MCP 協議：
MCP 規格 - 協議文件
MCP 快速入門 - 入門指南
TypeScript SDK - Node.js 實作
Python SDK - Python 實作
Claude Desktop：
取得協助
支援管道：
MCPB GitHub Issues - 錯誤報告和功能要求
MCP 規格 - 協議問題
Claude 支援 - 一般 Claude Desktop 支援
社群資源：
檢查儲存庫討論以了解社群問答
關注版本資訊以了解最新更新
檢視範例以了解實作模式
準備好進行公開發佈？
如果您已建立可運作的 MCPB 並想將其提交至 Anthropic 目錄以進行更廣泛的發佈和發現，請參閱我們的配套指南：提交至 Anthropic 目錄。
目錄指南涵蓋其他要求，包括：
所有工具的強制工具註解
隱私政策要求
最少三個工作範例
測試認證 (如適用)
完整的提交流程和審查時間表