# Activepieces MCP 教程：把虚构售后规则做成聊天可调用的资格核对工具

本次实际运行：Python标准库参考程序、业务边界检查与HTML渲染。未安装或运行Activepieces，未调用模型、创建真实自动化、发送消息、建第三方PR或部署。人工基准和错误样稿均明确标注。

## 文件

input.json：原创输入；node-fields.json：字段教材，不能直接当平台导出文件导入；prompt.md：任务约束；schema.json：规范化观察结构；reference.py：本站手写参考；reference-output.json：实际本地输出；reference.html：参考产物；review-template.json：读者填写目标工具结果。

## 本地运行

```bash
python3 reference.py
python3 verify.py
```

用浏览器打开reference.html。不依赖模型或第三方账户。

## 真实平台步骤

1. 阅读虚构政策和四单边界
固定今天为2026-10-15，签收第7天可进入eligible，超过7天、定制品及缺日期分别处理。policy.json只用于练习，不能对真实消费者作法律或售后承诺。

2. 建立MCP Tool触发参数
Activepieces添加MCP Tool，填写工具名与用途，定义order_id、delivered_date、customized。缺日期用null，不用空字符串伪造一个今天日期。

3. 让Code返回三态与规则ID
用reference.py中的独立规则参考实现本地Code逻辑，返回eligible/ineligible/needs_info及rule_id。模型负责理解自然提问，不能覆盖Code判定或补造订单事实。

4. 用Reply to MCP Client返回工具结果
将Code输出映射到Reply to MCP Client。MCP Server管理工具与暴露业务flow不是一回事；在自己的部署按当前版本将该业务工具提供给客户端。

5. 客户端先发现工具再发起调用
Settings → MCP Server启用后复制server URL，客户端按OAuth授权。先直接测试四种输入；认证失败、工具未发现、规则错误分别排查，不把LLM正常聊天当MCP已连通。

6. 回读参数、规则与缺项追问
实际客户端应保留工具调用输入/输出，R04返回needs_info后询问签收日期。reference.html是本地规则运行结果表，没有模拟真实客户端UI或退款状态。

7. 记录费用并停在资格核对
保留flow导出、MCP pieceVersion和四次实际记录。ap_run_action及工具触发flow可能有平台credits，模型调用另算；本题不访问真实客户、不退款、不发送消息。

## 版本与许可

Activepieces0.92.3及具体MCP pieceVersion；客户端需支持相应远程MCP/OAuth。平台key与apizt key不可混用；MCP认证、模型工具调用、业务规则三层分别测。虚构7日规则只为教材，不是法条或真实店铺承诺。

## 来源

- https://www.activepieces.com/pieces/mcp
- https://www.activepieces.com/docs/mcp/overview
- https://www.activepieces.com/pieces/ai/mcp

## 验收边界

虚构政策有签收7日、定制例外、缺订单日期则需补充。MCP Tool接收订单事实、代码判定eligible/ineligible/needs_info，Reply to MCP Client返回理由与rule_id；聊天模型负责从用户问题提参数、回述结果。交可导出的flow、4种边界工具调用记录与三态输出。不查询真实顾客，不退款，不代替真实法律政策。

目标产品实跑时保存原生输出，不得把本包人工/手写参考改名冒充模型返回。所有人物、订单与规则均为虚构练习数据。

渲染说明：input.html、operation.html、reference.html和figures是随当前原创输入冻结的实际浏览器预览；修改输入后重新运行会更新reference-output.json，静态HTML不会自动重绘。目标软件原生结果请另存。