Claude Code 与 Cloud MCP

区分客户端配置、Cloud 授权与成功的已保存文件读取。

Cloud MCP 使用远程 HTTP 端点 https://mcp.altifigence.com/cloud-mcp. 已配置的服务器、已授权的账号和成功的工具读取是各自独立的检查项。可用性取决于客户端和您的 Cloud 组织的工具策略。

检查客户端与端点

当已安装的 Claude Code CLI 支持远程 HTTP MCP 服务器时,其配置命令具有以下形式。使用前请先确认已安装 CLI 的帮助信息(help)和预期配置范围。

claude mcp add --transport http altifigence https://mcp.altifigence.com/cloud-mcp

当已配置的服务器在 Claude Code 的 /mcp 界面中可用时,客户端可以提供账号授权。账号、组织和请求的范围均属于该授权。DDS 设置页面不能证明此客户端已完成授权。仅凭回调(callback)不能确立已成功获得 Cloud 工具访问权限。

在 DDS 中检查连接可用性

  1. 使用 QUOTA 打开 DDS 设置,并选择 Developer access。

  2. 查看 Overview 中所选的项目,以及对账号登录、组织同意和权限的要求。

  3. 选择 Open setup 打开 Developer tools。阅读所提供的设置信息和 Documentation 链接。

  4. 展开 Details。查看 MCP endpoint、Transport、Authentication 和权限标签。显示的传输方式为 Streamable HTTP。

Details 表格是工具名称和权限类别的参考信息。连接实际发现的工具和当前授权决定访问权限;仅凭参考信息不会启用工具。

Context, search & connections 是用于上下文、Web search 和 AI 连接的独立设置页面。这些控件不是 Cloud MCP 的授权同意界面。Developer tools 在此主机中可能仅显示设置信息,而不提供外部授权会话。

当连接公开读取工具时

已连接的 Cloud 账号可在以下范围下公开身份标识、可访问项目和已保存文件读取:cloud.read. 从该连接返回的项目中,成功读取一个不含敏感信息的小型文件,即可证明不仅完成了服务器配置。项目/文件标识、分页、分块(chunk)完成状态和版本定义了实际读取的内容。如果没有所需的当前组织策略和授权同意,被拒绝的工具仍不可用。

将内部人员 DX 保持区分

内部人员 DX 端点以 /dx-mcp 结尾。其组织插件和员工设备登录流程不会配置客户 Cloud 访问权限。切勿用 DX 设备验证码流程替代 Cloud 授权,且不得将内部人员范围与 cloud.* 范围混用。

如果连接失败

如果客户端拒绝某个命令选项,请查阅其已安装的帮助信息。被拒绝的回调、缺失的工具或被拒绝的读取,与 DDS 工作区不可用属于不同原因。请保留脱敏后的错误信息并使用 MCP 故障排除。令牌、浏览器 Cookie 和授权码不应放入共享项目配置中。

相关指南

连接指南 · Authentication · 工具参考 · 故障排除