💬 导语

自定义 MCP 工具是一种零代码、深度集成的能力，可将您企业外部系统的实时数据或操作能力（如订单系统、CRM、ERP、会员平台等）接入 3Chat Agent。这些能力可驱动 3Chat 在售前阶段执行 “智能营销 SOP” —— 主动引导留资与转化；在售后阶段化身 “业务专家” —— 精准执行退款、改约、积分发放等操作，全面提升客户留存与复购率。

👇点击视频，查看演示👇

👆点击视频，查看演示👆

💡 入门建议

在传统的客服场景中，客服人员或销售团队常被问到一些协助客户处理复杂问题的咨询，例如：

• “我的订单现在到哪了？”

• “能帮我改一下收货地址吗？”

• “我有 500 积分，能换什么？”

• “帮我取消明天的预约”

这些问题往往需要调用外部系统数据或触发业务操作，简单的问答智能体又无法仅通过知识库来回答实效性要求很高的问题。转接人工后，人工也需要查询很多平台才能完成一次客户问题的咨询，费时费力。

针对以上的难题，通过接入自定义 MCP 工具，

3Chat Agent 可充分理解客户的需求自动完成这些操作，无需人工介入

🧭 导航指引

登陆 3Chat 后台，您可通过以下路径配置 MCP 工具： 3Chat Agent > MCP > 工具调用

⚙️ 快速操作指导

前置准备工作

1.思考需要 3Chat Agent 协助客户处理哪些业务操作和访问哪些外部数据 - 开放接口(OpenApi)。

2.保证提供给 3Chat Agent 使用的外部开放接口的执行性能，默认的超时时间是 30S。超过此时间，3Chat Agent 会认定请求超时。

3.为保证 3Chat Agent 可以安全可信的调用外部的开放接口，需要登陆对应的外部系统，获取有效的访问认证授权。

具体操作参考：

https://group.3chatai.cn/t/topic/111

配置自定义 MCP 工具

首先，通过导航指引，进入工具调用页面。在工具列表的右上方点击添加操作，进入工具配置页面。

步骤 1：填写工具的基本信息

需要定义工具的名称。提供工具描述，说明工具的作用以及 3Chat Agent 在什么时候需要使用此工具。

定义工具的名称

👍 工具描述建议 - 要足够清晰

清楚的说明何时使用此工具，以及它应该提供的详细的信息

• 建议示例：使用此工具获取客户订单的详细信息，获取到的信息可以帮助排查与订单相关的问题。工具将提供客户的所有订单详情，如订单状态、购买的商品、收货地址、物流跟踪信息或其他相关订单信息

• 不建议的示例：使用此数据连接器获取订单信息

👍 工具描述建议 - 避免使用代词

避免使用 “我们”、“他们” 等代词，应该替换成明确的专有名词，例如公司的名字，外部平台的名字

• 建议的示例：使用此工具获取客户在 Shopify 店铺 3Chat 中的所有订单信息

• 不建议的示例：使用此工具获取客户在我们店铺的订单信息

👍 工具描述建议 - 场景要具体

描述使用工具的场景

• 建议示例：使用此工具查询未解决的问题，例如客户想了解问题前的处理状态、是否已经解决，处理后是否能保证系统能恢复工作性能等

• 不建议示例：使用此工具查询未解决的问题

👍 工具描述建议 - 适当提供以下客户的常用短语

参考客户在过往对话中表述问题的方式，并在描述中加入他们常用的关键词和短语

步骤 2：配置请求信息

1.填写您的外部系统接口地址，为了保证数据安全，我们会强制您使用 HTTPS 地址。选择正确的工具执行方式。目前支持 GET、POST、PUT 和 DELETE 四种。

填写外部系统接口地址

2.根据您填写的 HTTPS 接口地址的要求，选择一个已填写的认证授权。选择的认证令牌会在处理 Headers 时默认添加参数名 Authentication。

选择一个已填写的认证授权

3.添加必要的请求头参数，如果 HTTPS 接口要求的认证令牌需要指定除“Authentication" 以外的其他的参数名，可以在请求头参数中填写。

添加请求头参数

4.定义 3Chat Agent 在使用工具前需要收集的数据信息，在这里定义的所有参数，都需要在 HTTPS 请求地址或者请求体中使用，具体的语法是 "{{data_name}}"。

其中：

a.未完整填写参数名、数据类型和参数描述的数据，会在状态列中显示 "未定义"，提醒您完成填写。

b.已完整填写 3 个参数信息但未在请求地址或请求体中使用的数据，会在状态列中显示 "未使用"，提醒您使用此参数。

c.当且仅当所有数据状态为 "已使用" 且请求体 JSON 格式合法时，才允许执行才一步操作。

d.如果工具不需要收集任何信息即可被 3Chat Agent 使用，可以不定义收集参数。

定义需要收集的数据信息

5.填写满足 JSON 格式的请求体，在请求体中可以为 HTTPS 接口请求体中每个参数的定义赋值。支持指定已定义的收集参数，默认值或者 3Chat 的主数据标准字段和自定义字段，如 "联系人" 等。

a.指定收集参数："code": "{{code}}"

b.指定默认值："currency": "CNY"

c.指定主数据字段："customerCode": "{{var.visitor.name}}"

填写满足 JSON 格式的请求体

6.当同时满足以下两个条件时，可以执行下一步操作：响应测试

a.未指定收集参数或定义的收集参数都已使用。

b.请求体 JSON 格式合法。

步骤 3：响应测试

响应测试用于帮助用户验证请求配置是否正确，提供实时响应和示例响应两种方式：

• 实时响应适用于现有的成熟 HTTPS 接口，通过实际的接口请求获取真实的响应结构

• 示例响应适用于开发中的 HTTPS 接口，可以先完成工具配置，和接口同步测试验证

1.选择合适响应测试方式

选择响应测试方式

2.选择实时响应方式后，如果在请求体或者 HTTPS 请求地址中有指定收集参数或主数据变量，需要在执行接口测试操作前指定参数值。完成请求参数赋值后，点击接口测试操作，获取接口返回结构。需要注意：接口测试会真实执行接口，在测试前请您保证接口访问的数据是测试数据，不要影响您的真实业务数据

获取接口返回结构

3.选择示例响应，可直接填写响应体的 JSON 结构，请保证填写的语法正确

选择示例响应

4.当响应示例中的 JSON 格式语法正确时，可以执行下一步：响应数据映射

步骤 4：响应数据映射

此步骤用于配置响应结构中的参数映射和 3Chat Agent 的可访问性

1.当步骤 3 完成接口测试或者手动填写响应结构后，会自动提取响应体 JSON 结构中的所有响应参数的结构，创建响应参数列表。参数名中保留了原有响应体中的嵌套层级

响应参数列表

2.按需对响应参数的配置转换规则：在数据行尾，点击编辑按钮进入配置窗口

a.响应参数名：响应参数的参数名 (Key)，保留原始 JSON 结构中的层级

b.示例响应值：响应体结构中获取的响应参数值

c.映射参数名：3Chat Agent 可见的参数名，默认值为原响应体的参数名

d.数据类型：3Chat Agent 可见的数据类型，默认值为原响应体的参数类型。可根据实际情况指定参数类型转换

e.可访问：标识 3Chat Agent 是否对此响应参数可见

点击编辑按钮进入配置窗口

👍 配置参数转换的建议 - 参数命名转换

当响应参数的命名无法真实表达字段含义时，可以修改成业务友好的参数名

例如："abc" : "O-250823-001"，表达订单编号，建议指定映射参数名 "orderCode"

👍 配置参数转换的建议 - 响应参数值转换 String

当响应参数值通过数字或业务不友好的字符串表达某些状态时，3Chat Agent 无法通过数字来推测具体的状态描述

例如：订单状态："orderStatus" : 5，需要指定 5 = "已发货"。"orderStatus" : "SHIP"，需要指定 SHIP  = "已发货"

配置参数值转换

👍 配置参数转换的建议 - 响应参数值转换 Datetime

当响应参数通过时间戳的格式表达一个具体的时间时，3Chat Agent 无法通过读取时间戳来获取实际时间，需要指定转换类型为 Datetime，把时间戳转换为标准 UTC 时间

指定转换类型为 Datetime

保存并运行工具

当完成上述配置后，点击保存数据并运行此工具，3Chat Agent 即可在生产环境使用此工具处理客户的咨询。当不需要此工具被 3Chat Agent 访问时，操作暂停停止此工具即可。

无需复杂技术对接，一键开启跨境电商智能化

如果您也想搭建这样的AI客服，欢迎留言或联系我们。

通过3Chat.ai，客服将不再是被动应对咨询的"接线员"，而是能够主动引导用户、提供个性化服务、实现业务增长的"智能伙伴" 。立即预约演示，体验AI如何为您的业务注入新的活力！

✅ 免费15天高级版体验

✅ 专属提示词模板库

✅ 一对一部署指导

您准备好用AI革新您的跨境流程了吗？

📞 联系我们获取定制化解决方案

📩 邮箱：contact@3chatai.com

🌐 官网：www.3chatai.cn