数据开发治理平台 WeData MCP Server

一、1. 使用场景

协议：MCP（Model Context Protocol），传输方式 Streamable HTTP，服务由 WeData 平台托管，无需本地安装。

目前，WeData MCP Server 把 WeData 的元数据查询 和 数据探索（SQL 执行） 能力封装成一组标准 MCP 工具。配置完成后，你只需要在 AI 客户端里用自然语言提问，模型会自动编排工具调用，典型链路：

查项目 → 查数据源 → 查库 → 查表 → 查字段 → 提交 SQL → 轮询结果

适用场景举例：

·「我有哪些 WeData 项目？这个项目下有哪些数据源？」

·「某数据源的某张表有哪些字段、哪些是分区字段？」

·「帮我跑一条 SQL，统计每个城市单日销量超过 1000 的日期」

·「先建库建表，再插几条数据，然后统计一下」

二、2. 前置条件

三、3.1 获取密钥

有两种密钥获取方式，用户可以根据自己的场景选择其中某一种：

四、3.1.1 长期 AKSK 方式

在腾讯云 CAM 控制台创建 API 密钥，得到 SecretId 与 SecretKey。

注意：安全提示：密钥等同于你的账号身份，只保存在本地 mcp.json 或环境变量中，不要写入代码仓库、不要粘贴到对话/文档/工单中。

五、3.1.2 entraId 方式

通过 entraId 登录后，在如下页面获取访问凭证：

六、3.2 在客户端添加 MCP 配置

打开客户端的 MCP 配置文件（CodeBuddy 中通过「配置 → MCP 设置 → 配置 MCP」打开 mcp.json），加入以下内容：

{ "mcpServers": { "WeData-MCP-Server": { "url": "https://mcp.wedata.cloud.tencent.com/mcp/wedata/v1/all", "timeout": 20000, "transportType": "streamable-http", "headers": { "TENCENTCLOUD-SECRET-ID": "<你的 SecretId>", "TENCENTCLOUD-SECRET-KEY": "<你的 SecretKey>", "TOKEN": "<只有entraId方式需要配置，获取方式见3.1.2>", "TENCENTCLOUD-REGION": "ap-guangzhou" }, "disabled": false } }}

字段说明：

七、3.3 用 TOOL-SCOPE 控制工具范围（可选）

在 headers 中增加 TOOL-SCOPE 可只加载需要的工具，减少模型选择干扰：

"TOOL-SCOPE": "data_assets"

多个范围用英文逗号分隔：

"TOOL-SCOPE": "data_assets, data_analysis"

注意：取值范围以服务端当前支持的能力域为准（已见 data_assets、data_analysis 等），填错或拼写不一致会导致工具无法加载。若不确定，建议先不配置，默认加载全部工具。

八、3.4 验证连接

保存配置后回到客户端，看到 WeData-MCP-Server 状态为已连接、并能列出工具清单，即配置成功。随后直接对话即可：帮我查一下我有哪些 wedata 项目

九、4. 支持工具

十、5.1 元数据探索

prompt：帮我查一下我有哪些 wedata 项目：

prompt：帮我看下「项目名称」项目下我有哪些 wedata 数据源：

prompt：帮我查询下「项目名称」项目下，「数据源名称」 这个数据源下面有哪些表：

十一、5.2 执行一条 SQL

1. 先让模型拿到必要参数（也可由你直接给出）：

prompt：帮我查一下项目 「项目名称」 下有哪些调度资源组。

2. 提交 SQL：

prompt：

参数如下，帮我执行一下这个 SQL：show databases

ProjectId：「项目 ID」

DatasourceId：「数据源 ID」

ExecutorGroupId：「调度资源组 ID」

3. 拿结果：模型会用返回的 JobId 调用 poll_sql_result 轮询，直到状态变为 SUCCESS，再把结果整理给你。若模型没有自动轮询，可以追问：

prompt：

查询任务 「JobId」 的执行结果。

关键参数示例：

{ "ProjectId": "项目ID", "ScriptContent": "show databases;", "ScriptConfig": { "DatasourceId": "数据源ID", "ExecutorGroupId": "调度资源组ID", }}

十二、5.3 端到端场景

prompt：

在 「数据源名称」 这个数据源下面帮我创建一个商品销售的库，并在库下面创建 3 张表，

分别是成都、北京、上海三个城市每天销售商品数量和收入：

prompt：向这三张表里各插入几条测试数据：

prompt：

在「项目名称」项目下的 「数据源名称」数据源下，用 「计算资源名称」 计算资源、

ExecutorGroupId 「调度资源组 ID」，统计商品销售库中每个城市单日销量超过 1000 的具体日期。

十三、6. 注意事项

1. SQL 是异步执行的：execute_sql 只负责提交，返回 JobId；提交后用 poll_sql_result 轮询，直到状态为 SUCCESS / FAILED / TERMINATED / CANCELED。

2. 多语句会拆成多个子执行：SQL 用 ; 分隔时，每条语句产生一个子执行；poll_sql_result 不传 JobExecutionId 会按顺序返回全部子执行结果，传了则只返回指定子执行。

3. 结果有截断与时效：预览行数受「项目管理 – 数据分析配置 – 预览行数限制」约束，总量不超过 10MB，超出时 Truncated=true；结果只保留有限时间，过期会返回 ResourceNotFound.ResultExpired，需要重跑 SQL。

4. 返回值均为字符串：预览结果底层是 CSV，无类型信息。

5. 参数必须配套：DatasourceId 必须属于传入的 ProjectId，否则报 InvalidParameter；ExecutorGroupId 必须是该项目下可用的 Schedule 类型资源组（可用 list_resource_groups 查询）。

6. 权限：你只能访问该密钥对应账号有权限的项目、数据源和表；看不到某张表通常是权限或元数据可见范围问题，请先在数据地图/数据安全侧确认权限。

7. 写操作需谨慎：建库建表、插入数据属于变更操作，建议让模型先打印将要执行的 SQL，确认无误后再执行。

十四、7. 常见问题排查