配高德官方 MCP 进 Cursor，官方快速接入页不长，真正容易卡住的是 Key 的平台选错，还有工具列表一直转圈、一调用就鉴权失败。
Key 这块别图省事。登录高德开放平台控制台，进「应用管理」新建应用，再「添加 Key」，表单里服务平台要选「Web 服务」。选成 Web 端、Android、小程序之类，后面请求很容易报 USERKEY_PLAT_NOMATCH，看着像 Key 写错，其实是绑定平台对不上，而且平台选完不能改，只能再新建一个 Key。复制时多了空格、Key 被删或过期，一般报 INVALID_USER_KEY。建 Key 说明：创建应用和 Key-MCP Server | 高德地图API
官方给了两种接入方式，文档里推荐 Streamable HTTP。配置写在项目级 .cursor/mcp.json，或者全局 ~/.cursor/mcp.json，两处会合并，同名时项目级优先。HTTP 方式示例：
{
"mcpServers": {
"amap-maps-streamableHTTP": {
"url": "https://mcp.amap.com/mcp?key=你的Key"
}
}
}
Cursor 的 mcp 文档还支持在 url、env 等字段里用 ${env:NAME} 这类插值，可以把 Key 放进本机环境变量，少把明文写进文件。不想走远程 URL，可以用本地 Node 包：command 为 npx，args 为 ["-y", "@amap/amap-maps-mcp-server"]，env 里设 AMAP_MAPS_API_KEY。官方提示 Node 最好 v22.14.0 及以上，并用 npm config get registry 确认镜像是默认源，镜像不对时 npx 拉包慢甚至失败。快速接入：快速接入-MCP Server | 高德地图API
保存后打开 Settings → Tools & MCP，看服务是否起来、工具有没有列出来。真正调用要切到 Agent；普通聊天模式不一定会主动去碰 MCP 工具。官方概述里列的能力有：地理编码、逆地理编码、关键词搜索、周边搜索、详情搜索，驾车 / 步行 / 骑行 / 公交路径规划，距离测量，天气查询，IP 定位，再加上生成专属地图、导航到目的地、打车这类唤端能力。实际对话里可以先让 Agent 做地理编码拿到坐标，再接着周边搜或路径规划，参数名跟概述表里的 address、location、origin、destination、keywords 对齐即可。概述页：概述-MCP Server | 高德地图API
日志里冒出 No server info，多半是 Cursor 在 initialize 阶段没拿到有效的 serverInfo，随后 ListOfferings 直接失败，面板上会一直 Loading tools。stdio 场景里常见情况是 npx 第一次下包超时、本机 Node 版本偏旧，或者进程把调试输出打到了 stdout，把 JSON-RPC 弄脏了。可以开 Output，选 MCP Logs，对照启动命令和 Client closed 的时间点。本地起不来时，先换成上面的 Streamable HTTP，把进程起不来和 Key 不对这两种情况分开；HTTP 方式正常而 stdio 一直失败，基本就能锁定本机 Node / npx 环境。
配额用完也会表现为调不通。日调用超了常见 DAILY_QUERY_OVER_LIMIT，一般次日自动恢复；单位时间过频是 ACCESS_TOO_FREQUENT 或各类 QPS 超限码，超出部分直接被拒。这些是账号额度问题，改 mcp.json 解决不了，只能去控制台看用量、把并发压下来，或按开放平台规则扩容。错误码表：错误码说明-实用工具-开发指南-Web服务 API | 高德地图API
调通之后也别急着把配置推仓库：URL query 里带 Key、env 写明文，都别提交。项目级配置要给同事用时，各人自己填 Key，别互相拷贝一整段带密钥的 json。