DIFY 1.7.2的MCP製作與發佈

2026/01/07 更新2026/01/07 發佈閱讀 5 分鐘

在 Dify 1.7.2中，製作與發佈 MCP（Model Context Protocol）主要分為兩個方向：「將 Dify 應用發佈為 MCP Server」（讓 Claude/Cursor 呼叫 Dify）以及 「在 Dify 中整合外部 MCP 工具」。

以下是針對 Dify 1.7.2 進行MCP的詳細執行步驟(其他版本雷同，亦可參考)：

一、將 Dify 應用發佈為 MCP Server（對外發佈）

這可以讓你寫好的 Dify 工作流（Workflow）或 Agent，直接變成一個標準的 MCP 接口，供 Cursor 或 Claude Desktop 使用(只是舉例應用，其他服務都可以盡情地使用)。

進入應用編輯頁面：
在 Dify 中打開你想要發佈的「工作流」或「聊天助手」。

開啟 MCP Server 功能：
點擊上方導覽列的「發布 (Publish)」。
在下拉選單中找到「MCP 伺服器 (MCP Server)」選項並點擊切換為開啟。

配置參數與描述（關鍵步驟）：

啟用開關：切換為開啟狀態。

服務描述 (Description)：用自然語言描述這個工具的作用（例如：「這是一個能查詢內部數據庫並產出報表的工具」）。這能幫助外部 AI 判定何時該呼叫它。

變數說明：在「開始」節點設定的變數（如 query），務必填寫詳細的說明文字，否則外部 AI 可能會傳入錯誤格式。

獲取 URL：

系統會生成一組唯一的 MCP Server URL。這組 URL 包含認證資訊，請妥善保存（等同於 API Key）。

測試: 在外部工具中使用（以 Cursor 為例）：

在 Cursor 的設定中，找到 MCP 設定區塊。

新增一個伺服器，類型選擇 URL（或 SSE），貼上剛才從 Dify 複製的網址即可。

{
  "mcpServers": {
    "Dify-Tools": {
      "type": "sse",
      "url": "你的Dify連結"
    }
  }
}

二、在 Dify 中新增外部 MCP 工具（對內整合）

如果你想讓 Dify 的 Agent 可以使用外部開發者做好的 MCP 工具（例如 Notion、GitHub 的 MCP），請按照以下步驟：

進入工具管理：
在 Dify 主頁面點擊左側導覽列的「工具 (Tools)」。

新增 MCP 伺服器：
點擊「新增 MCP 伺服器 (Add MCP Server)」按鈕

Server URL：填入外部 MCP 服務的 HTTP 地址（目前 Dify 僅支援基於 HTTP/SSE 的 MCP，不支援本地 stdio 模式）。
名稱與識別碼：自定義一個好辨認的名字。

授權與啟用：
如果該 MCP 需要 API Key 或 OAuth，依提示完成授權。
完成後，你可以在 Dify 的 Agent 或工作流中，像使用內建工具一樣選用這些 MCP 工具。

已授權成功

三、 1.7.2 版本特別注意事項

超時問題 (Timeout)：根據社群回報，Dify 1.7.2 的 MCP 工具調用有預設的超時限制（約 1 秒），且目前無法直接在 UI 中修改。如果你的工作流處理時間很長，可能會遇到超時錯誤。
開源插件方案：除了官方內建功能，你也可以透過 Dify 的 插件市場 下載 mcp-server 插件來進行更進階的配置，例如手動定義 App Input Schema (JSON 格式) 。
私有化部署：如果你是使用 Docker 部署，請確保 FORCE_VERIFYING_SIGNATURE 等環境變數配置正確，以避免安裝第三方 MCP 插件時出現簽名錯誤。