跳转到主要内容

在桌面版 Claude 上开始使用模型上下文协议 (MCP)

超过 2 周前更新

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

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

桌面扩展

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

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

安装桌面扩展

  1. 在Claude桌面版中导航到设置 > 扩展

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

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

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

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

桌面扩展安装故障排除

扩展无法安装

  • 确保您运行的是最新版本的Claude桌面版

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

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

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

  • 重启Claude桌面版以刷新扩展注册表

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

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

扩展配置问题

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

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

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

权限或安全错误

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

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

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

开发者常见问题

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

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

  2. 使用dxt pack命令打包

  3. 查看DXT文档获取详细说明

DXT扩展支持哪些编程语言?

DXT扩展支持Node.js、Python和二进制MCP服务器。Claude桌面版包含内置的Node.js环境,因此不需要安装Node.js。

如何处理API密钥等敏感配置?

在您的manifest.json中将配置字段标记为"sensitive": true。Claude桌面版将使用操作系统的安全存储(macOS上的钥匙串,Windows上的凭据管理器)自动加密这些值。

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

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

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

在Claude桌面版设置中启用调试日志记录,在扩展设置面板中检查扩展日志,并参考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>dxtRegistry</key>    <string>https://registry.example.com</string></dict></plist>

Windows企业配置

通过位于HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Claude或HKEY_CURRENT_USER\SOFTWARE\Policies\Claude的Windows注册表策

这是否解答了您的问题?