Claude Desktop中的MCP目前是一个测试版功能。
模型上下文协议(MCP)是一个开放协议,能够实现LLM应用程序与外部数据源和工具之间的无缝集成。随着桌面扩展(DXT)的引入,安装和管理本地MCP服务器变得更加容易。
桌面扩展
桌面扩展提供了一种简化的方式,通过单击可安装的包来安装和管理本地MCP服务器。您现在可以像安装浏览器扩展一样轻松地在计算机上安装本地MCP服务器,而无需手动配置JSON文件和管理依赖项。
注意:我们正在构建一个桌面扩展目录——如果您是开发者,希望将您构建的扩展添加到目录中,请完成我们的桌面扩展兴趣表单,与我们分享更多信息。
安装桌面扩展
在Claude Desktop中导航到设置 > 扩展。
浏览扩展目录或从.dxt文件安装。
点击您想要的扩展上的"安装"。
通过用户友好的界面配置任何必需的设置(如API密钥)。
扩展将自动在您的对话中可用。
桌面扩展安装故障排除
扩展无法安装
确保您运行的是最新版本的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上的Keychain,Windows上的凭据管理器)自动加密这些值。
我可以私下分发我的DXT扩展吗?
是的,您可以直接与特定用户或团队共享.dxt文件。为了更广泛的分发,您可以将扩展提交到官方目录。
如何调试我的DXT扩展问题?
在Claude Desktop设置中启用调试日志记录,在扩展设置面板中检查扩展日志,并参考MCP调试指南进行协议特定的故障排除。
当我的扩展需要更新时会发生什么?
来自官方目录的扩展默认自动更新。对于私下分发的扩展,用户需要手动安装更新的.dxt文件。
企业策略控制
企业管理员可以通过系统策略控制桌面扩展:
macOS企业配置
通过位于以下位置的属性列表文件配置桌面扩展
~/Library/Preferences/com.anthropic.Claude.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>isDxtEnabled</key>
<true/>
<key>isDxtDirectoryEnabled</key>
<false/>
<key>isDxtSignatureRequired</key>
<true/>
<key>isLocalDevMcpEnabled</key>
<true/>
</dict>
</plist>
Windows企业配置
通过位于HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Claude或HKEY_CURRENT_USER\SOFTWARE\Policies\Claude
的Windows注册表策略配置桌面扩展: