Codex CLI
OpenAI Codex CLI 透過環境變數傳遞 token（與 Claude 的 --header 模式不同），先執行 export 再執行 codex mcp add：
export TWINKLE_HUB_API_KEY=sk-...
codex mcp add twinkle-hub --url https://api.twinkleai.tw/mcp/ \
--bearer-token-env-var TWINKLE_HUB_API_KEY若首次啟動 Codex 時出現 MCP client for twinkle-hub timed out after 30 seconds，表示預設的 30 秒 startup timeout 不足以應付 cold‑start。請開啟 ~/，在 [mcp_servers.twinkle-hub] 段落新增一行 startup_timeout_sec = 60 即可（後續啟動通常 5 秒內即可完成，可再調回原值）：
[mcp_servers.twinkle-hub]
startup_timeout_sec = 60計費
免費額度、速率限制與各方案差異都整理在定價頁。額度用盡時 gateway 會先攔下呼叫，回補後自動恢復，不需要做任何設定。
如何移除
想暫停使用？以下是各 client 移除 Twinkle Hub MCP 的方式。您的 API key 不會被回收，未來若想重新使用，直接加回設定即可。
想徹底刪除帳號？
上述操作僅移除 client 端設定，hub 帳號與 API key 仍保留。若需完整刪除帳號與資料，請前往 /account/security 申請刪除（72 小時寬限期）。
疑難排解
下面每一條都來自實際發生過的呼叫錯誤。左邊是你會看到的訊息，下面是原因與做法。
Please reconnect to Twinkle Hub…
你直接用個別工具名稱呼叫（例如 tw_search_datasets）。本服務只公開四支工具，個別工具要透過 execute_tool 派送。
改用 execute_tool，把工具名放進 tool_id、參數放進 arguments。
找不到這個 tool_id
這個名稱不存在，通常是舊名。2026 年 8 月所有台灣工具加上了 tw_ 前綴，舊名不再保留。
用 discover_tools 以自然語言描述你要找的資料，取得目前的名稱。
filters[0].field 不是這個資料集可查的欄位
篩選條件的 field 必須是該資料集實際存在的欄位名，而每個資料集的欄位都不一樣。
先用 tw_get_dataset 看欄位清單；錯誤訊息的 details.allowed_columns 也會列出可用欄位。
不認得的參數：['columns']
參數名稱打錯了。常見的是把 columns 當成 select、或沿用 SQL 的習慣命名。
照錯誤訊息列出的「可用的參數」改；不確定參數形狀時用 inspect_tool 查。
點數不足 / 已達方案上限
兩種不同的狀況：點數用完（402）要等額度回補或儲值；方案額度已滿（409）要調整訂閱或升級。
先看錯誤碼再決定——402 和 409 的解法不一樣，儲值不會解決 409。
語意檢索暫停服務中（索引重整）
判決的語意檢索偶爾會因為重建索引而暫停，此時關鍵字檢索仍然可用，而且涵蓋的月份更新。
改用關鍵字檢索：把要找的詞放進 jfull_contains，可再搭配 court_code 與年份縮小範圍。