# Cursor 接高德 MCP，工具绿了调接口还是 INVALID\_USER\_KEY

**URL:** <https://www.shiqidu.com/t/topic/1804>\
**Category:** 问题求助\
**Tags:** AICoding, 问与答, Cursor\
**Created:** [2026 年10 月 27 日 02:53 UTC](https://www.shiqidu.com/t/topic/1804 "2026-10-27T02:53:39Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年10 月 27 日 02:53 UTC](https://www.shiqidu.com/t/topic/1804/1 "2026-10-27T02:53:39Z")

</div>

配高德官方 MCP 进 Cursor，官方快速接入页不长，真正容易卡住的是 Key 的平台选错，还有工具列表一直转圈、一调用就鉴权失败。

Key 这块别图省事。登录高德开放平台控制台，进「应用管理」新建应用，再「添加 Key」，表单里服务平台要选「Web 服务」。选成 Web 端、Android、小程序之类，后面请求很容易报 USERKEY\_PLAT\_NOMATCH，看着像 Key 写错，其实是绑定平台对不上，而且平台选完不能改，只能再新建一个 Key。复制时多了空格、Key 被删或过期，一般报 INVALID\_USER\_KEY。建 Key 说明：[创建应用和 Key-MCP Server | 高德地图API](https://developer.amap.com/api/mcp-server/create-project-and-key)

官方给了两种接入方式，文档里推荐 Streamable HTTP。配置写在项目级 `.cursor/mcp.json`，或者全局 `~/.cursor/mcp.json`，两处会合并，同名时项目级优先。HTTP 方式示例：

```json
{
  "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](https://developer.amap.com/api/mcp-server/gettingstarted)

保存后打开 Settings → Tools & MCP，看服务是否起来、工具有没有列出来。真正调用要切到 Agent；普通聊天模式不一定会主动去碰 MCP 工具。官方概述里列的能力有：地理编码、逆地理编码、关键词搜索、周边搜索、详情搜索，驾车 / 步行 / 骑行 / 公交路径规划，距离测量，天气查询，IP 定位，再加上生成专属地图、导航到目的地、打车这类唤端能力。实际对话里可以先让 Agent 做地理编码拿到坐标，再接着周边搜或路径规划，参数名跟概述表里的 address、location、origin、destination、keywords 对齐即可。概述页：[概述-MCP Server | 高德地图API](https://developer.amap.com/api/mcp-server/summary)

日志里冒出 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](https://developer.amap.com/api/webservice/guide/tools/info/)

调通之后也别急着把配置推仓库：URL query 里带 Key、env 写明文，都别提交。项目级配置要给同事用时，各人自己填 Key，别互相拷贝一整段带密钥的 json。