---
title: "接入 MCP 前先选对传输：stdio 与 Streamable HTTP 实战检查表"
slug: "mcp-stdio-streamable-http-guide"
kind: "checklist"
version: "1.0"
status: "reviewed"
compatibility: "支持 stdio 或 Streamable HTTP 的 MCP 客户端与服务端；技术基线为 2025-11-25 版传输规范。"
risk_level: "low"
requires_approval: false
updated_at: "2026-10-19T00:23:19.028Z"
verified_at: ""
source: "https://blog.atlankj.com/posts/mcp-stdio-streamable-http-guide"
---

# 目标

核对 MCP 接入方式、定位错误所在层次，完成最小只读验证。

# 前置条件

- 用户已授权查看指定 MCP 配置和脱敏日志。
- 已明确客户端与服务端名称及各自支持的协议版本。
- 已有可用的测试连接；本文不要求新装服务。

# 输入

传输类型、程序路径及参数或 HTTP 端点、环境变量名称、错误信息、可访问的测试对象。

# 约束

- 只执行读取配置、读取脱敏日志、初始化和小范围读取。
- 不输出令牌、Cookie、私有业务数据或完整环境变量值。
- 不开放公网监听，不关闭认证，不改变 Origin 策略。
- 不创建、修改、删除或发布业务内容。
- 如需超出只读检查的操作，先检查是否已有明确授权；缺少授权时暂停该操作。

# 操作步骤

- [ ] 对照官方文档记录实际客户端和服务端版本。
- [ ] 确认使用 stdio 或 Streamable HTTP，避免与旧传输名称混淆。
- [ ] stdio：核对程序路径、参数、环境变量名称及标准错误，检查标准输出是否混入普通日志。
- [ ] HTTP：核对端点、认证机制和脱敏后的响应信息；不要把首页 200 当作成功证据。
- [ ] 使用已配置的客户端完成初始化并查看预期能力。
- [ ] 选择一个已知测试对象，执行一次最小只读调用。
- [ ] 比较实际输出与预期，记录失败所在层次。

# 输出结果

传输选择、客户端兼容性、各层验证结果、脱敏证据与建议修复；未验证的项目单独标记。

# 验证方法

初始化成功、能力符合预期且指定只读调用返回正确对象。仅进程存活或 HTTP 可达时，结论为尚未完成 MCP 验证。

# 异常处理

- 启动失败：检查程序位置、参数与缺失环境变量名称。
- 解析失败：检查 stdio 标准输出污染或 HTTP 响应类型。
- 认证失败：报告状态与缺失配置，不尝试绕过。
- 业务返回错误：保留请求标识和脱敏错误，不扩大数据访问范围。

# 回滚方式

本清单不修改配置或业务内容，无业务回滚操作。若检查启动了专用测试进程，只关闭明确属于本次检查的进程，保留原有服务。

# 参考来源

https://modelcontextprotocol.io/specification/2025-11-25/basic/transports

资料核对：2026-10-19。检查流程为原创建议，未在读者环境联调。