把 Dify 应用发布成 MCP 服务

这篇适合谁

适合已经在 Dify 里做好应用、想让 Claude Desktop 或 Cursor 这类 AI 助手直接调用它的人。读完你能在 Dify 里为应用开启 MCP 服务、拿到它的服务器地址，并把地址接进 Claude Desktop 或 Cursor。

MCP 服务是什么

MCP（Model Context Protocol，模型上下文协议）是让 AI 助手连接外部工具的开放标准。Dify 支持把一个应用发布成 MCP 服务器，接入之后，Claude Desktop 等 AI 助手和 Cursor 等开发环境就能直接和这个 Dify 应用交互，效果如同它们自带的原生扩展^[1]。

这个方向和 Dify 内部的用法是反过来的。Dify 工作流和 Agent 也可以调用 MCP 工具，那是另一套配置，在工作区的工具页面里有 MCP 部分的说明^[1]。

MCP 服务是按应用开启的，每个应用各有一个服务器地址，所以要接入的应用需要逐个开启、逐个配置^[1]。开启前可以先想清楚，这个应用要暴露给外部工具什么能力，因为工具和参数的描述会直接影响模型怎么调用它。

第一步：在 Dify 里开启 MCP 服务

打开应用，进入访问入口标签页，找到MCP 服务卡片。这个功能默认是关闭的，需要手动打开^[1]。

开启后，Dify 会为该应用生成一个唯一的 MCP 服务器地址，外部工具通过这个地址连接应用^[1]。

这个地址里包含身份验证凭据，要像对待 API 密钥一样保管。如果怀疑它已经泄露，就用重新生成按钮换一个新地址，旧地址会立即失效^[1]。

第二步：接入 Claude Desktop

把应用接到 Claude Desktop，需要添加一个 Claude 集成。在 Claude 中依次进入 Profile > Settings > Integrations > Add integration，然后把集成的 URL 替换成 Dify 应用的服务器地址^[1]。

第三步：接入 Cursor

Cursor 的做法是在项目根目录下创建或编辑 .cursor/mcp.json 文件，内容大致如下，把 URL 换成 Dify 应用的 MCP 服务器地址即可^[1]：

{
  "mcpServers": {
    "your-server-name": {
      "url": "your-server-url"
    }
  }
}

Cursor 会自动识别这份配置，把 Dify 应用作为工具提供给模型^[1]。想接入多个 Dify 应用，就在 mcpServers 对象里再加几项^[1]。

排查时可以按这个顺序来：先确认地址是重新生成之后的最新地址，再检查工具描述是否具体，最后才看应用本身的响应速度^[1]。MCP 服务器地址包含凭据，妥善保管它，也就是保护你的应用不被他人随意调用^[1]。

常见问题

工具描述写得不清楚怎么办？ AI 靠描述来理解工具和参数，所以描述要具体。与其写「输入数据」，不如写明「包含用户资料的 JSON 对象，必需字段：姓名、邮箱、偏好设置」^[1]。

应用响应慢怎么办？ MCP 只负责通信层，应用本身的性能仍然决定体验。如果应用通常要 30 秒才能处理完一个请求，客户端里的用户会明显感觉到等待。可以加进度提示，或者把复杂的工作流拆成更小、更快的操作^[1]。

换了地址之后为什么连不上？ 重新生成之后，旧地址立即失效，所以 Claude Desktop 里的集成和 .cursor/mcp.json 里的地址都要一起更新^[1]。

下一步

想让 Dify 工作流或 Agent 反过来调用 MCP 工具，去看工作区工具页面中的 MCP 部分^[1]。

本文改编自 Dify 文档中的「MCP 服务器」页面^[1]，原文以 CC BY 4.0 许可证发布。