連線至 MCP
連線用戶端前先檢查可用性。
代管連線
Cloud MCP 使用 https://mcp.altifigence.com/cloud-mcp,搭配 Streamable HTTP 與 OAuth。設定用戶端前,請先查看 可用性與用戶端資格驗證。
在用戶端的遠端 MCP 連線設定中加入精確端點。
完成 Account 登入,並在同意頁面審閱組織與請求的 Cloud 權限。OAuth 憑證由用戶端管理。
初始化連線,並重新整理用戶端工具清單。只有目前允許的 Cloud 工具 會出現。
具備讀取權限時,先讀取身分與專案清單。使用傳回的專案 ID 讀取專案與檔案;讀取檔案需要已就緒的工作區。
若要變更專案、檔案、設定或 Git,請要求
https://mcp.altifigence.com/cloud.write並重新完成同意流程。組織必須明確允許每個工具。變更已儲存檔案前,先讀取目前專案與檔案修訂版;遇到不確定的變更回應後,請先檢查狀態,再決定是否重試。執行階段生命週期、終端機動作或作業,請要求
https://mcp.altifigence.com/cloud.execute權限並重新完成同意流程。Cloud 上的已儲存 RTL 分析尚未向客戶開放。請參閱工具工作流程。可用性取決於服務版本,以及組織的執行階段與工具政策。個人 AI 連線僅要求 帳戶安全 所列的必要 AI 範圍,取得組織工具核准並重新完成同意流程。使用傳回的安全設定 URL,讓使用者直接在 Cloud 輸入提供者金鑰。請求 AI 回應前,審閱選取的提供者、模型、脈絡與可能費用。
新的工具名稱需要重新同意,包括現有權限中的新工具。重新整理舊權杖不會新增它們。主控台選取的專案不是授權授予。變更授權組織需要新的同意。讀取請求不會啟動已停止的專案。請勿在連線設定加入帳戶權杖、瀏覽器 Cookie 或 AI 提供者金鑰。
如果初始化或授權失敗,請使用 疑難排解。請勿改為將協定請求送至網站根目錄或其他設定檔。
已安裝軟體
對於本機 XLS 工具,請使用已驗證的 Linux CLI,並設定 ALTI_MCP_MODE=local-xls。設定方式請參閱 CLI。此模式不使用客戶 Cloud 派送機制。 本機與代管連線的差異請參閱 MCP 概觀。
驗證首次讀取
請用戶端讀取已連線的 Altifigence 帳戶與組織。
列出可存取專案,並選取傳回的專案 ID。
讀取選取專案的狀態。如果檔案讀取無法使用,請確認所選專案、存取權限以及 Cloud 中的目前儲存/服務狀態。啟動執行階段是獨立的執行動作;一般的已儲存檔案存取不需要啟動個人執行階段。
列出檔案並選取傳回的路徑。讀取完整內容,必要時依續讀位移繼續。
要求摘要包含專案、路徑與已儲存修訂版。使用連線進行較大工作前,先與 Cloud 比對。
範例請求:「列出我的 Altifigence Cloud 專案。讀取我選取專案中的 README,再摘要其設定步驟,並指出使用的已儲存檔案。」此請求符合已發布的讀取範圍,並明確指定目標。