操作场景
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 会写入日志。请在确认内容合规后再开启。
操作步骤
步骤1：开启包体采集
方式一：新建 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 | 错误描述 |
