用途:该技能适用于保护客户端与 EP MCP Server 之间的 MCP 网关通信,覆盖基于令牌的身份认证、网关边界处的请求校验与净化、议会数据访问的审计日志配置,以及多服务器 MCP 部署的纵深防御,是身份认证、授权、输入校验和审计日志的主要执行点。
主要能力与规则:要求所有 MCP 客户端连接使用令牌认证(API 密钥、OAuth2 或 mTLS);在转发到后端前按协议模式校验全部入站 MCP 请求;在网关层对工具参数做输入校验与净化;记录每次工具调用的客户端身份、工具名、时间戳和响应状态,但不得记录含个人数据的参数值;密钥与服务令牌需可配置过期并自动轮换;所有连接必须使用 TLS 1.3 并拒绝明文;按已认证客户端身份而非仅 IP 限流;网关到后端的凭据须存于密钥管理器而非配置文件;监控异常请求模式(高频、异常工具、非工作时间访问)并告警或阻断;高安全部署可要求请求签名以保证消息完整性。
用法示例(资料提供):使用 zod 定义 AuthHeaderSchema 校验 Bearer 令牌格式,通过 tokenStore.validate 校验令牌并返回 clientId、tier、allowedTools;用 MCPRequestSchema 严格校验 jsonrpc、id、method、params 等字段;审计日志条目不含参数值与令牌;启动时校验 EP_API_KEY、GATEWAY_TOKEN_SECRET、AUDIT_LOG_ENDPOINT 等必需密钥。
反模式:网关不校验认证、日志中记录令牌或个人数据、源码硬编码密钥。
合规映射:AC-001 认证、AC-003 授权、AU-002 审计、SC-001 传输安全、SM-001 密钥管理、IR-001 异常检测与响应。限制:具体部署环境、实现语言与运行方式暂未提供。