WEIR
获取 API Key
语言English
主题

Dify MCP 配置教程：请求头、OAuth、SSE 和 Agent 工具

在 Dify 的“集成”里添加远程 MCP 服务：URL 为什么要以 /mcp 结尾，Bearer 请求头和 OAuth 怎么选，自部署时 CONSOLE_API_URL 的坑，附实测调用和费用。


发布于 · 更新于 · 阅读约 6 分钟 · Read in English

封面图：在 Dify 里做推特调研

Dify 从 v1.6.0 起原生支持 MCP：在“集成”里添加远程 MCP 服务，它的工具就能在 Agent 和工作流里用。

这篇教你接入 Weir，让 Dify 应用能搜索 X（推特），读推文、推文串和用户资料。Weir 只读，不会用你的账号发推。我们做的就是 Weir。

服务端点 URL：  https://api.weirapp.io/mcp
名称：          Weir
服务器标识符：  weir
请求头名称：    Authorization
请求头值：      Bearer weir_live_xxxxxxxx

Dify MCP 配置：五步添加 Weir

你需要 Dify 1.9.0 或更新的版本，这一版加入了自定义请求头。另外还要一个免费的 Weir 账号。

本文对照的是 2026 年 10 月 23 日发布的 Dify v1.18.0，读了它的文档和源码。

  1. 创建 key在 Weir 控制台的 API keys 页面新建一个。它以 weir_live_ 开头，只显示一次。
  2. 打开 MCP在 Dify 里打开“集成”，点“工具”分组里的 MCP，再点“添加 MCP 服务 (HTTP)”。
  3. 填写表单服务端点 URL 填 https://api.weirapp.io/mcp，名称填 Weir，服务器标识符填 weir。
  4. 添加请求头在“请求头”里添加 Authorization，值写 Bearer、一个空格，再接你的 key。
  5. 保存点“添加并授权”。Weir 的卡片上应该会列出它的工具。

URL 的结尾很关键。 Dify 只看路径的最后一段：/mcp 走 Streamable HTTP，/sse 走旧的 SSE 传输，其他结尾会先试 SSE。

标识符一次定好。 Dify 文档说，应用是靠标识符找到服务的；以后改了它，用到 Weir 的应用都会出错。它只能用小写字母、数字、下划线和连字符，最多 24 个字符。

请求头还是 OAuth：Dify MCP 该用哪种认证？

用请求头，除非你宁可在浏览器里登录，也不想粘贴 key。

方式 适用于 用 Weir 时
Authorization 请求头 Dify 云版和自部署版 扣 key 所属账号的积分
动态客户端注册 云版，HTTPS 或 localhost 扣登录者账号的积分
自己的 Client ID 不支持自动注册的服务器 用不上

两种别混用。 Dify 的源码只在请求头列表为空时，才把登录令牌加到工具调用上。多一个请求头，调用就不带令牌了。

Dify 会加密保存请求头的值，表单里也只显示掩码。

自部署的 Dify 能用 MCP 的 OAuth 吗？

能，但 Weir 接不接受，要看回调地址。

Dify 用动态客户端注册把自己登记为“Dify”。它要求 Weir 在登录后跳回 CONSOLE_API_URL 加 /console/api/mcp/oauth/callback。

  • Dify 云版没问题。 它的控制台跑在 HTTPS 上。
  • 默认的自部署 Dify 会失败。 Dify 的 docker/.env.example 把 CONSOLE_API_URL 留空，回调只剩一段路径，Weir 会返回 invalid_redirect_uri。
  • 改一行就好。 把 CONSOLE_API_URL 设成你的 HTTPS 地址，在自己电脑上就设成 http://localhost，然后重启。
  • 普通的局域网地址不行。 Weir 只接受 HTTPS 或本机的回调，所以 http://192.168.1.20 只能用请求头。

登录授权属于整个工作空间，而不是某个人：空间里每个人花的都是批准那个账号的积分。这个连接会以“Dify (MCP)”出现在该账号 Weir 控制台的 API keys 页。

Dify MCP 工具怎么在 Agent 和工作流里用？

Weir 的工具会和插件一起出现在 Dify 的工具选择器里，哪里能加工具，哪里就能加它。

  • Agent 节点。 在 Workflow 或 Chatflow 里加一个 Agent 节点，选经典 Agent 和“函数调用”策略，再添加 search_x。模型不支持原生工具调用时，改用 ReAct。
  • 工具节点。 用你设好的输入跑一个工具，不经过模型挑选。
  • Agent 应用。 Dify 新的 Agent（仍是 Beta）和旧版 Agent 应用都能用 Dify 工具，MCP 服务也在内。

固定的查询放进工具节点，比如每次都搜同一个账号的新推文，再交给下游的 LLM 节点总结。要让模型自己决定查什么，就用 Agent 节点。

在指令里写明工具名。Dify 文档说，这能帮模型选对工具。

Dify MCP 示例：@dify_ai 最近发了什么？

在 Agent 节点或 Agent 应用里问：

用 search_x 查一下：@dify_ai 在 X 上最新的一条推文是什么？跳过回复和转推。

模型应该调用 search_x。我们在 2026 年 10 月 24 日通过 Weir 的 MCP 服务器跑了这次调用：

→ search_x {"fromUsers": ["dify_ai"], "query": "-filter:nativeretweets",
            "onlyOriginal": true, "since": "2026-10-01T00:00:00Z", "limit": 1}
← 1 post · 2 credits (1 + 1 × 1) · nextCursor set
  Oct 16  7 likes  1,611 views  "Agent or Workflow? The answer depends on the job."

巧的是，Dify 这条推文讨论的正是上一节的选择：Agent 还是工作流，要看任务。-filter:nativeretweets 去掉转推，X 搜索默认会带上；onlyOriginal 去掉回复。

2积分：这次 1 条推文的搜索
11积分：一次搜 10 条推文
0积分：查用量的 get_usage
5,000每月免费积分

Weir 每次调用收 1 积分，每条 X 推文再收 1 积分，失败的调用不收费。截至 2026 年 10 月，积分包 $5（美元）起，含 25,000 积分，永不过期。各项单价见价格页（英文）。

Dify 也能当 MCP 服务器吗？

能。每个 Dify 应用都能把自己发布成 MCP 服务器：在应用的“访问入口”标签页找到“MCP 服务”卡片，它默认是关着的。

Dify 文档提醒，生成的地址里带着凭据，要像 API key 一样保管。这和本文方向相反：是别的客户端来调用你的 Dify 应用。

中文搜到的“dify mcp”教程，大多讲的是这个方向。

哪些地方我们还没测过？

我们没能在这里运行 Dify。本文来自 Dify 的文档和源码，外加一次通过 Weir MCP 服务器的真实调用。

  • Dify 对 Weir 的登录授权。 它的注册方式符合 Weir 的要求，但我们没有实际走完一遍。
  • Dify 里的请求头方案。 表单的填法是从 Dify 源码推出来的，没在运行中的 Dify 里保存过。

Dify MCP 连不上怎么办？

  • 加了 key，Dify 还让你授权。 说明 Weir 返回了 401。检查值是不是 Bearer weir_live_...，中间一个空格。
  • 登录卡在注册这一步。 检查 CONSOLE_API_URL，或者改用请求头。
  • 登录了，工具调用却失败。 删掉所有自定义请求头，让 Dify 带上登录令牌。
  • 工具返回 403。 key 有效但缺权限，比如建 key 时没勾 X。
  • 工具返回 402。 Weir 积分用完了，重试没用。

什么时候不适合用 Weir

  • 智能体要发推或私信。 Weir 只读。
  • 最在意单价。 截至 2026 年 10 月，TwitterAPI.io 标价每 1,000 条推文 $0.15，比我们 $5 积分包的单价低。
  • 你需要稳定保证。 Weir 没有获得 X 授权，也和 X 没有关联，访问方式可能会变。

常见问题

Dify 支持 stdio 方式的 MCP 服务器吗？

不支持。Dify 文档说，只支持 HTTP 传输的 MCP 服务器。本地的 stdio 服务器要先用桥接工具转成 HTTP。Weir 是远程服务，不需要这一步。

Dify 的 MCP 支持 SSE 吗？

支持。URL 以 /sse 结尾时，Dify 用旧的 SSE 传输；以 /mcp 结尾时用 Streamable HTTP。Weir 只提供 Streamable HTTP，所以地址要保持 /mcp 结尾。

Dify 的 MCP 工具在哪里？

在 Dify 1.18.0 里，打开“集成”，在“工具”分组里点 MCP。添加服务后，它的工具会出现在 Agent 节点、工具节点和 Agent 应用的工具选择器里。

Dify 哪个版本开始支持 MCP？

Dify 1.6.0，2025 年 7 月 10 日发布。按它的发布说明，MCP 是双向支持的，既能当客户端，也能当服务器。请求头方案要用的自定义请求头，是 1.9.0 加入的。

Dify 能通过 Weir 发推吗？

不能。Weir 只读公开的 X 数据，不能发推、点赞或关注。

参考来源

以下均于 2026 年 10 月 24 日查阅：

继续阅读