1. 為什么要在 Dify 里接一個(gè) 12306 查詢工具如果你正在用 Dify 搭出行助手大概率會(huì)遇到一個(gè)尷尬模型能聊火車票但真問「明天福州到蘭州有哪些車次」它只能憑記憶編車次號(hào)、發(fā)到時(shí)間、余票全是幻覺。原因很簡(jiǎn)單大模型本身沒有實(shí)時(shí)數(shù)據(jù)源它需要外部工具。這里有兩個(gè)概念要先分清楚。Function Calling 是模型廠商給的「表達(dá)能力」模型自己解析意圖、生成調(diào)用指令格式各家不同OpenAI、Qwen 的響應(yīng)結(jié)構(gòu)都有差異。MCPModel Context Protocol是「連接規(guī)則」用 JSON-RPC 2.0 把工具交互標(biāo)準(zhǔn)化任何支持 MCP 的客戶端都能接同一套服務(wù)不綁死某一家模型。一句話Function Calling 讓模型知道「何時(shí)調(diào)用工具」MCP 解決「如何安全高效地調(diào)用工具」。Dify 通過 MCP 插件把這兩者串起來插件負(fù)責(zé)和 MCP 服務(wù)通信模型只負(fù)責(zé)決定調(diào)哪個(gè)工具、傳什么參數(shù)。這篇就按「裝插件 → 拿 12306 MCP 配置 → 建 Agent → 真實(shí)查一次車次」的順序走一遍鏈路跑通后你就能把同樣的骨架換成機(jī)票、酒店、天氣等任意 MCP 服務(wù)。適合誰看已經(jīng)會(huì)用 Dify 建 Agent 或工作流、想給應(yīng)用加實(shí)時(shí)數(shù)據(jù)能力的開發(fā)者對(duì) MCP 只聽過名字、想找個(gè)具體場(chǎng)景上手的人。全程不需要你寫后端服務(wù)配置為主。2. 前置準(zhǔn)備Dify 的 MCP 插件與 TaoToken 模型接入動(dòng)手前先把兩件事備齊Dify 側(cè)能裝插件模型側(cè)能穩(wěn)定調(diào)用支持 Function Calling 的模型。Dify 這邊進(jìn)入 Marketplace 搜索 MCP安裝MCP SEE插件有的版本顯示為 MCP SSE / MCP Client認(rèn)準(zhǔn)能配置 SSE 地址的那個(gè)。裝完在插件列表里能看到它后面 Agent 添加工具時(shí)會(huì)用到。模型這邊Agent 要跑 Function Calling模型必須原生支持工具調(diào)用。我實(shí)測(cè)下來 Qwen 系列里 72b 和 32b 表現(xiàn)穩(wěn)定30b 那檔在 MCP 多輪調(diào)用上容易掉鏈子后面第 5 節(jié)會(huì)具體說。如果你本地沒有合適的模型服務(wù)可以用 TaoToken 統(tǒng)一接入它兼容 OpenAI 風(fēng)格的接口Dify 里填 Base URL 和 Key 就能用。TaoToken 的 API 地址是https://taotoken.net/api模型對(duì)話、Coding Plan、控制臺(tái)、API Keys 這些入口都在官網(wǎng)能找到官網(wǎng)入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址https://taotoken.net/api在 Dify 的「設(shè)置 → 模型供應(yīng)商」里選 OpenAI 兼容類型Base URL 填上面的 API 地址Key 從控制臺(tái)生成。生成 Key 的頁(yè)面在這里API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果你打算長(zhǎng)期跑編碼類 Agent、頻繁調(diào)用工具可以看下 Coding Plan額度模型更適合這種多輪工具調(diào)用場(chǎng)景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite模型接好后在 Dify 里先建一個(gè)空白 Agent 試一句普通對(duì)話確認(rèn)模型通了再往下接 MCP。這一步別省否則后面報(bào)錯(cuò)你分不清是模型問題還是 MCP 配置問題。3. 可復(fù)制的 12306 MCP 服務(wù)配置骨架MCP 服務(wù)從哪來兩個(gè)常用來源魔搭社區(qū) MCP 廣場(chǎng)https://modelscope.cn/mcp和智譜的搜索 MCP 頁(yè)面。在廣場(chǎng)里搜 12306能找到現(xiàn)成的火車票查詢 MCP 服務(wù)點(diǎn)進(jìn)去一般會(huì)給你一段配置形如{ mcpServers: { 12306-mcp: { url: https://example-mcp-host/sse, type: sse } } }注意廣場(chǎng)給的原始配置字段名不一定和 Dify 插件對(duì)得上。Dify 的 MCP 插件通常要的是「服務(wù)名 SSE 地址」這種更扁平的結(jié)構(gòu)所以要做一次改造。把上面的配置改成插件能識(shí)別的樣子{ mcpServers: { 12306: { transport: sse, url: https://example-mcp-host/sse } } }關(guān)鍵字段說明用表格對(duì)照一下更清楚字段作用常見坑mcpServers頂層容器可放多個(gè)服務(wù)名字寫錯(cuò)插件直接讀不到服務(wù)名如12306工具前綴Agent 里顯示為12306.xxx含空格或中文可能解析失敗transport/type傳輸方式SSE 場(chǎng)景填sse填成stdio會(huì)連不上遠(yuǎn)程urlMCP 服務(wù)的 SSE 端點(diǎn)少寫/sse路徑會(huì) 404把改造后的 JSON 復(fù)制進(jìn) Dify 的 MCP 插件配置框保存。保存成功后插件一般會(huì)顯示已連接的服務(wù)數(shù)量如果顯示 0 或者報(bào)連接超時(shí)先檢查 url 是否可訪問、transport 是否寫對(duì)。注意MCP 服務(wù)地址請(qǐng)以你實(shí)際獲取到的為準(zhǔn)上面example-mcp-host只是占位。不要把它當(dāng)成固定地址直接抄。配置保存后回到 Agent 編輯頁(yè)在「工具」里添加 MCP 相關(guān)工具。Dify 的 MCP 插件一般會(huì)暴露三個(gè)工具獲取 MCP 工具列表、調(diào)用 MCP 工具加上系統(tǒng)自帶的當(dāng)前時(shí)間。這三個(gè)是后面 Agent 能查車次的最小集合。4. 建 Agent 并跑通一次真實(shí)車次查詢新建一個(gè) Agent 應(yīng)用模型先選 Qwen2.5-72b溫度設(shè) 0減少隨機(jī)性。提示詞這樣寫你叫火車俠是 12306-MCP 專屬 AI 助理專注鐵路出行服務(wù)。 調(diào)用 MCP 工具時(shí)先獲取工具列表再選擇 12306 相關(guān)工具來回答。 你需要先了解本 MCP 每個(gè)工具的參數(shù)含義再發(fā)起調(diào)用。 用戶查詢車票、規(guī)劃行程時(shí)給出車次、發(fā)到時(shí)間、歷時(shí)和余票的最優(yōu)推薦。工具勾選當(dāng)前時(shí)間、獲取 MCP 工具列表、調(diào)用 MCP 工具。然后發(fā)一句真實(shí)查詢「明天從福州到蘭州的火車」。正常鏈路是這樣的模型先調(diào)「獲取 MCP 工具列表」拿到 12306 服務(wù)下有哪些方法比如按站站查詢、按車次查詢?cè)僬{(diào)「調(diào)用 MCP 工具」傳入出發(fā)站、到達(dá)站、日期參數(shù)MCP 服務(wù)返回車次列表模型整理成自然語(yǔ)言。一次成功的返回大概長(zhǎng)這樣車次信息以實(shí)際查詢?yōu)闇?zhǔn)明天福州到蘭州方向?yàn)槟阏业揭韵萝嚧?G1902 福州 08:12 發(fā)車蘭州西 20:35 到達(dá)歷時(shí)約 12 小時(shí) 23 分二等座有票 Z126 福州 11:05 發(fā)車蘭州 次日 14:20 到達(dá)歷時(shí)約 27 小時(shí)硬臥有票 ...看到車次號(hào)、發(fā)到時(shí)間、余票這些字段被正確填出來說明 MCP 鏈路通了。如果模型只回「我無法查詢實(shí)時(shí)車次」多半是工具沒勾上或者模型沒觸發(fā) Function Calling。再換兩個(gè)模型對(duì)比一下這一步很關(guān)鍵。用 Qwen2.5-32b 問「后天從鎮(zhèn)江到定西的火車余票」通常也能正常調(diào)用。但換成 Qwen3-30b 問同樣的問題我實(shí)測(cè)下來它經(jīng)常不觸發(fā) MCP 調(diào)用直接憑記憶編答案或者只調(diào)了「獲取工具列表」就停住不再往下調(diào)「調(diào)用 MCP 工具」。溫度設(shè) 0 也一樣屬于模型對(duì)多輪工具調(diào)用的支持不足不是配置問題。所以選型建議優(yōu)先 Qwen2.5-72b其次 Qwen2.5-32b30b 這檔在 MCP 場(chǎng)景先別用。如果你用 TaoToken 接入可以在模型對(duì)話頁(yè)先單獨(dú)測(cè)一下模型的工具調(diào)用能力確認(rèn)它支持再放進(jìn) Agent模型對(duì)話https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite5. 本篇常見報(bào)錯(cuò)與排查清單接 MCP 最容易卡在幾個(gè)固定位置按下面順序排查基本能覆蓋九成問題。插件保存后服務(wù)數(shù)為 0。先確認(rèn) url 能訪問瀏覽器直接打開 SSE 地址看有沒有響應(yīng)再確認(rèn)transport字段是sse不是stdio最后檢查 JSON 有沒有多余逗號(hào)Dify 的配置框?qū)Ω袷胶苊舾?。Agent 不調(diào)用 MCP 工具。三個(gè)原因工具沒勾選、模型不支持 Function Calling、提示詞沒引導(dǎo)。先確認(rèn)「獲取 MCP 工具列表」和「調(diào)用 MCP 工具」都勾了再換 Qwen2.5-72b 試提示詞里明確寫「先獲取工具列表再調(diào)用」別指望模型自己猜。調(diào)用了工具但返回空。多半是參數(shù)名對(duì)不上。MCP 工具對(duì)出發(fā)站、到達(dá)站、日期的字段名有固定要求讓模型先調(diào)「獲取工具列表」看清參數(shù)定義再傳值。日期格式也要注意有的服務(wù)要YYYY-MM-DD有的要時(shí)間戳。模型編造車次。這是最危險(xiǎn)的說明它沒真調(diào)工具。把溫度降到 0提示詞里加一句「所有車次信息必須來自 MCP 工具返回不得憑記憶回答」。如果還編就是模型工具調(diào)用能力不行換模型。多輪對(duì)話后工具失效。MCP 支持持續(xù)上下文但 Dify 的會(huì)話記憶和 MCP 上下文是兩套東西。長(zhǎng)對(duì)話里如果工具突然不響應(yīng)開個(gè)新會(huì)話重試或者檢查插件連接是否超時(shí)斷開。提示排查時(shí)把 Dify 的日志級(jí)別調(diào)高能看到模型實(shí)際發(fā)出的工具調(diào)用請(qǐng)求和 MCP 返回的原始 JSON比猜快得多。6. 把骨架復(fù)用到其他 MCP 服務(wù)12306 只是驗(yàn)證鏈路的一個(gè)例子。這套「裝 MCP 插件 → 改造配置 → 建 Agent → 勾三個(gè)工具」的骨架換成天氣、航班、地圖任何 MCP 服務(wù)都能用區(qū)別只在服務(wù)名和參數(shù)。如果你要長(zhǎng)期跑這類 Agent、頻繁做工具調(diào)用建議把模型接入統(tǒng)一到 TaoToken省得每個(gè)應(yīng)用單獨(dú)配 Key。接入文檔在這里里面有 Dify、LangChain 等常見客戶端的配置示例接入文檔https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后留一個(gè)我踩過的坑MCP 服務(wù)名別用中文或帶空格Agent 里工具會(huì)顯示成服務(wù)名.方法名名字不規(guī)范時(shí)模型容易解析錯(cuò)。用12306、weather這種純英文短名最穩(wěn)。鏈路跑通后先拿一個(gè)簡(jiǎn)單查詢壓測(cè)幾次確認(rèn)穩(wěn)定了再往工作流里接。