云原生智能网关 MCP 包体采集

MCP 网关默认记录访问日志,但不包含工具调用的请求与响应内容。当需要对工具调用做审计留痕、故障定位或效果回放时,可开启包体(Body)采集,将 MCP 调用的请求入参与响应结果写入日志。

相关产品
云原生智能网关 产品页,含版本规格、价格与购买入口。

一、操作场景

开启后可采集 tools/call 的入参 arguments 与返回结果 content,同时覆盖 initialize、tools/list、resources/list、resources/read、prompts/list、prompts/get、ping 等方法;notifications/* 类单向通知不采集。采集到的日志可在 LLM Log 的 MCP 页签按链路 ID、工具名称检索,也可投递到日志服务 CLS 做结构化分析。

典型场景包括:核保类 Agent 调用外部工具后需要区分是入参错误还是服务端返回异常;车企座舱 Agent 调用车控工具需要投诉取证;医疗与政企场景需要满足合规留痕要求。

二、前提条件

·已创建 AI 网关实例,并已开通 MCP 网关能力。

·已创建 MCP 服务。

·开启前请确认工具调用内容不含高敏感个人信息(如身份证号、密码等),且日志存储与访问权限符合企业数据合规要求。

注意:开启包体采集后,请求中的 arguments 与响应中的 content 会写入日志。请在确认内容合规后再开启。

三、方式一:新建 MCP 服务时开启包体采集

1. 登录 AI 网关控制台,选择目标 AI 网关实例进入详情页面,在左侧导航栏单击 MCP 网关 > MCP 服务。

2. 单击新建,进入新建 MCP 服务向导。

3. 在高级设置中,将请求包体采集(Request Body)的开关切换为开启。

4. 在弹出的开启请求包体采集(Request Body)对话框中,勾选全部三项确认项:

·已知晓该 MCP Server 的用户请求内容将被记录。

·日志存储及访问权限符合数据合规要求。

·不涉及记录高敏感个人信息(如身份证号、密码等)。

5. 三项全部勾选后,单击确认开启。开关点亮并展开截断长度配置。

6. 设置截断长度,取值范围 512 ~ 1048576 字节,默认 32768 字节,可通过 − / + 以 1024 字节为步长调整。

7. 如需采集响应内容,按同样方式开启响应包体采集(Response Body)并设置截断长度。

8. 填写其余基本信息后,单击下一步继续完成后端服务配置与会话管理,最后单击保存。

四、方式二:为已有 MCP 服务开启包体采集

1. 在 MCP 服务列表,单击目标 MCP 服务名称,进入服务详情页。

2. 单击安全合规页签,找到包体采集配置区域。

3. 按需开启请求包体采集与响应包体采集,并完成合规确认与截断长度设置。

4. 单击保存。

五、步骤2:查看采集到的包体日志

1. 在左侧导航栏单击可观测性 > LLM Log。

2. 单击 MCP 页签,查看 MCP 调用日志列表,列表展示时间、Method、工具、TraceID、状态码、耗时等信息。

3. 按 trace_id、tool_name 或 mcp_server_id 检索目标调用。

4. 单击某条日志的详情,查看 Request Body 与 Response Body 内容。

注意:说明:

注意:请求与响应通过 trace_id 绑定,日志类型分别为 mcp_request 与 mcp_response。日志默认留存 90 天,可配置。

六、步骤3:投递日志到 CLS(可选)

1. 在左侧导航栏单击可观测性 > 日志投递。

2. 勾选 MCP 访问日志,指定日志集与日志主题。

3. 完成投递配置后,在 CLS 中按字段做检索、仪表盘与告警配置。

七、采集配置

字段名 说明 默认值
请求包体采集(Request Body) 是否采集请求入参,按 MCP 服务维度开关 关闭
响应包体采集(Response Body) 是否采集响应结果,按 MCP 服务维度开关 关闭
截断长度 单条包体保留的最大字节数,请求与响应独立配置 32768 字节

八、截断长度取值范围

项 取值
最小值 512 字节
最大值 1048576 字节(1 MB)
步长 1024 字节
越界提示 取值范围:512 ~ 1048576 字节

九、采集方法范围

类型 方法
采集 initialize、tools/list、tools/call、resources/list、resources/read、prompts/list、prompts/get、ping
不采集 notifications/*

十、Request Body 落库字段

字段 类型 说明
jsonrpc string JSON-RPC 版本
mcp_method string MCP 方法名
tool_name string 工具名称
arguments object 工具入参
cursor string 分页游标(可选)
trace_id string 链路 ID

十一、Response Body 落库字段

字段 类型 说明
jsonrpc string JSON-RPC 版本
id any 调用 ID
is_error bool 是否错误
content array 内容块(text / image / resource)
tool_name string 工具名称
error.code int 错误码(MCP 标准)
error.message string 错误描述
赞 (0)
上一篇 4天前
下一篇 4天前