MCP 疑難排解
找出連線問題的下一個處理步驟。
無法連線至託管用戶端
檢查設定的 URL 是否為 https://mcp.altifigence.com/cloud-mcp,並確認用戶端支援搭配 OAuth 的 Streamable HTTP。請遵循連線指南與目前資格驗證狀態。伺服器健康狀態頁面與 OAuth 中繼資料,不證明特定用戶端已完成授權。
結果 | 下一步 |
|---|---|
HTTP 401 | 若授權到期或遭撤銷,請重新連線 Altifigence Cloud;再次完成用戶端授權流程 |
HTTP 403 | 檢查已同意的組織、目前專案存取與工具政策;組織啟用工具後,以所需權限重新連線 |
工具清單空白或缺少工具 | 檢查已發布目錄、組織明確核准及每個工具的新同意;重新整理舊權杖無法加入工具 |
工作區讀取不可用 | 在 Cloud 檢查工作區狀態與存取;就緒後再重試 |
缺少執行工具 | 要求新的 |
缺少寫入工具 | 要求新的 |
檔案變動衝突 | 再次讀取清單與檔案,檢閱並行變更,再使用目前修訂版本提交預定變更 |
專案建立或 Git 變動未確認 | 重試前檢查專案清單、儲存庫或遠端狀態;重複建立、提交或推送可能產生非預期效果 |
專案刪除已接受 | 追蹤專案/工作區狀態直到清理完成;已接受不代表已完成 |
Git 提供者傳輸遭拒 | 檢查所選儲存庫、分支與目前提供者連線;工具無法繞過提供者權限 |
執行階段操作未確認 | 讀取執行階段狀態並保留操作 ID;繼續操作使用已停止執行階段的操作 ID |
專案世代、檔案版本或政策已變更 | 取得新的估算,並檢閱其所選方案與用量政策 |
提交未確認 | 檢查同一個工作 ID;只以完全相同的引數與同一個 ID 重試 |
結果尚未就緒 | 再次要求結果前先讀取工作狀態 |
點數不足 | 在 Cloud 檢閱組織的帳務狀態 |
HTTP 413 | 將要求縮減至探索到的工具結構描述中的引數 |
本機工具回傳 HTTP 501 | 已安裝的執行階段沒有實作此操作;僅探索到功能不代表支援 |
HTTP 503 | 等待服務復原;保留設定的端點 |
讀取要求不會啟動或重新啟動專案。未知或未授權的工具名稱不會啟用編輯或執行。重試前請修正連線或存取條件;不要在引數中提供替代憑證。
要求過多
若回應包含 HTTP 429,請等待 Retry-After 指定的時間再重試。避免重複註冊或登入嘗試。
聯絡支援
請聯絡Altifigence 支援,提供已移除敏感資訊的用戶端名稱、版本、問題時間與錯誤訊息。不要包含憑證、Cookie 或專案內容。
復原時避免重複工作
失敗位置 | 重試前應檢查的內容 |
|---|---|
身分或探索 | 用戶端版本、端點、登入/工作階段,以及已同意的工具清單。 |
檔案讀取續接 | 檔案與清單版本;快照變更時重新開始。 |
檔案寫入、提交或推送 | 目前已儲存檔案、儲存庫與遠端狀態。 |
工作提交 | 既有工作 ID 與狀態;保留原始身分。 |
終端機輸入或 AI 要求 | 目前工作階段/輸出;不要自動重播輸入。 |
記錄最小可重現要求,以預留位置代替專案資料。保留錯誤代碼、HTTP 狀態、顯示的要求識別碼與時間戳記。分享診斷前,請移除權杖與原始碼內容。