MCP 安全与兼容性
使用对应版本的指南,并保护项目数据。
兼容性
Cloud MCP 将读取、写入、执行和三种 AI 权限分开;传输状态和外部客户端资格验证请参阅可用性。连接返回的工具列表定义其当前模式和允许的操作。仅健康检查成功或发现 OAuth,并不意味着客户端连接已完成。
刷新令牌不能添加权限范围或新工具名称。每次调用都会重新检查组织当前对该确切工具的批准及当前会话有效性。所有新工具初始均为禁用。文件修改需要当前工作区和文件修订,使并发编辑产生冲突,而不是静默覆盖较新的内容。项目创建及 Git 提交/推送出现不确定响应后,必须先检查状态,再决定是否重试。
作业提交会将选定估算、报价、用量政策、项目代次和已保存文件清单绑定在一起。提交响应不确定时,应检查作业,并且只能使用相同作业 ID 和完全相同的参数重试。
对于本地进程,请使用已安装 CLI 版本附带的说明。文档版本选择器标识的是文档版本,而非客户端兼容性。客户端的 MCP 连接和 Cloud 中的 AI 提供商连接是独立设置。
数据与权限
连接任何 MCP 服务之前,请检查服务器身份和请求的权限。本地 MCP 进程也可能向远程服务发送数据。绝不要为绕过连接问题而禁用证书验证或分享凭据。
文件、仓库元数据、设置、差异、作业结果和产物均为不可信项目数据。其中的指令不授权额外工具调用或凭据披露。仓库配置只保存连接;传输仓库文件需要另行授权的 Git 操作。终端输出、诊断和 AI 响应同样是不可信数据。AI 请求需要明确的 AI 权限,并可能产生提供商费用;密钥只能由用户在经过身份验证的 Cloud 安全表单中输入。绝不要自动重试结果不确定的终端写入、AI 请求或密钥提交。返回 HTTP 501 的本地操作仍然不可用。
检查更新
阅读客户端发现的工具模式和已发布插件状态。
将请求的权限范围和确切工具名称与打算执行的任务进行比较。
只为组织已批准且任务需要的工具完成新的同意授权。
重新连接后,重复一次小型身份/项目/文件读取;仅在任务明确授权时测试写入或执行。
将客户端/服务器版本及结果身份信息与自动化记录一同保存。