MCP（Model Context Protocol，模型上下文协议）是一种用于将外部工具、数据源、业务能力以标准化协议 暴露给大模型 / Agent 调用的开放协议。在 DataBuddy 中，MCP 是 Agent 调用平台数据资产的统一桥梁 ，Agent 即可在对话或任务中按需发现、调用这些工具，无需为每种数据源或服务单独编写适配代码。
举一个典型例子：一个智能问数 Agent 需要查询销售明细表、调用 Catalog 中已注册的
compute_gmv()函数、再通过外部 API 获取实时汇率。借助 MCP，您只需要把销售明细的 Catalog 函数、外部 HTTP API 等注册为 MCP 服务，Agent 即可像调用本地函数一样统一调用它们。核心能力
能力 | 说明 |
协议统一 | 不同来源的工具（Catalog 函数 / 外部 HTTP / 第三方插件）均通过同一套协议暴露给 Agent，Agent 侧无须了解底层差异。 |
多来源接入 | 同时支持平台内置工具、用户自定义工具、外部 MCP / API、MCP 插件市场，覆盖企业常见集成场景。 |
凭证集中管理 | 外部 MCP / API 的身份认证通过 Connection 统一托管。 |
与 Agent 无缝集成 | MCP 服务可直接挂载到 Agent 调试会话中，调用记录会同步进入 MLflow Tracing。 |
MCP 服务类别
DataBuddy 一期支持以下几种 MCP 服务来源，您可以在「Agents > MCP」列表中集中管理。
类别 | 适用场景 | 创建方式 |
Catalog 函数（UC Function） | 把 Catalog 中已注册的 SQL / Python 函数（如指标计算、数据库查询）作为工具调用。 | 在 SQL Editor 或 Notebook 中创建函数后自动暴露为 MCP 工具。 |
外部 MCP / API 服务 | 接入企业自有 MCP Server 或第三方 HTTP API。 | 在 MCP 列表点击添加外部 MCP 工具 ，通过 mcp.json 配置。 |
合作伙伴 MCP 插件市场 | 一键安装官方 MCP 插件。 | 在 MCP 列表点击 从市场发现更多 MCP 服务 ，进入插件市场安装。 |
关键概念
理解 MCP，需要熟悉以下核心概念：
MCP 服务（MCP Server） ：一组对外暴露的工具集合，对应一个可调用的 MCP 服务地址。
工具（Tool） ：MCP 服务下的最小调用单元，包含名称、描述、输入参数 Schema 与输出结构 Schema。一个 MCP 服务最多可包含 1000 个工具 。
Connection ：用于管理外部 MCP / API 的连接配置与凭证。
MCP 服务地址 ：技术侧生成的、可被 Agent / SDK 调用的 URL，支持复制。
MCP 服务状态 ：标识当前 MCP 是否可用。列表中显示的是上次查看时的状态，不会实时刷新 ；进入详情页或点击刷新 时才触发最新状态校验。
提示
适用场景
场景 | 适用方式 | 推荐 MCP 类别 |
Agent 查询业务数据库 / 计算指标 | 把已有 SQL / Python 函数注册为 MCP 工具 | Catalog 函数 |
Agent 调用企业内部已有的 API / MCP Server | 自定义 MCP | 外部 MCP / API 服务 |
让 Agent 具备文档抽取 / 联网搜索 / 第三方数据接入能力 | 一键安装，自动完成参数配置 | MCP 插件市场 |
使用流程
一个典型的 MCP 使用闭环包含以下步骤：
1. 创建或安装 MCP 服务 ：在 MCP 列表中创建 Catalog 函数、外部 MCP，或从插件市场安装合作伙伴 MCP。
2. 查看 MCP 详情 ：进入详情页确认服务状态、复制服务地址、浏览工具及参数定义。
3. 绑定到 Agent ：在高代码 Agent 中通过 SDK 调用 MCP 工具。
4. 运行与观测 ：Agent 调用 MCP 的全过程会记录到 MLflow Tracing，可在实验模块查看每次调用的输入、输出、耗时与状态。
子功能导航
子功能 | 说明 | 文档 |
MCP 服务配置 | 创建、查看、管理各类 MCP 服务 | |
MCP 与 Agent 集成 | 在 Agent 中使用 MCP 工具 |
推荐学习路径
如果您是首次使用 MCP，建议按以下顺序阅读：
1. 了解核心概念 ：本文。
2. 创建第一个 MCP 服务 ：配置 MCP 服务，从 Catalog 函数或安装一个 ADP 插件开始最为简单。
3. 在 Agent 中调用工具 ：MCP 与 Agent 集成。
4. 了解 Agent 总体能力 ：Agent 概述。
相关文档
创建与管理 Agent
