你看到的情況
透過 MCP 連結至 Ceum 的外部工具——Claude Desktop、Cursor 或自訂用戶端——無法驗證。先前可運作的呼叫開始因權限錯誤而失敗。
發生的原因
最常見的原因：
- 權杖已被撤銷。 有人（可能是稍早的你）在整合中撤銷了該權杖。已撤銷的權杖無法再次使用——需要建立新的權杖。
- 權杖從未被複製。 建立權杖時，其完整值僅顯示一次。若關閉該對話框時未複製，該值便永久遺失且無法復原。
- 外部工具使用了舊權杖。 你在 Ceum 中建立了新權杖，但外部工具仍設定為先前的權杖。
- 帳戶已被刪除。 若建立權杖者刪除了自己的帳戶，其所有權杖也隨之消失。權杖屬於單一帳戶。
- 外部工具設定錯誤。 它指向錯誤的位址，或連線設定方式不正確。
- 工具未獲授權，或記錄超出範圍。 權杖僅具有你授予的工具，而具範圍限制的權杖僅限於特定客戶及／或專案。對未授予的工具，或對權杖範圍外記錄的呼叫，即使權杖本身有效也會被拒絕——請參閱整合與 MCP 以擴大其權限或範圍。
- 具範圍限制的權杖完全看不到任何內容。 範圍要求記錄同時符合客戶與專案規則。若將客戶限制為一組、將專案限制為另一組且兩者不重疊，則沒有記錄能同時滿足兩者，因此一切讀取結果皆為空白或「超出範圍」。請將其中一個維度設回「全部」，或讓兩個允許清單有所重疊。
如何修正
- 開啟整合並在清單中找到該權杖。若它不見了或被標記為已撤銷，即表示不再有效——請建立新的權杖。
- 在關閉對話框前從對話框複製新權杖。該值之後無法取回。
- 以新權杖更新外部工具的設定並重新啟動該工具。
- 在整合頁面檢查權杖的上次使用時間。在外部工具發出呼叫後，該時間應更新——若未更新，表示呼叫並未送達 Ceum。
- 交叉核對工作階段與 MCP 事件中過去一小時內是否有任何成功的呼叫，並與工具本身的錯誤紀錄比對，以找出連線在何處中斷。
提示與特殊情況
- 權杖名稱在撤銷後仍會保留。 較舊的MCP 事件紀錄項目仍會顯示已撤銷權杖的名稱；這是正常現象，並不代表該權杖仍可運作。
- 若懷疑外洩，應主動輪替。 先建立新權杖、切換工具、確認變更可成功送出，再撤銷舊權杖。如此可避免出現兩個權杖都無法運作的空窗期。
- 唯讀呼叫不會被記錄。 即使MCP 事件紀錄中沒有顯示任何內容，權杖在讀取上仍可能運作良好——因此空白的紀錄並不代表它已失效。
- 應用程式內的 CLI 是獨立的。 Ceum 內的 CLI 命令列使用你自己的登入，而非 MCP 權杖，因此絕不會因「權杖已撤銷」之類的原因失敗。
在行動裝置上
行動應用程式不提供此功能——請於網頁應用程式中管理。