MCP 接入与安全

Model Context Protocol（MCP）是一套连接 AI 应用与外部系统的开放协议。兼容客户端可以通过 MCP Server 获取上下文、调用工具或使用预定义提示，而不必为每一种数据源单独设计接入协议。

MCP 如何工作

一个 MCP Host 可以连接多个 MCP Server，并为每个 Server 创建独立的 MCP Client。

MCP 分为数据层和传输层：数据层定义 JSON-RPC 消息、能力发现和 Primitives；传输层负责消息如何在本地进程或网络之间传递。客户端通常会封装这些协议细节，接入时应优先使用客户端提供的 MCP 配置入口。

Server 可以提供什么

MCP Server 主要暴露三类 Primitives：

Server 会声明自己支持的能力，客户端再发现可用的 Tools、Resources 和 Prompts。Server 提供某项能力不代表客户端一定会启用；最终行为还取决于 Host 的版本、权限策略和用户选择。

选择传输方式

当前 MCP 规范定义了 stdio 和 Streamable HTTP 两种标准传输。

对于 stdio，Server 的 stdout 只能输出 MCP 消息，日志应写入 stderr。出现连接失败时，可以检查客户端捕获的 stderr 日志，但不要把包含凭证的完整日志发送给第三方。

当前 Streamable HTTP 使用单一 POST Endpoint，不需要单独配置 GET 或旧式 HTTP+SSE 地址。认证方式由 Server 决定；如果 Server 提供 OAuth 流程，应优先按照其授权页面完成认证，而不是把长期凭证直接写入共享配置。

理解配置结构

不同客户端的字段名称和配置位置并不完全相同。下面只展示常见结构，不能直接运行；请使用 Server 发布者提供的真实命令、参数、URL 和认证方式替换所有占位符。

{
  "mcpServers": {
    "replace-with-server-name": {
      "command": "/absolute/path/to/server-command",
      "args": [
        "--replace-with-required-argument"
      ],
      "env": {
        "SERVICE_API_KEY": "replace-with-client-supported-secret-reference"
      }
    }
  }
}

安全接入步骤

权限审查清单

对于远程 Server，只连接可信 HTTPS 地址并按其认证流程授权。对于本地 Server，优先使用绝对命令路径、隔离目录和普通用户权限，不要为了方便直接使用管理员权限运行。

常见问题

持续使用建议

• 定期复查已连接的 Server、版本、Tool 清单和授权范围；
• 为不同 Server 使用独立、可撤销、最小权限的凭证；
• 保持人工确认，尤其是删除、写入、付款、消息发送和生产系统操作；
• 不把未知 Resource 或 Tool 结果中的指令当作可信系统指令；
• 日志、截图和错误报告必须移除 Key、Token、客户数据和敏感路径；
• 停止使用 Server 时，从客户端移除配置并撤销相关凭证。

需要为模型客户端配置 AGTCloud 时，请从 CC-Switch 集成教程开始，或在左侧“第三方集成”目录中选择具体工具；需要理解模型端点和请求字段时，请查看 API Reference。MCP 的协议细节和版本变化请以 MCP 官方文档为准。