1. 为什么要在 Dify 里接高德 MCP 做 Agent如果你正在用 Dify 搭智能体又想让 Agent 真正“理解地理位置”高德 MCP 是最省事的路径之一。它把地理编码、路径规划、POI 搜索、天气查询这些能力封装成标准化工具Dify 的 Agent 节点可以直接调用不需要你手写 SDK 封装。出行规划场景里用户一句“明天九点从公司去机场顺路买束花”Agent 就能拆成出发时间计算、路线规划、花店搜索、停车建议几个工具调用工厂调度场景里“把 A 仓的物料送到 B 厂避开拥堵”也能自动落到路径重规划和地理围栏监控上。但真正动手时很多人卡在同一个地方Key 太分散。高德一个 Key、模型服务一个 Key、Cline 或 CC Switch 里再配一套改一次配置要翻四五个文件调试时根本分不清是哪个 Key 失效。这篇就按“统一 Key 可复制配置 连通性验证”的思路把 Dify 高德 MCP 的出行与调度双场景一次跑通。TaoToken 在这里的角色是统一模型侧入口你可以在一个地方管理模型调用 Key再把它分发到 Dify、Cline、CC Switch 等工具里减少配置漂移。2. TaoToken 前置统一 Key 与模型入口TaoToken 的定位是模型 API 聚合与统一 Key 管理。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM。你注册后先在控制台创建 API Key后面 Dify 的模型供应商、Cline 的模型配置、CC Switch 的 profile 都指向同一个 Key这样模型侧只有一处需要维护。具体操作路径进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面新建一个 Key复制保存。如果你要验证模型对话是否通可以直接用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 发一条测试消息。长期做编码或 Agent 开发建议看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置格式以文档为准。注意高德 MCP 的 Key 和 TaoToken 的 Key 是两套东西。高德 Key 用于地图服务TaoToken Key 用于模型调用。本文说的“统一 Key”是指模型侧统一不是把两个 Key 合并。3. 可复制配置settings.json / config.toml / CC Switch / Cline先给一份模型侧的统一配置骨架。不同工具读取的文件名不同但核心都是 base_url api_key model 三要素。3.1 settings.json 骨架适用于 Cline 等{ llm: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-20250514 }, mcpServers: { amap-amap-sse: { url: https://mcp.amap.com/sse?key你的高德Web服务Key } } }这里把模型侧和高德 MCP 放在同一个文件里改 Key 时只动两处。Cline 的 MCP 配置如果单独有面板把mcpServers那段贴进去即可。3.2 config.toml 骨架适用于 CC Switch 等[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 [mcp.amap] url https://mcp.amap.com/sse?key你的高德Web服务KeyCC Switch 的 profile 切换逻辑是读 config.toml 里的 model 段你可以在不同 profile 里复用同一个 TaoToken Key只改 model 名做对比测试。3.3 Dify 里的模型供应商配置Dify 的模型供应商选 OpenAI-API-compatibleBase URL 填https://taotoken.net/apiAPI Key 填 TaoToken Key模型名按文档填。这样 Dify 的 Agent 节点调用模型时走统一入口高德 MCP 则通过 Agent 的 MCP 服务配置单独接入。3.4 高德 MCP 在 Dify Agent 里的配置在 Dify 创建 Agent 应用后找到 MCP 服务配置区域填入{ amap-amap-sse: { url: https://mcp.amap.com/sse?key你的高德Web服务Key } }外层花括号不能省否则解析会报错。高德 Key 的获取路径是登录高德开放平台控制台进入应用管理创建新应用添加 Key 时服务平台选 Web 服务创建后拿到 Key。4. 验证请求出行规划与工厂调度双场景跑通配置写完必须验证否则你分不清是模型不通还是 MCP 不通。分两步走。4.1 先验证模型侧用 curl 直接打 TaoToken 的 APIcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}] }返回里有choices字段且内容正常说明模型侧通了。如果 401检查 Key 是否复制完整如果 404检查 base_url 是否多了或少了/v1以接入文档为准。4.2 再验证高德 MCP 工具链在 Dify Agent 里发一条出行规划指令从重庆市江北区大石坝地铁站到重庆市江北区鲤鱼池地铁站给我三条公交或轨道方案。Agent 应该调用高德 MCP 的公交路径规划工具返回三条路线。如果只返回文字没有工具调用说明 MCP 没挂上如果报 URL 错误检查mcp.amap.com/sse后面的 key 参数是否拼错。工厂调度场景换一条指令A 仓在重庆市江北区B 厂在渝北区现在要送一批物料避开拥堵给我一条推荐路线和预计时间。Agent 会调用驾车路径规划返回路线和耗时。两个场景都通说明工具链完整。4.3 成功结果长什么样模型侧返回 JSON 里有正常 contentDify 侧能看到 Agent 的思考过程里出现工具调用记录比如amap-amap-sse被调用参数是起点终点最终输出里有具体路线名、耗时、距离。如果工具调用记录为空但输出看似合理很可能是模型在“编”这时候要回去检查 MCP 是否真的连上。5. 本篇常见错排查清单错误一Dify 里 MCP 配置报 JSON 解析失败。最常见原因是外层花括号漏了或者 key 名写成了amap而不是amap-amap-sse。把配置贴到 JSON 校验工具里过一遍。错误二模型调用返回 401。TaoToken Key 复制时带了空格或者用了高德 Key 去调模型。两套 Key 分开存命名上区分开。错误三高德 MCP 返回“INVALID_USER_KEY”。高德 Key 创建时服务平台没选 Web 服务或者 Key 被删除。回控制台确认。错误四Agent 不调用工具直接编答案。Dify 的 Agent 策略里工具没启用或者模型不支持 function calling。换一个支持工具调用的模型名再试。错误五Cline 里配置改了不生效。settings.json 有缓存重启 Cline 或重新加载窗口。CC Switch 则要确认当前激活的 profile 是改过的那个。错误六路径规划返回空。起点终点格式不对高德 MCP 通常要求“城市具体地址”或经纬度。先用简单地址测试比如“重庆市江北区大石坝”。错误七响应特别慢。多工具串行调用会慢可以在 Dify 里把不相关的工具关掉只留路径规划和 POI 搜索。如果长期高频用考虑 Coding Plan 的额度方案。6. 接入与排障入口模型侧统一 Key 的创建在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 配置格式和参数说明看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。验证模型是否通用模型对话 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 发一条消息最快。如果你要长期跑编码类 AgentCoding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 的额度更合适。Claude Code 相关接入参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后补一个实操细节Dify 里搭完 Agent 后先把高德 MCP 的三个核心工具公交路径规划、驾车路径规划、周边搜索单独测一遍再串成完整流程。我试过先测天气再测路径结果天气工具正常但路径工具 Key 权限不够排查了半天才发现是高德 Key 的服务平台选错了。所以分工具验证比端到端验证更容易定位问题。