跳转到主要内容

在 Claude Desktop 上开始使用本地 MCP 服务器

超过 2 周前更新

Claude Desktop中的MCP目前是一个测试版功能。

模型上下文协议(MCP)是一个开放协议,能够实现LLM应用程序与外部数据源和工具之间的无缝集成。随着桌面扩展(DXT)的引入,安装和管理本地MCP服务器变得更加容易。

桌面扩展

桌面扩展提供了一种简化的方式,通过单击可安装的包来安装和管理本地MCP服务器。您现在可以像安装浏览器扩展一样轻松地在计算机上安装本地MCP服务器,而无需手动配置JSON文件和管理依赖项。

注意:我们正在构建一个桌面扩展目录——如果您是开发者,希望将您构建的扩展添加到目录中,请完成我们的桌面扩展兴趣表单,与我们分享更多信息。

安装桌面扩展

  1. 在Claude Desktop中导航到设置 > 扩展。

  2. 浏览扩展目录或从.dxt文件安装。

  3. 点击您想要的扩展上的"安装"。

  4. 通过用户友好的界面配置任何必需的设置(如API密钥)。

  5. 扩展将自动在您的对话中可用。

桌面扩展安装故障排除

扩展无法安装

  • 确保您运行的是最新版本的Claude Desktop。

  • 通过重新下载检查扩展文件是否损坏。

  • 验证您有足够的磁盘空间进行安装。

扩展显示已安装但工具不可用

  • 重启Claude Desktop以刷新扩展注册表。

  • 检查扩展的配置设置是否缺少必需字段。

  • 验证任何API密钥或身份验证凭据是否正确输入。

扩展配置问题

  • 导航到设置 > 扩展,点击扩展以查看其设置。

  • 确保所有必需的配置字段都已完成。

  • 检查文件路径(如果适用)是否指向您有权访问的现有目录。

权限或安全错误

  • 在macOS上,如果收到安全警告,请检查系统偏好设置 > 安全性与隐私。

  • 在Windows上,确保Claude Desktop具有访问所需目录的必要权限。

  • 对于企业环境,验证桌面扩展是否通过您组织的策略启用。

开发者常见问题

如何将现有的MCP服务器转换为DXT扩展?

  1. 在您的MCP服务器目录中添加一个包含所需元数据的manifest.json文件。

  2. 使用dxt pack命令打包它。

  3. 查看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注册表策略配置桌面扩展:

这是否解答了您的问题?