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