数据服务MCP

发布于 2026年11月2日

「数据服务MCP」是安捷智用 AI 应用平台（AI数据底座版）中的对外数据服务模块，用于把「企业数据」中整理好的数据表，以标准 MCP（Model Context Protocol）数据服务的方式安全开放给外部 AI 客户端调用。外部 AI 不直接连接企业数据库，而是通过本模块生成的服务地址与访问密钥取数：每把密钥绑定一个执行用户，客户端能看到哪些表、哪些行、哪些列，完全由该执行用户的数据权限决定；同时支持发布范围控制、单次返回行数上限与调用留痕审计，实现 AI 问数“连得上、对得齐、不泄密”。

一、模块介绍

1.1 功能定位

统一供数出口：将企业数据表统一发布为标准 MCP 数据服务，供金蝶灵基、用友 YonWork、飞书 / 通义类 AI、通用办公 AI 以及自研 AI 系统等外部客户端接入，作为这些 AI 背后统一、口径一致的数据服务层。
按权限安全取数：AI 不直连生产数据库，所有取数请求经服务端按执行用户权限过滤，支持数据范围权限、字段行权限、字段列权限等控制，敏感数据不直接暴露给客户端。
全程可审计：每次调用使用的密钥、执行用户、数据表、调用结果、返回行数、耗时与错误码均留痕，便于追溯与安全审计。

1.2 入口与页面组成

入口路径：顶部导航「系统管理」→「门户与发布」分组 →「数据服务MCP」。

页面顶部说明为“发布企业数据服务，为外部MCP客户端分配执行用户和访问密钥”，页面由三个页签组成：

页签	作用
服务	配置服务开关、发布范围、单次最大返回行数（服务设置），并提供服务地址与客户端 JSON 配置（客户端接入）
密钥	创建、停用、删除访问密钥，管理每把密钥绑定的执行用户
调用记录	查看外部客户端每次调用的明细记录

二、模块使用

2.1 服务设置

「服务」页签的「服务设置」区域用于控制服务是否对外可用、开放哪些数据表以及单次查询的数据量上限；配置修改后，需点击「保存设置」才会生效。

2.1.1 启用服务

通过「启用服务」开关控制整个 MCP 数据服务的启停：打开开关并保存后，客户端才可凭访问密钥调用；关闭开关并保存后，所有密钥的调用将被停止。
开关旁提示“保存后允许客户端调用”，即启停状态以点击「保存设置」后的结果为准，仅拨动开关不会立即生效。

2.1.2 发布范围

发布范围用于控制本次服务对外发布哪些企业数据表，二选一：

选项	说明
全部企业表（默认）	发布当前全部企业数据表，并且包含未来新增的数据表；但客户端实际可见的数据，仍受执行用户权限约束
指定企业表	仅发布手动选择的企业数据表，未被选中的数据表不会通过本服务对外提供

注意：数据访问由“发布范围”与“执行用户权限”共同决定——即使某张表在发布范围内，只要密钥对应的执行用户没有该表的访问权限，客户端依然查不到对应数据。

2.1.3 单次最大返回行数

「单次最大返回行数」默认值为 1000，单次查询最多返回 1–10000 行，修改后点击「保存设置」生效。
该数值仅代表每次接口调用返回的行数上限，并不限制整体可使用的数据量：当查询结果超过上限时，客户端会自动分页、多次调用接口取全量数据。
设置该参数的目的是避免单次查询返回过大结果集、影响服务性能与数据安全，可结合业务数据量与安全要求调整。

2.1.4 客户端接入

「客户端接入」区域提供外部 AI 客户端连接本服务所需的地址与配置，均由系统自动生成，无需手工编写。

配置项	说明
服务地址 Endpoint	MCP 服务的访问地址，采用 HTTP · Bearer 认证方式，可通过「复制Endpoint」按钮直接复制给客户端
客户端JSON配置	供 MCP 客户端使用的连接配置，可点击「复制客户端JSON配置」复制，或展开查看详情；配置中的 `<MCP_API_KEY>` 占位符，需要替换为创建密钥时保存下来的真实访问密钥
管理访问密钥	点击可直接跳转到「密钥」页签，进行密钥的创建与管理

关于服务地址的生成规则与网络可达性，请特别注意：

页面展示的服务地址由系统按当前访问系统的地址自动生成，反映的是当前登录所使用的路由：
若通过本机地址（如 127.0.0.1）或内网 IP 访问系统，生成的服务地址即为对应的本机 / 内网 IP 路由，仅本机或同一内网内的客户端可以调用；
若希望远程客户端或外网客户端可以调用，需要使用外网 IP 或域名解析地址登录系统，页面才会生成对应的可外部访问地址；也可以由管理员自行配置路由（如反向代理、域名映射等），使服务地址对外可达。
复制出的客户端 JSON 配置仅为参考模板：将其中的 <MCP_API_KEY> 替换为真实密钥后，再分发给对应客户端；密钥仅在创建成功时展示一次，请只分发给可信客户端并妥善保管。

2.2 密钥管理

「密钥」页签用于管理外部客户端的访问密钥：为每个客户端分配独立密钥，密钥绑定一个执行用户，客户端可访问的数据范围由该执行用户的权限决定。

2.2.1 创建密钥

在「密钥」页签点击「创建密钥」，弹出「创建访问密钥」窗口。
填写以下配置项：

配置项	是否必填	说明
密钥名称	必填	由管理员自定义，建议按客户端或使用场景命名（如“某 AI 助手”“门店分析客户端”），便于在密钥列表中区分和管理
执行用户	必填	选择一个系统用户作为该密钥的执行用户；客户端调用时可访问的数据权限范围，完全由该执行用户决定
过期时间	可选	可为密钥设置到期时间；不设置则密钥长期有效

确认填写无误后，点击「创建」完成密钥创建。

注意：访问密钥仅在创建成功时展示一次，窗口关闭后无法再次查看完整密钥，请务必在创建成功后立即复制并安全保存；密钥列表中仅展示密钥前缀，用于识别不同密钥。

执行用户的数据权限来源：执行用户的数据权限在系统「权限管理」模块中配置，支持数据范围权限、字段行权限（按记录限制可见的行）、字段列权限（按字段限制可见的列）等。因此在创建密钥前，应先确认所选执行用户在「权限管理」中的数据权限符合该客户端应有的可见范围，避免越权暴露数据。

2.2.2 访问密钥管理

密钥列表展示每把密钥的名称、执行用户、密钥前缀、状态、过期时间、最后调用时间、创建时间，并在「操作」列提供管理动作：

操作	说明
停用	停用后该密钥立即失效，使用它的客户端无法再调用数据服务，适用于客户端临时下线、密钥疑似泄露等需要立即收回访问能力的场景
删除	永久移除该密钥，删除后对应客户端无法再凭此密钥接入；删除前请确认没有客户端仍在使用该密钥

列表顶部提供「刷新」按钮，用于获取最新的密钥状态与最后调用时间；可结合「最后调用」列判断各密钥是否仍在被使用。

2.2.3 调用记录查看

「调用记录」页签用于追溯服务被外部客户端调用的明细，点击「刷新」可获取最新记录。每条调用记录包含以下字段：

字段	说明
时间	本次调用发生的时间
密钥	本次调用使用的访问密钥（按密钥名称识别）
用户	本次调用对应的执行用户
工具	本次调用的数据服务动作，如列出可用数据表、查询数据表数据、读取数据表字段明细等
表名称	本次访问的数据表；列出可用数据表等动作可能没有具体表名
结果	本次调用是否成功
行数	本次调用返回的数据行数
耗时(ms)	本次服务处理耗时（毫秒）
错误码	调用异常时返回的错误码；调用成功时为空

通过调用记录可以回答：哪个客户端（密钥 / 执行用户）在什么时间调用了哪张数据表、调用是否成功、返回了多少行、耗时多少、是否报错，为权限核对、问题排查和数据使用审计提供依据。

三、数据服务MCP的三方使用

完成「服务」与「密钥」配置后，AI 数据底座即对外提供标准 MCP 数据服务。其他 AI / 办公客户端只需拿到服务地址（Endpoint）和一个访问密钥，即可按 MCP 协议接入并在对话中取数。下面分别说明在 WorkBuddy、金蝶灵基 Lingee 中的接入方式。

接入前准备：① 在「数据服务MCP → 服务」页签确认服务已启用并已保存；② 在「密钥」页签创建好密钥，并及时复制保存完整密钥；③ 复制「服务」页签「客户端接入」中的服务地址 Endpoint 与客户端 JSON 配置备用；④ 确认客户端与本服务网络可达——内网客户端使用本机 / 内网地址，远程或外网客户端需使用外网 IP 或域名解析地址。

3.1 WorkBuddy 中使用

WorkBuddy 通过「自定义连接器」接入外部 MCP 服务，整体分为添加 MCP、信任并完成检测、对话使用三步。

3.1.1 添加 MCP

打开 WorkBuddy，进入「专家·技能·连接器」栏目，选择「连接器」，点击「自定义连接器」。
点击「添加 MCP」，将 AI 数据底座生成的服务地址与密钥填入 / 粘贴到配置中：
服务地址使用「数据服务MCP → 服务 → 客户端接入」中的服务地址 Endpoint；
密钥使用「密钥」页签中创建并保存的完整访问密钥（客户端 JSON 配置中的 <MCP_API_KEY> 占位符，需替换为真实密钥）。
配置中 mcpServers 下的服务名称（键名）可以自行修改为便于识别的名称，例如改为 ai-data-base；该名称只影响客户端列表中的展示与引用，不改变数据权限范围。
保存配置。

注意：请核对 JSON 配置的括号、引号完整，粘贴密钥时不要带入多余空格；若后续修改了服务地址、密钥等配置内容，连接器可能需要重新信任（见 3.1.2）。

3.1.2 返回 MCP 列表，点击信任

回到自定义 MCP 列表，找到刚添加的连接器。
出于安全考虑，自定义 MCP 不会自动启用，需要手动点击「信任」。
系统完成连接检测后，连接器状态颜色变绿并处于开启状态，即表示 MCP 配置完成、可正常调用；若状态为异常（红色），请依次检查服务地址是否可达、密钥是否正确、JSON 格式是否完整。

3.1.3 在对话中使用 MCP

配置完成后，在对话窗口用自然语言下达取数需求，并指明使用哪一个 MCP 服务（即刚才命名的连接器 / AI 数据底座），例如：

使用 AI数据底座，查询最近一个月的营业费用是多少？

WorkBuddy 会通过该 MCP 连接器调用 AI 数据底座的数据服务，并按执行用户权限返回结果。提问时可结合业务口径补充条件（时间范围、部门、科目等）；若返回为空或提示无权限，请回到 AI 数据底座核对：服务是否已启用并保存、发布范围是否包含该数据表、密钥对应执行用户的数据权限是否覆盖所需数据。

3.2 金蝶灵基 Lingee 中使用

说明：本节通用步骤框架先给出，灵基侧具体菜单路径、表单字段与状态标识需以 Lingee 当前版本实际界面为准，待结合界面截图补充完善。

接入前同样需要两类凭据：AI 数据底座的服务地址 Endpoint（HTTP · Bearer 认证方式），以及已创建并保存的访问密钥；并确认灵基所在环境与数据底座之间网络互通。

准备项	来源（AI 数据底座）
服务地址 Endpoint	「系统管理 → 数据服务MCP → 服务 → 客户端接入」中复制
访问密钥	「密钥 → 创建密钥」创建后展示的完整密钥（仅展示一次，需及时保存）
数据权限范围	由密钥绑定的执行用户在「权限管理」中配置的数据范围、行、列权限决定

在灵基 Lingee 支持接入外部 MCP / 自定义工具的前提下，通用接入思路如下：

在灵基 Lingee 的连接器或工具配置入口中，新增一个自定义 MCP 服务；
填入服务地址 Endpoint，并将访问密钥配置为该服务的 Bearer 鉴权凭据；
保存后完成连通性检测与信任授权，确认服务处于可用状态；
在智能体或对话中绑定该 MCP 服务，通过自然语言指定由其提供数据，例如“查询最近一个月的营业费用是多少”。