MCP 疑難排解

找出連線問題的下一個處理步驟。

無法連線至託管用戶端

檢查設定的 URL 是否為 https://mcp.altifigence.com/cloud-mcp,並確認用戶端支援搭配 OAuth 的 Streamable HTTP。請遵循連線指南與目前資格驗證狀態。伺服器健康狀態頁面與 OAuth 中繼資料,不證明特定用戶端已完成授權。

結果

下一步

HTTP 401

若授權到期或遭撤銷,請重新連線 Altifigence Cloud;再次完成用戶端授權流程

HTTP 403

檢查已同意的組織、目前專案存取與工具政策;組織啟用工具後,以所需權限重新連線

工具清單空白或缺少工具

檢查已發布目錄、組織明確核准及每個工具的新同意;重新整理舊權杖無法加入工具

工作區讀取不可用

在 Cloud 檢查工作區狀態與存取;就緒後再重試

缺少執行工具

要求新的 cloud.execute 同意,並檢查版本、組織政策與專案執行階段存取

缺少寫入工具

要求新的 cloud.write 同意,並檢查組織明確的工具與專案權限

檔案變動衝突

再次讀取清單與檔案,檢閱並行變更,再使用目前修訂版本提交預定變更

專案建立或 Git 變動未確認

重試前檢查專案清單、儲存庫或遠端狀態;重複建立、提交或推送可能產生非預期效果

專案刪除已接受

追蹤專案/工作區狀態直到清理完成;已接受不代表已完成

Git 提供者傳輸遭拒

檢查所選儲存庫、分支與目前提供者連線;工具無法繞過提供者權限

執行階段操作未確認

讀取執行階段狀態並保留操作 ID;繼續操作使用已停止執行階段的操作 ID

專案世代、檔案版本或政策已變更

取得新的估算,並檢閱其所選方案與用量政策

提交未確認

檢查同一個工作 ID;只以完全相同的引數與同一個 ID 重試

結果尚未就緒

再次要求結果前先讀取工作狀態

點數不足

在 Cloud 檢閱組織的帳務狀態

HTTP 413

將要求縮減至探索到的工具結構描述中的引數

本機工具回傳 HTTP 501

已安裝的執行階段沒有實作此操作;僅探索到功能不代表支援

HTTP 503

等待服務復原;保留設定的端點

讀取要求不會啟動或重新啟動專案。未知或未授權的工具名稱不會啟用編輯或執行。重試前請修正連線或存取條件;不要在引數中提供替代憑證。

要求過多

若回應包含 HTTP 429,請等待 Retry-After 指定的時間再重試。避免重複註冊或登入嘗試。

聯絡支援

請聯絡Altifigence 支援,提供已移除敏感資訊的用戶端名稱、版本、問題時間與錯誤訊息。不要包含憑證、Cookie 或專案內容。

復原時避免重複工作

失敗位置

重試前應檢查的內容

身分或探索

用戶端版本、端點、登入/工作階段,以及已同意的工具清單。

檔案讀取續接

檔案與清單版本;快照變更時重新開始。

檔案寫入、提交或推送

目前已儲存檔案、儲存庫與遠端狀態。

工作提交

既有工作 ID 與狀態;保留原始身分。

終端機輸入或 AI 要求

目前工作階段/輸出;不要自動重播輸入。

記錄最小可重現要求,以預留位置代替專案資料。保留錯誤代碼、HTTP 狀態、顯示的要求識別碼與時間戳記。分享診斷前,請移除權杖與原始碼內容。