连接 MCP

连接客户端前检查可用性。

托管连接

Cloud MCP 使用 https://mcp.altifigence.com/cloud-mcp,采用 Streamable HTTP 和 OAuth。配置客户端前,请查看 可用性与客户端验收。

  1. 在客户端的远程 MCP 连接设置中添加精确端点。

  2. 完成 Account 登录,并在同意页面检查组织及请求的 Cloud 权限。OAuth 凭据由客户端管理。

  3. 初始化连接,并刷新客户端工具列表。只会显示当前允许的 Cloud 工具。

  4. 获得读取权限后,先读取身份及项目列表。使用返回的项目 ID 读取项目和文件;文件读取要求工作区就绪。

  5. 更改项目、文件、设置或 Git 时,请请求 https://mcp.altifigence.com/cloud.write 并重新完成同意授权。组织必须明确允许每个工具。更改已保存文件前,读取当前项目及文件修订;修改响应不确定时,先检查状态,再决定是否重试。

  6. 对于运行时生命周期、终端操作或作业,请请求 https://mcp.altifigence.com/cloud.execute 权限并重新完成同意授权。Cloud 上的已保存 RTL 分析尚未向客户开放。请参阅工具工作流。可用性取决于服务版本及组织的运行时和工具策略。

  7. 对于个人 AI 连接,仅请求 账户安全 中列出的所需 AI 范围,获得组织工具批准,并重新完成同意授权。使用返回的安全设置 URL,让用户直接在 Cloud 中输入提供商密钥。请求 AI 响应前,检查所选提供商、模型、上下文及可能产生的费用。

新工具名称需要重新同意授权,包括现有权限中的新工具。刷新旧令牌不会添加它们。控制台中所选项目不构成授权。更改授权组织需要新的同意授权。读取请求不会启动已停止的项目。请勿将账户令牌、浏览器 cookie 或 AI 提供商密钥加入连接配置。

初始化或授权失败时,请使用 故障排除。请勿回退为向网站根目录或其他配置发送协议请求。

已安装软件

对于本地 XLS 工具,请使用经过验证的 Linux CLI,并设置 ALTI_MCP_MODE=local-xls。设置方法请参阅 CLI。此模式不使用客户 Cloud 调度机制。 参阅 MCP 概述,了解本地与托管连接的差异。

验证首次读取

  1. 请客户端读取已连接的 Altifigence 账户和组织。

  2. 列出可访问项目,并选择返回的项目 ID。

  3. 读取选定项目的状态。如果文件读取不可用,请确认所选项目、访问权限以及 Cloud 中的当前存储/服务状态。启动运行时是单独的执行操作;普通的已保存文件访问不需要启动个人运行时。

  4. 列出文件,并选择返回的一个路径。读取完整内容,必要时按续读偏移继续。

  5. 请求一份包含项目、路径及已保存修订的摘要。在将连接用于更多工作前,先与 Cloud 核对。

示例请求:“列出我的 Altifigence Cloud 项目。读取我所选项目中的 README,然后概括设置步骤,并指出所使用的已保存文件。”此请求处于已发布读取范围内,且明确了目标。