模型上下文协议 (MCP) 是一个开放协议，可实现 LLM 应用程序与外部数据源和工具之间的无缝集成。随着桌面扩展的推出，安装和管理本地 MCP 服务器变得显著更容易。
桌面扩展
桌面扩展提供了一种简化的方式来通过单击可安装的软件包来安装和管理本地 MCP 服务器。您无需手动配置 JSON 文件和管理依赖项，现在可以像安装浏览器扩展一样轻松地在计算机上安装本地 MCP 服务器。
注意：我们正在构建桌面扩展目录 – 如果您是希望将构建的扩展添加到目录的开发者，请填写我们的桌面扩展兴趣表与我们分享更多信息。
从目录安装桌面扩展
在 Claude Desktop 上导航到"设置">"扩展"。
点击"浏览扩展"查看我们的目录，并点击您想使用的任何 Anthropic 审核的工具。点击所需扩展上的"安装"。
通过用户友好的界面配置任何必需的设置（如 API 密钥）。
该扩展将自动在您的对话中可用。
安装自定义桌面扩展
在 Claude Desktop 上导航到"设置">"扩展"。
点击"高级设置"并找到扩展开发者部分。
点击"安装扩展…"
选择 .mcpb 文件并按照提示进行安装。
桌面扩展的管理员控制
团队和企业计划的所有者和主要所有者可以使用两个控制来管理团队对桌面扩展的访问：
根据您组织的安全标准启用或禁用公共桌面扩展。
上传自定义桌面扩展，使您的团队可以一键安装。
这些控制允许组织通过仅添加团队需要访问的扩展并删除其他扩展来完全自定义其注册表。
在团队和企业计划上启用/禁用特定扩展
团队和企业组织的所有者和主要所有者可以管理为您的组织启用哪些桌面扩展，以及其他成员可以通过 Claude Desktop 访问哪些扩展。请参阅启用和使用桌面扩展允许列表
了解具体说明。
为您的组织创建和上传自定义扩展
自定义桌面扩展上传允许团队和企业计划利用公共目录中不可用的组织特定工作流。创建自定义桌面扩展后，所有者和主要所有者可以在 Claude Desktop 中导航到"设置">"扩展"，然后点击"高级设置"以访问扩展开发者部分：
点击
企业策略控制
注意：用户机器级别的企业策略控制将覆盖任何应用内控制（黑名单和白名单）。如果您想使用应用内控制，请确保 isDesktopExtensionEnabled 和 isDesktopExtensionDirectoryEnabled 未设置为"false"，以便白名单可以填充可用注册表。
有关通过系统策略控制桌面扩展的信息，请参阅我们的桌面企业配置文档。
排查桌面扩展安装问题
扩展无法安装
确保您运行的是最新版本的 Claude Desktop。
通过重新下载扩展文件来检查该文件是否损坏。
验证您有足够的磁盘空间进行安装。
扩展显示已安装但工具不可用
重启 Claude Desktop 以刷新扩展注册表。
检查扩展的配置设置是否缺少必需的字段。
验证任何 API 密钥或身份验证凭据是否输入正确。
扩展配置问题
导航到"设置">"扩展"，然后点击扩展以查看其设置。
确保所有必需的配置字段都已完成。
检查文件路径（如适用）是否指向您有权访问的现有目录。
权限或安全错误
在 macOS 上，如果您收到安全警告，请检查"系统偏好设置">"安全和隐私"。
在 Windows 和 Linux 上，确保 Claude Desktop 具有访问所需目录的必要权限。
对于企业环境，请验证通过您组织的策略启用了桌面扩展。
开发者常见问题
如何检查我的 MCP 服务器是否在 Claude Desktop 中正确连接？
点击 Claude Desktop 中聊天框底部的"+"按钮，然后选择"连接器"。这将显示您连接的 MCP 服务器及其工具。或者，您可以访问开发者设置（在桌面应用下）以查看连接状态并查看任何 MCP 服务器的日志。
如何将我现有的 MCP 服务器转换为桌面扩展？
将 manifest.json 文件添加到您的 MCP 服务器目录中，其中包含所需的元数据。
使用
mcpb pack命令进行打包。有关详细说明，请参阅MCPB 文档。
桌面扩展支持哪些编程语言？
桌面扩展支持 Node.js、Python 和二进制 MCP 服务器。Claude Desktop 包含内置的 Node.js 环境，因此不需要安装 Node.js。
如何处理 API 密钥等敏感配置？
在 manifest.json 中将配置字段标记为"sensitive": true。Claude Desktop 将使用操作系统的安全存储自动加密这些值（macOS 上的 Keychain、Windows 上的凭据管理器和 Linux 上的发行版密钥链管理器）。
我可以私下分发我的自定义桌面扩展吗？
是的，您可以直接与特定用户或团队共享 .mcpb 文件。为了更广泛的分发，您可以将扩展提交到官方目录。
如何调试我的桌面扩展的问题？
在 Claude Desktop 设置中启用调试日志，检查"扩展"设置面板中的扩展日志，并参考 MCP 调试指南以获取特定于协议的故障排除。
当我的扩展需要更新时会发生什么？
来自官方目录的扩展默认自动更新。对于私下分发的扩展，用户需要手动安装更新的 .mcpb 文件。
有兴趣了解更多关于 MCP 的信息吗？
有关构建您自己的 MCP 客户端和服务器的更深入信息，我们建议查看以下资源：
MCP 快速入门指南 - 一个分步教程，非常适合开始基本的 MCP 集成。
模型上下文协议 Github - 包含完整的技术文档、代码示例和实现指南。
MCP 集成调试指南 - 常见实现挑战的故障排除提示和解决方案。
如果您需要进一步的指导，请访问我们的如何获得支持指南以获取其他支持选项。