在 Claude、ChatGPT、Codex 使用 Codey 刻典
1. 開始之前
- 有效的 Codey 刻典律所帳號(帳號狀態啟用中)。【待確認:是否需事先開通 MCP】
- 連接器網址:
https://mcp.thecodey.com/mcp
- 認證:OAuth 2.0(動態用戶端註冊 DCR、PKCE S256)。你不需要建立 API key 或 client secret。
2. 從 Claude 連接
目錄上架後(建議)
- 在 Claude 開啟「設定 → 連接器(Connectors)」。【待確認選單名稱】
- 瀏覽目錄,搜尋「Codey 刻典」,按「連接」。
- 跳出 Codey 授權頁後,依第 4 節登入並同意。
- 回到 Claude,在對話中啟用 Codey 即可開始使用。
上架前/自訂連接器
- 「設定 → 連接器 → 新增自訂連接器」。【待確認:Team/Enterprise 方案需由組織管理員新增】
- 名稱填
Codey 刻典,URL 填 https://mcp.thecodey.com/mcp。
- 按「連接」,完成第 4 節登入。
【待補:截圖 ×3】
3. 從 ChatGPT 與 Codex 連接
ChatGPT
- 開啟 ChatGPT「設定 → 應用程式/外掛(Apps/Plugins)」。【待確認選單名稱】
- 搜尋「Codey 刻典」,按「連接」或「安裝」。
- 完成第 4 節登入後回到 ChatGPT。【待確認:Business/Enterprise 工作區是否需管理員先核准此外掛】
Codex
- 在 Codex 的外掛目錄安裝「Codey 刻典」,首次使用時會開啟瀏覽器進行登入。【待確認實際流程】
- 或手動加入遠端 MCP:例如
codex mcp add codey --url https://mcp.thecodey.com/mcp,再依提示登入。【待確認:以 Codex 現行 CLI 指令為準】
【待補:截圖 ×3】
4. OAuth 登入流程
- AI 用戶端開啟 Codey 授權頁(
mcp.thecodey.com)。
- 輸入你的 Codey 帳號 email 與密碼。【待確認:是否支援 Google/Microsoft 登入】
- 確認授權後自動導回 AI 用戶端。
- 登入狀態最長維持 7 天,之後可能需要重新授權。
注意:
- 只在
mcp.thecodey.com 的頁面輸入 Codey 密碼;不要把密碼貼進 AI 對話。
- 連續輸錯密碼多次,帳號會被暫時鎖定。【待確認:是否公開「5 次/15 分鐘」】
- 事務所訂閱狀態異常時,可能無法登入或續期。
5. 連接器可以做什麼
所有動作都以你的身分、在你的 Codey 權限內執行。共 61 支工具:讀取 30、寫入 16、破壞性寫入 15、混合 0。
| 類別 |
可以這樣問 |
動作類型 |
| 案件 |
「找出星辰貿易的案件,摘要目前狀態」 |
讀;新增/更新案件為寫入 |
| 客戶 |
「列出合作模式為法律顧問的客戶」 |
讀;新增/更新客戶為寫入 |
| 任務 |
「列出已逾期的任務」「新增任務給陳律師」 |
讀/寫;刪除不可復原 |
| 行事曆 |
「我下週有哪些庭?」「把 11/5 的庭改到 11/6」 |
讀/寫;刪除不可復原,且會一併刪除其下任務 |
| 文件 |
「找檔名有『和解書』的文件」 |
讀(只搜中繼資料,不搜內文);送交客戶 Portal 為對外動作 |
| 客戶 Portal |
「讀取這個案件和客戶的對話」 |
讀;傳訊息給客戶為對外動作 |
| 通知 |
「我有幾則未讀通知?」 |
讀;標記已讀為寫入 |
| 知識庫 |
「查所內上訴期間的算法」 |
讀;提議新增筆記為寫入 |
| 管理(需權限) |
「新增案件分類『智財』」「邀請新成員」 |
讀/寫;停用成員、刪除分類等為破壞性 |
不能做的事:法源檢索(判決、法條)、讀取檔案內文、上傳檔案、新增文件註記、存取其他事務所資料、瀏覽網路。
關於 list_case_threads:讀取客戶 Portal 對話不會自動建立討論串。若還沒有討論串,list_case_threads 回傳空結果。要建立討論串請使用另一支寫入工具 create_case_thread(已存在則回傳既有的,不會傳訊息)。
確認機制:刪除、傳訊給客戶、送交文件、停用成員等動作,設計上會先列出對象請你確認。請在確認前核對案件、客戶與內容;送交給客戶的訊息與文件無法撤回。
6. 中斷連線與撤銷授權
- Claude:「設定 → 連接器 → Codey 刻典 → 中斷連線」。【待確認選單】
- ChatGPT:「設定 → 應用程式/外掛 → Codey 刻典 → 中斷連線/移除」。【待確認選單】
- Codex:移除外掛,或
codex mcp remove codey。【待確認指令】
- 中斷後,連接器端快取的 token 會在 7 天內自動過期。需要立即撤銷(例如裝置遺失),請來信 [email protected]。【待確認:是否提供使用者自助「撤銷所有 AI 連線」功能】
- 變更 Codey 密碼【待確認:是否會讓既有 MCP session 失效】。
7. 資料與刪除
- 連接器不保存你的案件、客戶、文件、訊息內容;只暫存登入 token(7 天)、授權碼(10 分鐘)與流量限制計數器(60 秒)。
- 事務所資料存在貴所的 Codey 後端。要查閱、更正或刪除,請透過貴所管理員或 Codey 帳號處理。
- 你在 AI 對話中看到的內容,會依 Anthropic 或 OpenAI 的政策存於該服務的對話紀錄;請在該服務內刪除。
- 依個資法行使權利:[email protected]。
- 詳見《MCP 連接器隱私權政策》:https://mcp.thecodey.com/privacy
8. 疑難排解
| 狀況 |
處理 |
| 授權頁一直轉圈或逾時 |
重新整理後再試;持續發生請來信並附時間。 |
| 顯示「需要重新登入」 |
token 已過期,重新連接即可。 |
| AI 說找不到案件 |
確認案號或客戶名稱,或確認你在 Codey 對該案件有權限。 |
| 管理類動作被拒 |
你的角色缺少對應權限,請洽貴所管理員。 |
【待補:客戶成功助理】常見錯誤訊息對照表。
9. 聯絡支援
[email protected]|支援頁【待確認 URL】