如何快速实现 MCP 功能

:gear: 如何快速实现 MCP 功能

请按照本篇文章进行配置。


:blue_book: MCP 简介

MCP(Model Context Protocol) 是通过 API 为大模型提供访问外部数据能力的机制。

MCP 能让 AI 具备 “读” 与 “写” 数据库的能力,例如:

:receipt: 读(Read)

根据订单号(或产品号),让 AI 知道数据库中存储的信息,并将结果回答给客户。
示例:

客户询问:“我的商品到哪了?”
→ 根据客户提供的“订单号”在数据库中查找信息
→ 回复客户:“您购买的商品显示 [配送中],请您注意查收。”


:fountain_pen: 写(Write)

根据订单号和客户提到的问题,将售后信息自动写入数据库。
示例:

客户询问:“我购买的跑步机不工作了?”
→ 根据客户提供的“订单号”,将售后问题记录到数据库
→ 回复客户:“我们的同事稍后会联系您哦~”


:test_tube: 快速体验 MCP 功能

为了让您快速体验 MCP 的能力,我们提供了测试用 API 接口,数据存储在以下在线表格中:

:link: 在线表格(点击进入)

:backhand_index_pointing_right: 以下示例为 “查询(Read)” 配置
更多高级功能请参考:
MCP_增删改查参数文档


:ladder: 配置步骤

准备工作:创建访问令牌(点击展开)
  1. 打开 开放平台 → OAuth 客户端 → 新建


  2. 自动跳转至页面,创建 永久 Token,并记录下 Token 值。



准备工作:配置 Token
  1. 进入 3Chat Agent → MCP 授权访问 → 新建

  2. 在弹出的页面中填写信息:


配置 AI 任务查询逻辑
  1. 在左侧菜单中进入 3Chat Agent → AI 任务
  2. 新建一个 AI 任务,按照下图配置并保存运行:
查询订单信息
---
当用户询问订单相关信息时
---
如果在历史对话中客户没有提供订单号:输出"请您提供订单号"
如果在历史对话中客户提供了订单号:调用"查询订单信息"工具,输出查询到的订单信息

点击右上角加号,选择对应MCP工具


配置 MCP 工具(根据图片进行配置)
  1. 配置名称与描述

    描述用于帮助大模型理解何时调用此工具

    search_order
    ---
    查询订单信息
    

  2. 配置请求参数

    参数描述用于告诉大模型如何构造查询请求

    https://c2.xinheyun.com/api/open/v2/coze/workflow/run
    ---
    order_id   客户的订单号
    ---
    {
      "workflowId": "7555717286728908834",
      "parameters": {
        "base_url": "https://3chat-ai.feishu.cn/base/Ct31bmyqgaquzxsjGG0cETeRnzc?table=tbl4tFYj2pkMk9ub&view=vewfieQ4B1",
        "fields": {},
        "order_id": "{{order_id}}",
        "purpose": "read"
      }
    }
    

  3. 配置参数值,测试接口

    可在在线表格中自行添加测试订单号

    order_id   P1234567896112222222
    

  4. 清洗返回参数

  5. 点击保存


:white_check_mark: 最终测试效果