Claude Desktop中的MCP目前是一个测试版功能。
模型上下文协议(MCP)是一个开放协议,能够实现LLM应用程序与外部数据源和工具之间的无缝集成。随着桌面扩展(DXT)的引入,安装和管理本地MCP服务器变得更加容易。
桌面扩展
桌面扩展提供了一种简化的方式,通过单击可安装的包来安装和管理本地MCP服务器。您现在可以像安装浏览器扩展一样轻松地在计算机上安装本地MCP服务器,而无需手动配置JSON文件和管理依赖项。
注意:我们正在构建桌面扩展目录——如果您是开发者,希望将您构建的扩展添加到目录中,请完成我们的桌面扩展兴趣表单,与我们分享更多信息。
安装桌面扩展
在Claude Desktop中导航到设置 > 扩展。
浏览扩展目录或从.dxt文件安装。
点击您想要的扩展上的"安装"。
通过用户友好的界面配置任何必需的设置(如API密钥)。
扩展将自动在您的对话中可用。
在团队和企业计划中启用/禁用特定扩展
团队和企业组织的所有者和主要所有者可以管理哪些DXT为您的组织启用,并可通过Claude Desktop供其他成员访问。
打开Claude Desktop。
点击左下角的您的姓名首字母或姓名,然后点击"设置"。
在桌面应用下点击"扩展"。
选择右上角的"组织扩展"选项卡。
在此页面上,点击您想要阻止组织成员访问的任何扩展旁边的"..." > "禁用"。
您还可以使用列表顶部的过滤器来仅查看已启用或已禁用的扩展。
注意:所有者启用或禁用扩展后,成员可能需要最多两小时才能在其账户中看到更改。
桌面扩展安装问题故障排除
扩展无法安装
确保您运行的是最新版本的Claude Desktop。
通过重新下载检查扩展文件是否损坏。
验证您有足够的磁盘空间进行安装。
扩展显示已安装但工具不可用
重启Claude Desktop以刷新扩展注册表。
检查扩展的配置设置是否缺少必需字段。
验证任何API密钥或身份验证凭据是否输入正确。
扩展配置问题
导航到设置 > 扩展,点击扩展以查看其设置。
确保所有必需的配置字段都已完成。
检查文件路径(如适用)是否指向您有权访问的现有目录。
权限或安全错误
在macOS上,如果收到安全警告,请检查系统偏好设置 > 安全性与隐私。
在Windows上,确保Claude Desktop具有访问所需目录的必要权限。
对于企业环境,验证桌面扩展是否通过您组织的策略启用。
开发者常见问题
如何将现有的MCP服务器转换为DXT扩展?
在您的MCP服务器目录中添加一个包含所需元数据的manifest.json文件。
使用dxt pack命令打包。
查看DXT文档获取详细说明。
DXT扩展支持哪些编程语言?
DXT扩展支持Node.js、Python和二进制MCP服务器。Claude Desktop包含内置的Node.js环境,因此不需要安装Node.js。
如何处理API密钥等敏感配置?
在manifest.json中将配置字段标记为"sensitive": true。Claude Desktop将使用操作系统的安全存储(macOS上的钥匙串,Windows上的凭据管理器)自动加密这些值。
我可以私下分发我的DXT扩展吗?
是的,您可以直接与特定用户或团队共享.dxt文件。为了更广泛的分发,您可以将扩展提交到官方目录。
如何调试我的DXT扩展问题?
在Claude Desktop设置中启用调试日志记录,在扩展设置面板中检查扩展日志,并参考MCP调试指南进行协议特定的故障排除。