1. 为什么要在 1Panel + MaxKB 里把高德地图 MCP 端点改到 TaoToken
高德地图 MCP Server 能做什么？简单说，它把地理编码、周边搜索、路径规划、POI 检索这些能力封装成标准 MCP 工具，让 MaxKB 里的 AI 对话节点可以直接调用。适合谁？适合已经在 1Panel 面板里跑着 MaxKB、想给知识库问答加上"地图查询"这类实时工具能力的开发者。
但实际部署时，很多人会卡在同一个地方：高德地图的 Key 直接写进 MCP Server 环境变量，MaxKB 侧再配一次模型 Key，多个工具各管各的鉴权，一旦要换通道或者统一管理，就得挨个改配置。我试过把高德 MCP 的调用端点统一收敛到 TaoToken 通道，好处是 Key 集中、鉴权链路清晰、后续换模型或加工具不用动 MCP Server 本身。
这篇要解决的问题很具体：在 1Panel 里部署好 MaxKB 之后，怎么把高德地图 MCP Server 的调用端点改到 TaoToken，让 MaxKB 通过统一的 Base URL 和 Key 去访问，而不是散落在各个环境变量里。核心检索词就是"1Panel MaxKB 高德地图 MCP Server 配置"和"MCP 端点改到 TaoToken"。
整个链路分三层：1Panel 负责容器编排和 MCP Server 发布，MaxKB 负责高级编排里挂 MCP 工具节点，TaoToken 负责提供统一的 API 入口和鉴权。你不需要改高德地图 MCP Server 的源码，只需要在 1Panel 的环境变量和 MaxKB 的 MCP 工具配置里，把 URL 和 Key 指向 TaoToken 的地址即可。
下面按"原问题场景 → TaoToken 前置 → 可复制配置 → 验证请求 → 错排查 → CTA"的顺序展开，每一步都给可复制的片段，你跟着改就行。
2. TaoToken 前置准备：Base URL、API Key 与模型 ID 三件套
在动 1Panel 和 MaxKB 之前，先把 TaoToken 侧的三件套准备好。这三件套是后面所有配置的基础，缺一个都会导致 401 或者连接失败。
第一件是 Base URL。TaoToken 的 API 入口是https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 OpenAI 兼容接口的 base 使用。如果你用的是 Claude Code 或者 Anthropic 风格的调用，deeplink 走https://taotoken.net/api下的对应路径即可。
第二件是 API Key。登录 TaoToken 控制台，在 API Keys 页面创建一个新的 Key。创建时建议按用途命名，比如maxkb-amap-mcp，方便后面排查是哪个 Key 出的问题。Key 只在创建时显示一次，复制后先存到安全的地方。
第三件是 Model ID。MaxKB 的 AI 对话节点需要指定模型，TaoToken 支持多种模型，你在模型对话页面可以先试跑一下，确认哪个模型 ID 可用。常见的比如gpt-4o、claude-3-5-sonnet这类，具体以控制台模型列表为准。
注意：Base URL 和 API Key 是两回事，Base URL 是通道地址，API Key 是身份凭证。很多人把两者搞混，在 MCP 配置里只填了 Key 没填对 URL，结果一直报 local proxy failed。
拿到三件套后，先在本地用 curl 验证一下通道是否通：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o", "messages": [{"role": "user", "content": "ping"}] }'如果返回里有choices字段，说明通道正常。这一步过了，再去改 1Panel 和 MaxKB，能省掉很多来回排查的时间。
3. 可复制配置：1Panel 环境变量与 MaxKB MCP 工具片段
这一节是全文的核心，给的都是可以直接复制粘贴的片段。分两部分：1Panel 侧的环境变量和 MCP Server 发布配置，MaxKB 侧的 MCP 工具 JSON 配置。
3.1 1Panel 侧：MCP Server 环境变量
在 1Panel 的 MCP 菜单里创建 MCP Server 时，环境变量区域填入以下内容。这里的关键是把高德地图的 Key 和 TaoToken 的通道信息分开管理，高德 Key 仍然用于高德 API 本身，TaoToken 的 Base URL 和 Key 用于 MaxKB 调用 MCP 时的鉴权。
AMAP_MAPS_API_KEY=你的高德地图Key TAOTOKEN_BASE_URL=https://taotoken.net/api TAOTOKEN_API_KEY=sk-你的TaoTokenKey MCP_TRANSPORT=sse MCP_PORT=8080如果你用的是 1Panel 的"导入 MCP Server 配置"功能，把上面这段直接粘进去，然后手动替换AMAP_MAPS_API_KEY和TAOTOKEN_API_KEY两个值。端口按你实际想用的填，比如 8080，记得在 1Panel 里打开端口外部访问。
3.2 MaxKB 侧：MCP 工具 JSON 配置
进入 MaxKB 的高级编排，添加 MCP 工具节点，在配置框里填入：
{ "amap-maps": { "url": "http://你的1Panel服务器IP:8080/amap-mcp", "transport": "sse", "headers": { "Authorization": "Bearer sk-你的TaoTokenKey" } } }这里的url指向 1Panel 里发布的 MCP Server 外部访问地址，transport固定sse，headers里带上 TaoToken 的 Key。这样 MaxKB 调用 MCP 工具时，请求会先经过 TaoToken 通道做鉴权，再转发到高德 MCP Server。
3.3 三件套对照表
| 配置项 | 值 | 出现位置 |
|---|---|---|
| Base URL | https://taotoken.net/api | 1Panel 环境变量、MaxKB 模型配置 |
| API Key | sk-你的TaoTokenKey | 1Panel 环境变量、MaxKB MCP headers |
| Model ID | gpt-4o或控制台可用模型 | MaxKB AI 对话节点 |
提示：如果你在 MaxKB 里同时配了模型和 MCP 工具，确保两处的 Base URL 和 Key 一致，否则会出现模型能通但 MCP 工具 401 的情况。
配置保存后，回到 1Panel 确认 MCP Server 状态是"运行中"，端口外部访问已打开。然后去 MaxKB 的 MCP 工具节点点"获取工具"，下拉框里应该能看到高德地图相关的工具列表，比如maps_geo、maps_around_search、maps_search_detail等。
4. 验证请求：一次地图查询确认 MCP 调用链路正常
配置改完不算完，得实际跑一次请求确认链路通。这一节用两个测试用例，从 MaxKB 的调试窗口发起，看返回结果是否符合预期。
4.1 测试一：周边餐饮查询
在 MaxKB 高级编排里，AI 对话节点的提示词可以写成：
你是一个地图助手，用户问周边餐饮时，调用 amap-maps 的 maps_around_search 工具， 参数 keywords 填"餐厅"，location 填用户给的地点，radius 填 1000。然后调试窗口输入："上海市兆丰环球大厦附近有什么地方可以吃饭？"
预期返回：工具调用日志里能看到maps_around_search被触发，返回结果包含若干餐厅名称、地址、距离。如果返回的是空列表或者报错，先检查location参数格式，高德要求是"经度,纬度"的字符串。
4.2 测试二：办公楼租赁搜索
第二个用例更贴近实际业务："搜索上海市宜山路地铁站哪里有空置的办公楼可以租赁？"
这个查询会触发maps_search_detail或者maps_around_search，取决于你的工具选择。返回结果里应该有办公楼名称、地址、可能还有联系方式。如果工具没被触发，检查 MaxKB 的 MCP 工具节点是否真的"获取工具"成功，下拉框里有没有选中对应工具。
4.3 看日志确认链路
最直接的验证方式是看 1Panel 里 MCP Server 的容器日志。正常调用时，日志里会打印请求进来的 URL、鉴权头、以及转发到高德 API 的响应状态码。如果看到401，说明 TaoToken Key 没配对；如果看到local proxy failed，说明 Base URL 写错了或者网络不通。
# 在 1Panel 终端里查看 MCP Server 日志 docker logs -f 你的mcp容器名日志里出现200和高德返回的 JSON 数据，就说明整条链路通了：MaxKB → TaoToken 通道 → 高德 MCP Server → 高德 API。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
配置过程中最容易踩的坑就那几个，这一节按真实报错对照排查。
5.1 401 Unauthorized
报错原文：{"error": {"message": "Invalid API key", "type": "invalid_request_error"}}
原因通常是 TaoToken Key 没填对，或者填到了错误的位置。检查两处：1Panel 环境变量里的TAOTOKEN_API_KEY，以及 MaxKB MCP 工具 JSON 里的headers.Authorization。两处必须一致，且 Key 没有多余空格。
5.2 local proxy failed
报错原文：local proxy failed: dial tcp: lookup taotoken.net: no such host
这是 Base URL 写错或者 DNS 解析失败。确认TAOTOKEN_BASE_URL填的是https://taotoken.net/api，不要多写路径，也不要少写https。如果服务器 DNS 有问题，可以在 1Panel 的容器网络设置里指定 DNS。
5.3 reading choices 相关报错
报错原文：json: cannot unmarshal ... reading 'choices'
这个通常出现在 MaxKB 的 AI 对话节点，说明模型返回的格式和 MaxKB 预期的不一致。检查 Model ID 是否在 TaoToken 控制台的可用列表里，以及 Base URL 是否指向了正确的 API 路径。有时候把https://taotoken.net/api误写成https://taotoken.net/api/v1会导致路径重复。
5.4 OAuth 相关报错
报错原文：OAuth token exchange failed或invalid_client
如果你在 MCP 配置里启用了 OAuth 而 TaoToken 通道用的是 API Key 鉴权，两者会冲突。解决办法是关掉 MCP Server 的 OAuth 选项，统一用 Bearer Token。在 1Panel 的 MCP Server 配置里，把认证方式改成"API Key"或"None + Header 透传"。
5.5 工具列表为空
点"获取工具"后下拉框是空的，说明 MaxKB 没能从 MCP Server 拉到工具列表。检查 1Panel 里 MCP Server 的 SSE 路径是否正确，以及端口外部访问是否真的打开。可以用 curl 直接测 SSE 端点：
curl -N http://你的IP:8080/amap-mcp如果连不上，说明 1Panel 的网络配置有问题，跟 TaoToken 无关。
6. 长期编码与 Agent 场景：把 TaoToken 通道固定下来
如果你只是临时跑一次地图查询，上面的配置够用了。但如果你打算把 MaxKB 当成长期的 Agent 编排平台，建议把 TaoToken 通道固定成默认配置，避免每次加工具都重新填 Key。
具体做法是在 1Panel 里把TAOTOKEN_BASE_URL和TAOTOKEN_API_KEY设成全局环境变量，MaxKB 的每个 MCP 工具节点都引用这两个变量，而不是硬编码。这样换 Key 或者换通道时，只改一处，所有工具节点自动生效。
对于长期编码和 Agent 场景，TaoToken 的 Coding Plan 更适合，因为它针对高频调用做了通道优化。你可以在控制台里把 Coding Plan 的 Key 单独拿出来，配到 MaxKB 的模型节点上，MCP 工具节点继续用普通 API Key，两者分开管理。
最后一步，回到 MaxKB 的调试窗口，再跑一次"上海市宜山路地铁站附近办公楼"的查询，确认返回结果里包含具体的办公楼名称和地址。如果这次返回正常，说明整条链路已经稳定，你可以把这个编排保存成模板，后面加其他 MCP 工具时直接复制节点改配置就行。
