跳至主要內容

在 Claude Desktop 上開始使用本地 MCP 伺服器

一週前已更新

模型上下文協議 (MCP) 是一個開放協議,可實現 LLM 應用程式與外部資料來源和工具的無縫整合。隨著桌面擴充功能的推出,安裝和管理本機 MCP 伺服器變得明顯更加容易。

桌面擴充功能

桌面擴充功能提供了一種簡化的方式來透過單鍵可安裝套件安裝和管理本機 MCP 伺服器。您無需手動設定 JSON 檔案和管理相依性,現在可以像安裝瀏覽器擴充功能一樣輕鬆地在電腦上安裝本機 MCP 伺服器。

注意:我們正在建立桌面擴充功能目錄 – 如果您是希望將您建立的擴充功能新增到目錄的開發人員,請填寫我們的桌面擴充功能興趣表單與我們分享更多資訊。

從目錄安裝桌面擴充功能

  1. 在 Claude Desktop 上導覽至「設定」>「擴充功能」。

  2. 按一下「瀏覽擴充功能」以檢視我們的目錄,並按一下您想使用的任何 Anthropic 審核工具。按一下所需擴充功能上的「安裝」。

  3. 透過使用者友善的介面設定任何必要的設定(例如 API 金鑰)。

  4. 該擴充功能將自動在您的對話中可用。

安裝自訂桌面擴充功能

  1. 在 Claude Desktop 上導覽至「設定」>「擴充功能」。

  2. 按一下「進階設定」並找到擴充功能開發人員部分。

  3. 按一下「安裝擴充功能…」

  4. 選擇 .mcpb 檔案並按照提示進行安裝。

桌面擴充功能的管理員控制

Team 和 Enterprise 方案的擁有者和主要擁有者可以使用兩個控制項來管理團隊對桌面擴充功能的存取:

  1. 根據您組織的安全標準啟用或停用公開桌面擴充功能。

  2. 上傳自訂桌面擴充功能,並使其可供您的團隊進行單鍵安裝。

這些控制項允許組織透過僅新增團隊需要存取的擴充功能並移除任何其他擴充功能來完全自訂其登錄。

在 Team 和 Enterprise 方案上啟用/停用特定擴充功能

Team 和 Enterprise 組織的擁有者和主要擁有者可以管理為您的組織啟用哪些桌面擴充功能,以及其他成員可透過 Claude Desktop 存取的擴充功能。請參閱啟用和使用桌面擴充功能允許清單

以取得具體說明。

為您的組織建立和上傳自訂擴充功能

自訂桌面擴充功能上傳允許 Team 和 Enterprise 方案利用公開目錄中不可用的組織特定工作流程。建立自訂桌面擴充功能後,擁有者和主要擁有者可以在 Claude Desktop 中導覽至「設定」>「擴充功能」並按一下「進階設定」以存取擴充功能開發人員部分:

按一下「安裝擴充功能…」並選擇 .mcpb 檔案。按照提示安裝和設定您的自訂桌面擴充功能。如需更深入的資訊,請參閱我們的桌面擴充功能開發人員文件

Enterprise 原則控制

注意:使用者機器層級的 Enterprise 原則控制將覆蓋任何應用程式內控制(封鎖清單和允許清單)。如果您想使用應用程式內控制,請確保 isDesktopExtensionEnabledisDesktopExtensionDirectoryEnabled 未設定為「false」,以便允許清單可以填入可用的登錄。

如需透過系統原則控制桌面擴充功能,請參閱我們的桌面 Enterprise 設定文件

桌面擴充功能安裝問題疑難排解

擴充功能無法安裝

  • 確保您執行的是最新版本的 Claude Desktop。

  • 透過重新下載擴充功能檔案來檢查該檔案是否損毀。

  • 驗證您有足夠的磁碟空間進行安裝。

擴充功能顯示已安裝但工具不可用

  • 重新啟動 Claude Desktop 以重新整理擴充功能登錄。

  • 檢查擴充功能的設定設定是否有遺漏的必要欄位。

  • 驗證任何 API 金鑰或驗證認證是否輸入正確。

擴充功能設定問題

  • 導覽至「設定」>「擴充功能」並按一下擴充功能以檢視其設定。

  • 確保所有必要的設定欄位都已完成。

  • 檢查檔案路徑(如適用)是否指向您有存取權限的現有目錄。

權限或安全性錯誤

  • 在 macOS 上,如果您收到安全性警告,請檢查「系統偏好設定」>「安全性與隱私」。

  • 在 Windows 上,確保 Claude Desktop 具有存取必要目錄的必要權限。

  • 對於 Enterprise 環境,驗證桌面擴充功能是否透過您組織的原則啟用。

開發人員常見問題

我如何檢查我的 MCP 伺服器是否在 Claude Desktop 中正確連接?

按一下 Claude Desktop 內聊天框底部的「+」按鈕,然後選擇「連接器」。這將顯示您連接的 MCP 伺服器及其工具。或者,您可以造訪開發人員設定(在桌面應用程式下)以查看連接狀態並查看任何 MCP 伺服器的日誌。

我如何將現有的 MCP 伺服器轉換為桌面擴充功能?

  1. 將 manifest.json 檔案新增到您的 MCP 伺服器目錄,其中包含必要的中繼資料。

  2. 使用 mcpb pack 命令進行封裝。

  3. 請參閱MCPB 文件以取得詳細說明。

桌面擴充功能支援哪些程式設計語言?

桌面擴充功能支援 Node.js、Python 和二進位 MCP 伺服器。Claude Desktop 包含內建的 Node.js 環境,因此不需要安裝 Node.js。

我如何處理敏感設定(例如 API 金鑰)?

在您的 manifest.json 中將設定欄位標記為「sensitive」: true。Claude Desktop 將自動使用作業系統的安全儲存體(macOS 上的 Keychain、Windows 上的認證管理員)加密這些值。

我可以私下發佈我的自訂桌面擴充功能嗎?

是的,您可以直接與特定使用者或團隊共享 .mcpb 檔案。如需更廣泛的發佈,您可以將擴充功能提交到官方目錄。

我如何偵錯我的桌面擴充功能的問題?

在 Claude Desktop 設定中啟用偵錯日誌,檢查「擴充功能設定」面板中的擴充功能日誌,並參閱 MCP 偵錯指南以取得協議特定的疑難排解。

當我的擴充功能需要更新時會發生什麼?

來自官方目錄的擴充功能預設會自動更新。對於私下發佈的擴充功能,使用者需要手動安裝更新的 .mcpb 檔案。

有興趣深入瞭解 MCP 嗎?

如需有關建立您自己的 MCP 用戶端和伺服器的更深入資訊,我們建議檢視以下資源:

如果您需要進一步的指導,請造訪我們的如何取得支援指南以取得其他支援選項。

是否回答了您的問題?