跳转到主要内容

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

一周前更新

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

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

桌面扩展

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

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

安装桌面扩展

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

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

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

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

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

在团队和企业计划中启用/禁用特定扩展

团队和企业组织的所有者和主要所有者可以管理哪些DXT为您的组织启用,并可通过Claude Desktop供其他成员访问。

  1. 打开Claude Desktop。

  2. 点击左下角的您的姓名首字母或姓名,然后点击"设置"。

  3. 桌面应用下点击"扩展"。

  4. 选择右上角的"组织扩展"选项卡。

  5. 在此页面上,点击您想要阻止组织成员访问的任何扩展旁边的"..." > "禁用"。

  6. 您还可以使用列表顶部的过滤器来仅查看已启用或已禁用的扩展。

注意:所有者启用或禁用扩展后,成员可能需要最多两小时才能在其账户中看到更改。

桌面扩展安装问题故障排除

扩展无法安装

  • 确保您运行的是最新版本的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上的钥匙串,Windows上的凭据管理器)自动加密这些值。

我可以私下分发我的DXT扩展吗?

是的,您可以直接与特定用户或团队共享.dxt文件。为了更广泛的分发,您可以将扩展提交到官方目录。

如何调试我的DXT扩展问题?

在Claude Desktop设置中启用调试日志记录,在扩展设置面板中检查扩展日志,并参考MCP调试指南进行协议特定的故障排除。

这是否解答了您的问题?