功能简介
MCP基本释义：是 Anthropic 推出的开放标准通信协议 ，通俗理解：AI 智能体连接外部工具、数据库、文件、业务系统的通用 USB 接口。
百数MCP：
- 支持对外百数平台的API 能力（比如读取百数表单、查询数据库），所有支持 MCP 的 AI（Claude、Cursor、扣子 Coze、WorkBuddy等）都可以直接调用。
- 支持接入外部 MCP 服务，当作扩展工具使用。
和普通功能插件的区别：功能插件只能在低代码平台使用，MCP 扩展：遵循开放协议，跨平台，一套服务多处 AI 复用。
MCP 和普通插件到底差在哪？
| 对比项 | 百数普通功能插件 | MCP 插件 |
|---|---|---|
| 运行范围 | 只能在百数低代码/智能体内用 | 遵循开放协议，跨平台复用 |
| 可被谁调用 | 百数智能体 | Claude、Cursor、Coze、WorkBuddy 等所有支持 MCP 的 AI |
| 复用方式 | 每个平台单独接一遍 | 一套 MCP Server，多处 AI 直接连 |
| 典型用途 | 百数内部能力扩展 | 把百数表单/数据库能力开放给外部 AI，或接外部 MCP Server |
MCP基础开发流程
新建MCP
进入百数AI模式 >> 智能体开发 >> MCP，新建MCP。
- 插件名称：自定义，确保名称含义清晰且符合平台规范。
- 插件描述：自定义，描述插件的主要功能及使用场景，帮助用户/大模型更好的理解。
工具名和描述别随便写------它们是给大模型看的
大模型决定「要不要调这个工具、传什么参数」，完全靠工具名和工具描述。写得模糊（例：「查询」「处理数据」），模型就会乱调或不调；写得具体（例：「按手机号查询客户最近 30 天工单」），模型才会在正确的时机用对参数。 - 插件工具创建方式：目前只可选 私有MCP。
编辑插件配置
支持编辑MCP的相关参数。
- 插件名称：自定义，确保名称含义清晰且符合平台规范。
- 插件描述：自定义，描述插件的主要功能及使用场景，帮助用户/大模型更好的理解
- 插件工具创建方式：目前只可选 私有MCP。
- 插件 URL：MCP 服务远程访问端点，仅 Streamable-HTTP/SSE 远程模式填写；私有代码 MCP 无需配置。
- 在百数内部写【私有 MCP 代码工具】（百数 IDE 内写 Python 代码），不需要填写插件 URL。
- 对接外部独立部署 MCP Server（自己服务器部署 Fast-MCP），才需要填插件 URL。
什么时候填插件 URL，什么时候不填？
| 场景 | 填不填 URL | 做法 |
|---|---|---|
| 在百数 IDE 里写 Python 工具 | 不填 | 选「私有 MCP」，直接在线写代码 |
| 对接自己服务器上独立部署的 MCP Server | 填 | Streamable-HTTP/SSE 地址 + Header 鉴权 |
| 对接第三方公共 MCP 服务 | 填 | 对方给的 URL + 申请到的 API Key |
- Header 列表：鉴权 Token、API Key 放在Header列表。
- 授权方式：访问你的 MCP-Server 服务时，用什么身份凭证鉴权 ，防止别人随意调用你的 MCP 接口。
- 不需要授权：MCP 服务完全公开，请求不带任何身份凭证，任何人知道插件 URL 就可以调用。
- Service >> Service token / API key（请求头鉴权，MCP 最常用）:在Header 或Query中设置key，MCP-Server 代码读取 并校验这个 key，只有携带正确 key 才允许连接调用。
- OAuth：需要完整 OAuth 服务，获取 access_token，配置复杂。MCP 工具场景极少使用，一般对接第三方大型开放平台才用。
三种授权方式怎么选？
| 授权方式 | 原理 | 适用场景 |
|---|---|---|
| 不需要授权 | 裸连，谁都能调 | 仅内网测试，绝不要用于生产 |
| Service Token / API Key | 请求头/Query 里带 Key，服务端校验 | MCP 最常用，绝大多数私有服务选这个 |
| OAuth | 走完整 OAuth 流程拿 access_token | 对接第三方大型开放平台，配置复杂，一般不用 |
MCP下创建工具
这里的工具指 给 AI 智能体调用的可执行函数。
- 工具名称：自定义，函数名称，确保名称含义清晰且符合平台规范
- 工具描述：自定义，描述插件的主要功能及使用场景，帮助用户/大模型更好的理解
编辑工具
新建工具后跳转到编辑工具页，或者直接编辑已有工具。
工具名称：自定义，函数名称，确保名称含义清晰且符合平台规范。
工具描述：自定义，描述插件的主要功能及使用场景，帮助用户/大模型更好的理解
配置输入参数：函数的输入参数，根据实际情况填写。
配置输出参数：函数的输出参数，根据实际情况填写。
输出参数支持自动解析：
试运行：手动调用测试 MCP 工具，不经过大模型，直接填参数跑工具，验证接口通不通、返回对不对。
代码编写
**说明：**使用 Python 代码编写工具内部执行逻辑。开发者可以编写自定义 Python 业务代码，既可以调用百数平台内部接口读取应用、表单、数据记录，也可以发起网络请求接入第三方外部接口。通过代码完成参数校验、数据转换、复杂业务运算、异常捕获处理，实现各类复杂定制化业务能力，满足智能体工具调用的业务诉求。
平台提供已封装好的 MCP Python API，可直接调用，接口文档参考：MCP Python API接口文档(MCP Python API接口文档.md)。
接口调用将沿用登录平台账号的权限，操作权限和数据权限与该用户在平台内的权限完全一致。
权限与安全提醒：
-
MCP 代码调用百数内部接口时，沿用当前登录账号的权限------账号能看哪些数据，MCP 就能读哪些；
-
不要在代码里硬编码管理员账号或密钥；需要第三方鉴权时统一走 Header；
-
对外暴露的 MCP Server 一定要配 API Key，不要裸奔。
**入口：**MCP详情页，右上角编辑按钮，进入代码编辑页面。
**AI助力：**支持AI自动调用百数内部MCP接口，实现相关功能。
1）在AI生成入口，输入需求，等待AI生成。
2）回到编辑工具页面，新增工具，命名为刚刚生成的函数，并设置好输入参数。
3）调试，验证是否正常，如果返回不对，可进一步修改，直至返回正确。
发布
插件调试完成后，需执行发布操作，插件才可被智能体调用使用；插件发生任何修改，均需要重新发布，变更内容才会正式生效。
调试通过的代码才能发布。
停用/启用
工具需处于启用状态才可被智能体调用；停用状态下，该工具无法被调用执行。
智能体挂载MCP插件
1）新建智能体，在智能体设计页面添加刚刚新建的插件。
2）在人设与回复中，填写提示词，并使用{引出插件，并添加。
3）调试，输入带参数的指令对话。
端到端流程一图流
新建 MCP → 填名称/描述 → 选私有 MCP 或填外部 URL → 配鉴权 → 新建工具（名称/描述/入参/出参）→ 写 Python 代码（或用 AI 生成）→ 试运行 → 发布 → 智能体挂载并在提示词里用 { 声明 → 对话调试。
常见问题 FAQ
Q1：MCP 到底是什么？能用一句人话解释吗？
A：MCP 是 Anthropic 提出的开放协议，相当于 AI 接外部工具的「USB 标准」。任何支持 MCP 的 AI（Claude、Cursor、Coze）都能通过同一个标准连上你的工具，不用每个平台单独对接。
Q2：MCP 和百数普通插件有什么区别？
A：普通插件只能在百数内用；MCP 遵循开放协议，可以被外部 AI 客户端调用，一套服务多处复用。
Q3：为什么我新建的 MCP 工具，智能体就是不调用？
A：和工作流一样------挂了不等于会调。必须在智能体【人设与回复逻辑】里用 { 引用该工具，并写清什么场景下调用；工具描述也要写清楚。
Q4：插件改了代码，为什么线上还是旧版本？
A：MCP 每次修改后必须重新发布；调试通过的代码才能发布。
Q5：试运行和智能体对话测试有什么区别？
A：试运行是在 MCP 编辑页直接填参数跑工具，不经过大模型，用来验证接口通不通；智能体对话测试是端到端验证大模型会不会正确选工具、传对参数。两步都要做。
Q6：MCP 代码能访问哪些数据？
A：沿用登录用户在百数平台的权限，账号能看什么 MCP 就能读什么；需要越权访问时要单独评估，不要硬编码密钥。
Q7：AI 助力生成代码靠谱吗？
A：适合起步------输入需求让 AI 生成初版，然后人工检查入参、异常处理和权限，再试运行调通。不要生成完直接发布。
上线前检查清单
□ 工具名和描述是否写得足够具体，大模型看得懂什么时候调？
□ 入参/出参是否定义清楚，类型是否正确？
□ 外部 MCP Server 是否配了 API Key，没有裸奔？
□ 试运行是否通过，返回数据符合预期？
□ 代码是否已发布？智能体提示词里是否用 { 声明了该工具？
核心概念术语表
| 术语 | 一句话解释 |
|---|---|
| MCP | Model Context Protocol，Anthropic 提出的 AI 连接外部工具的开放协议 |
| MCP Server | 实现了 MCP 协议的服务端，对外暴露可被 AI 调用的工具 |
| 私有 MCP | 在百数 IDE 里用 Python 写的工具，无需填外部 URL |
| 插件 URL | 远程 MCP Server 的访问地址（Streamable-HTTP/SSE） |
| 工具 / Tool | MCP 下给 AI 调用的一个具体函数，有入参和出参 |
| 入参 / 出参 | 函数的输入参数和返回值，需定义类型和描述 |
| API Key / Token | 调用 MCP 服务时的身份凭证，放在 Header 里 |
| OAuth | 完整授权流程，用于对接大型第三方开放平台 |
| 试运行 | 不经过大模型，直接填参数调工具验证接口 |
元信息
适用产品：百数AI 智能体开发 / MCP 模块｜能力：私有 Python 工具开发、外部 MCP Server 接入、跨平台 AI 复用｜文档更新时间：2026-09