# 腾讯 WeData 指标语义层

通过企业元数据与语义层检索数据资产和查询业务数据。

- 类型：MCP
- 权限：只读查询
- 门槛：需授权账号、需 API Key、需申请开通
- 官方入口：https://cloud.tencent.com/developer/mcp/server/11763
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/tencent-wedata/

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

## 接入前准备

面向已有 WeData 业务数据和指标的账号；需要 SecretId/SecretKey、实际开通地域、WeData 权限及目标指标调用权限。MCP 的免费调用说明不等于底层 WeData 产品免费。

## 接入步骤

1. 确认密钥所属 UIN 已开通 WeData，并获准查询目标范围的指标；UIN 是账号要求，不要凭空增加 UIN 请求头。 [官方入口](https://cloud.tencent.com/document/product/1267/126220)
2. 从指标语义层文档选实际地域的服务 URL，保留 TENCENTCLOUD_SECRET_ID、TENCENTCLOUD_SECRET_KEY、TENCENTCLOUD_REGION 三个请求头；不要混用另一种 WeData Server 的端点及连字符请求头。 [官方入口](https://cloud.tencent.com/document/product/1267/126220)
3. 下方 URL 使用官方广州地域示例。若开通其他地域，URL 中的 ap-guangzhou 和 TENCENTCLOUD_REGION 必须一并替换为实际地域。 [官方入口](https://cloud.tencent.com/document/product/1267/126220)

## 验证方法

先列工具，再查询一个已授权的指标。地域、底层产品或指标权限缺失时会失败，不能把拿到密钥当作开通成功。

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

## 费用

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

## 安装配置

### JSON

```
{
  "mcpServers": {
    "tencent-wedata": {
      "type": "http",
      "url": "https://api-ap-guangzhou.wedata.cloud.tencent.com/api/mcp/v1/metric",
      "headers": {
        "TENCENTCLOUD_SECRET_ID": "${TENCENT_WEDATA_TENCENTCLOUD_SECRET_ID}",
        "TENCENTCLOUD_SECRET_KEY": "${TENCENT_WEDATA_TENCENTCLOUD_SECRET_KEY}",
        "TENCENTCLOUD_REGION": "${TENCENT_WEDATA_TENCENTCLOUD_REGION}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --header 'TENCENTCLOUD_SECRET_ID: ${TENCENT_WEDATA_TENCENTCLOUD_SECRET_ID}' --header 'TENCENTCLOUD_SECRET_KEY: ${TENCENT_WEDATA_TENCENTCLOUD_SECRET_KEY}' --header 'TENCENTCLOUD_REGION: ${TENCENT_WEDATA_TENCENTCLOUD_REGION}' --transport http 'tencent-wedata' 'https://api-ap-guangzhou.wedata.cloud.tencent.com/api/mcp/v1/metric'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.tencent-wedata]
url = "https://api-ap-guangzhou.wedata.cloud.tencent.com/api/mcp/v1/metric"

[mcp_servers.tencent-wedata.env_http_headers]
"TENCENTCLOUD_SECRET_ID" = "TENCENT_WEDATA_TENCENTCLOUD_SECRET_ID"
"TENCENTCLOUD_SECRET_KEY" = "TENCENT_WEDATA_TENCENTCLOUD_SECRET_KEY"
"TENCENTCLOUD_REGION" = "TENCENT_WEDATA_TENCENTCLOUD_REGION"
```

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

Codex 的 bearer_token_env_var 对应变量只填 Token，不带 Bearer；env_http_headers 对应变量提供完整请求头值。

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

## 核验与来源

2026-11-05 核对官方身份：[依据](https://cloud.tencent.com/document/product/1267/126220)。腾讯云 WeData 团队发布页确认 MCP 数据检索和查询；接入门槛与个人端点未整理，留空。

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

```
https://api-ap-guangzhou.wedata.cloud.tencent.com/api/mcp/v1/metric
```

- [厂商官方接入文档](https://cloud.tencent.com/document/product/1267/126220)
- [厂商官方发布依据](https://cloud.tencent.com/developer/mcp/server/11763)

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