# 腾讯地图

地点搜索、路线规划与位置服务。

- 类型：MCP
- 权限：只读查询
- 门槛：需 API Key
- 官方入口：https://lbs.qq.com/service/MCPServer/MCPServerGuide/overview
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/tencent-map/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。

## 接入前准备

需要腾讯位置服务账号，创建 Key 并开通 WebServiceAPI 与相应调用配额。

## 接入步骤

1. 按腾讯位置服务指南创建 Key，选择 Streamable HTTP 地址并在本地填写。 [官方入口](https://lbs.qq.com/service/MCPServer/MCPServerGuide/userGuide)

## 验证方法

连接后用公开地点做一次只读搜索并核对结果。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://lbs.qq.com/service/MCPServer/MCPServerGuide/userGuide)（核对日期：2026-11-05）

## 安装配置

### 官方服务端点

按用途选择端点，分别核对官方认证方式、地域及权限要求。

- Streamable HTTP：https://mcp.map.qq.com/mcp?key=<你的腾讯位置服务Key>&format=0 — Streamable HTTP；需要启用 WebService API 的位置服务 Key
- SSE：https://mcp.map.qq.com/sse?key=<你的腾讯位置服务Key> — SSE 传输；需要启用 WebService API 的位置服务 Key，Codex 远程配置不支持 SSE

### JSON

```
{
  "mcpServers": {
    "tencent-map": {
      "type": "http",
      "url": "https://mcp.map.qq.com/mcp?key=${TENCENT_MAP_KEY}&format=0"
    }
  }
}
```

### Claude Code

```
claude mcp add --transport http 'tencent-map' 'https://mcp.map.qq.com/mcp?key=${TENCENT_MAP_KEY}&format=0'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.tencent-map]
url = "https://mcp.map.qq.com/mcp?key=<你的腾讯位置服务Key>&format=0"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://lbs.qq.com/service/MCPServer/MCPServerGuide/userGuide)。官方接入说明明确 WebServiceAPI Key 和 Streamable HTTP 端点。

官方原文摘录（2026-11-05，来自上述依据）：

```
https://mcp.map.qq.com/mcp?key=
```


[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)
