一、前提条件
在开始本操作前，请确保满足以下条件：
·已开通 DataBuddy 服务并完成空间初始化。
·当前账号在目标 Workspace 中拥有 Agent 开发者 或更高角色（角色权限说明详见 成员与权限管理）。
·根据要创建的 MCP 类别，准备相应资源：
·Catalog 函数 ：已在 Catalog 中创建可用的 UC Function（在 SQL Editor 或 Notebook 中创建）。
·外部 MCP / API ：已知外部服务的地址、认证方式和凭证。
·合作伙伴插件 ：根据插件需要，准备腾讯云 AK/SK、API Key 或用户名密码等凭证。
二、使用限制
| 限制项 | 说明 |
| 单个 MCP 服务工具数 | 最多 1000 个 |
| 外部 MCP 添加方式 | 一期支持通过 mcp.json 录入 |
| MCP 服务状态刷新 | 列表展示上次查看时的状态，不实时刷新 ，需进入详情页或点击 刷新 触发最新校验 |
三、进入 MCP 列表
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 在左侧导航栏选择 数据应用 > Agents ，进入 MCP 标签页。
MCP 列表展示当前 Workspace 内所有可用的 MCP 服务，包括服务名称、类别、作者、工具数、更新时间和服务状态。你可以在列表上方按名称模糊搜索、按类别过滤，或点击 刷新 触发选中 MCP 的状态校验。
四、方式一：基于 Catalog 函数创建 MCP 服务
Catalog 函数创建后会自动以 MCP 服务的形式暴露，无需在 MCP 页面单独新建。
1. 进入 数据工程 > Studio ，打开任意 Notebook 或 SQL 脚本。
2. 编写并执行 CREATE FUNCTION 语句注册函数到指定的 Catalog 与 Schema 下，例如：
CREATE OR REPLACE FUNCTION my_catalog.sales.compute_gmv( start_date STRING COMMENT '统计起始日期，格式 yyyy-MM-dd', end_date STRING COMMENT '统计结束日期，格式 yyyy-MM-dd')RETURNS DOUBLECOMMENT '计算指定时间区间内的 GMV'RETURN ( SELECT SUM(amount) FROM my_catalog.sales.orders WHERE order_date BETWEEN start_date AND end_date);
1. 函数创建成功后，回到 MCP 列表，类别为 Catalog 函数 的 MCP 中即可看到该函数对应的工具。
2. （可选）点击列表项进入详情页，确认工具名称、参数描述与服务地址。
注意：工具名称、参数说明、必填性来自函数定义中的参数名与 COMMENT。建议在创建函数时为每个参数填写清晰的中文或英文 COMMENT，Agent 才能更好地理解何时调用该工具。
五、方式二：添加外部 MCP / API 服务
如果你已有自建的 MCP Server 或希望接入第三方 HTTP API，可以将其作为外部 MCP 服务录入。
1. 在 MCP 列表点击 添加外部 MCP 工具 。
2. 选择录入方式：
·mcp.json 录入 ：在文本框中粘贴标准 MCP JSON 配置，平台保存后会进行连通性校验，校验状态可在详情页中查看。
1. 配置 是 MCP 连接 ：在连接详情步骤中默认勾选且不可取消。
2. 点击 添加 ，提交后界面会提示添加成功或失败。
3. 添加成功后，新 MCP 出现在列表中（类别为 外部 API ），点击进入详情页查看校验状态、服务地址与工具列表。
注意：对于通过 mcp.json 录入的服务，校验失败时 MCP 状态会标记为不可用，但记录仍会保留。请进入详情页查看错误原因，修正配置后重新校验。
六、方式三：从插件市场一键安装 MCP
MCP 插件市场提供开箱即用的 MCP 工具，可以快速接入各类第三方能力。
1. 在 MCP 列表点击 MCP 市场。
2. 在插件详情页右上角点击 安装 ：
·无需认证的插件 ：直接完成安装，安装后即出现在 MCP 列表中。
·需身份认证的插件 ：弹出安装弹窗，按提示填写凭证（详见下方 插件身份认证），勾选 同意用户协议和隐私政策 后点击 安装 。
1. 安装成功后会有 toast 提示，列表中可看到新增的 MCP 服务。
七、查看 MCP 详情
在 MCP 列表中点击任意一项进入详情页，可查看以下信息：
| 区块 | 内容 |
| 头部信息 | MCP 名称、类别、描述、作者（ MCP 显示为「Wedata 」）、工具数、更新时间 |
| 服务状态 | 当前 MCP 是否可用，进入详情页或点击 刷新 时触发最新校验 |
| 服务地址 | 用于 Agent / SDK 调用的 URL，点击复制按钮提示「复制成功」 |
| 工具列表 | 每个工具展示名称、描述、输入参数 Schema 与输出结构 Schema |
八、外部 MCP 身份认证
外部 MCP 当前支持 mcp.json 录入。
九、验证结果
操作完成后，你可以通过以下方式确认 MCP 服务可用：
1. 在 MCP 列表中找到刚创建或安装的 MCP，服务状态 显示为可用。
2. 进入详情页，点击 刷新 后状态保持可用，工具列表与参数 Schema 正常显示。
十、Q：为什么 MCP 列表里看到的状态和实际不一致？
MCP 服务状态在列表中不实时刷新 ，显示的是上一次查看时的状态。请进入详情页或点击 刷新 触发最新校验。
十一、Q：通过 mcp.json 添加外部 MCP 后状态显示不可用怎么办？
请检查以下几点：
1. JSON 格式是否合法、必填字段是否完整。
2. 服务地址是否可从 DataBuddy 平台所在网络访问（注意内网/VPC 隔离）。
3. 凭证是否正确、是否过期。
4. 校验失败的具体错误在详情页中可见，按提示修正后重新校验。
十二、相关文档
·什么是 MCP
·配置 MCP 服务
·创建与管理 Agent
·配置 Agent 工具与知识库