Ceum 可以連結外部工具——如 Claude Desktop、Cursor 或你自己的代理程式——讓它們代你讀取與更新資料。每一個連結都使用一個你建立的 MCP 權杖。整合頁面是你管理這些權杖並留意它們動向的地方。
此頁面是關於以權杖連結外部工具。Ceum 自家的應用程式內助理 Rocky 不需要權杖——你可在助理設定啟用它能做的事。
權杖管理
此頁面會列出你既有的權杖,並包含:
- 名稱——你的標籤(例如「Claude Desktop」、「My Cursor setup」)。
- 權杖前綴——前幾個字元,讓你能分辨不同權杖。
- 上次使用——權杖上次發出呼叫的時間。
- 建立時間——你建立它的時間。
動作:
- 建立權杖——選擇名稱,然後設定其權限與範圍(如下);完整的權杖只會顯示一次,以便你複製。之後無法再取得,因此請在關閉對話框前複製。
- 編輯——隨時重新命名權杖或變更其權限與範圍。權杖字串本身永不改變。
- 撤銷——關閉該權杖。已撤銷的權杖無法再連結,但其過往活動會保留,以便你仍可檢視。
此清單預設隱藏已撤銷的權杖。切換即可連同各權杖的撤銷時間一併顯示它們。
權限與範圍
建立或編輯權杖時,你同時決定它能做什麼以及它能對什麼做這件事。授予工具所需的最低限度,能避免外洩或行為失常的權杖觸及你工作區的其餘部分。
工具權限
權限是個別工具的允許清單,依領域分組(任務、專案、客戶、文件等等)。新權杖一開始會授予所有權限;取消勾選工具不需要的部分。
- 全部讀取 / 全部寫入——頂部的兩個切換會一次翻轉所有領域的每個唯讀工具,或每個會變更資料的工具。
- 讀取 / 寫入(依領域)——相同的劃分,但限於單一領域。
- 個別工具一律可逐一勾選。
權杖只能呼叫你授予它的工具;其他一律遭拒。
資源範圍
範圍將權杖限定於特定的客戶與/或專案。權杖預設具有完整存取——它可對所有內容採取行動,包括沒有客戶或專案的項目(例如未指派的任務)。關閉完整存取以加以限制,便會出現兩個獨立維度:
- 客戶——設為所有客戶(不受限),或設為特定客戶的嚴格允許清單。
- 專案——設為所有專案,或設為特定專案的嚴格允許清單。
兩者皆為嚴格允許清單:一旦某維度設為「特定」,便只有你加入的內容可觸及。記錄必須同時滿足兩個維度才在範圍內——因此它必須隸屬於一個被允許的客戶且一個被允許的專案(維持為「所有」的維度則不檢查)。
留意重疊。 由於兩個維度都必須符合,將不相重疊的某客戶與某專案列入白名單,意味著完全沒有記錄符合——權杖看不到任何東西。若你只想以專案限定範圍,請將客戶維持為「所有」(反之亦然)。在受限維度上缺少連結的記錄(專案受限時沒有專案的任務)同樣不在範圍內。
範圍外的任何內容皆不可見且不可觸及:清單只回傳範圍內的記錄,而以 ID 對範圍外記錄採取行動會回傳「超出範圍」錯誤。受限權杖只有在其專案維度為「所有」時才能建立新專案,只有在其客戶維度為「所有」時才能建立新客戶。
範圍在記錄連結至客戶或專案的每個地方都會強制執行:客戶、專案、任務、文件、交易、時間記錄、任務留言(透過其父任務)、關係(兩端點),以及工作區搜尋與行事曆動態(只回傳範圍內項目)。它也涵蓋連結本身——將任務加入專案、將專案加入客戶,或將時間記錄加入任務,都要求記錄與其所連結的對象皆在範圍內。沒有客戶/專案連結的東西——行事曆事件、訂閱,以及狀態、任務類型與標籤等工作區層級的設定——無論範圍為何皆保持可用。
連結外部工具
此頁面會顯示常見工具可直接貼上的設定片段,包括 Claude Desktop 與 Cursor。複製你工具的片段,填入你的權杖,工具便會連結至 Ceum。
檢視 MCP 事件
你可以檢視透過連結的工具所做的每一項變更——請參閱工作階段與 MCP 事件。它會記錄所採取的動作、由哪個權杖執行、受影響的記錄,以及時間,讓你能精確稽核你的工具變更了什麼。
工作流程
連結 Claude Desktop
- 從整合頁面建立權杖,並命名為類似「Claude Desktop」的名稱。
- 趁權杖顯示時複製完整權杖——這是你唯一的機會。
- 將設定片段貼入 Claude Desktop 的設定中並填入你的權杖。
- 重新啟動 Claude Desktop。權杖的 上次使用 會在它首次呼叫後更新。
稽核可疑的變更
開啟MCP 事件頁面並縮小至變更發生的日期範圍。找出造成該變更的動作,再與記錄自身的歷程交叉比對(請參閱實體變更紀錄)以查看完整的變更前後。
輪替權杖
先建立新權杖,將你的工具切換過去,並確認它能運作。然後撤銷舊的那個。對任何你認為可能已外洩的權杖都加以撤銷。
提示與特殊情況
- 權杖無法再次顯示。 若你遺失權杖,請建立新的。
- 過往活動在撤銷後留存。 撤銷權杖不會抹除它做過的事——其先前的動作仍會以其舊名稱出現。
- MCP 事件會保留至你的帳號存在為止。
- 任務狀態與類型可透過 MCP 限定專案範圍。 建立/更新任務狀態與任務類型的工具接受
allProjects與scopedProjectIds,而list_task_statuses會回傳它們——因此連結的工具既能設定也能讀取逐專案範圍。將狀態或類型指派給超出其專案範圍的任務會遭拒,並附上指明違規專案的訊息。
在行動裝置上
行動應用程式無法使用——請從網頁應用程式管理。