1. 取得 API key
/login → 支援 Google 或 GitHub 一鍵登入。首次登入將自動發放一支虛擬 API key (sk-...)。新帳號預設餘額為 0，信用卡自助儲值功能即將開放。
使用 CLI 一鍵安裝（三選一）：以下三節（Claude Code / GitHub Copilot CLI / Codex CLI）請依開發環境選擇其一，一行指令即可完成安裝。各指令模式不同，請複製對應段落的指令。
2. Claude Code (CLI)
Claude Code 內建 claude mcp add 指令：
claude mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
--header "Authorization: Bearer sk-..."3. GitHub Copilot CLI
GitHub Copilot CLI 使用 copilot mcp add 指令（同樣採用 --transport http 與 --header 模式）：
copilot mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
--header "Authorization: Bearer sk-..."4. Codex CLI
OpenAI Codex CLI 透過環境變數傳遞 token（與 Claude Code/Copilot 的 --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。請開啟 ~/.codex/config.toml，在 [mcp_servers.twinkle-hub] 段落新增一行 startup_timeout_sec = 60 即可（後續啟動通常 5 秒內即可完成，可再調回原值）：
[mcp_servers.twinkle-hub]
startup_timeout_sec = 605. 試試問問看
挑選一個問題試試看（支援中英文）：
- 「查詢臺北市最近 30 天的 PM2.5 紀錄，並繪製趨勢圖」→ environment domain
- 「在英國 data.gov.uk 搜尋 NHS 相關資料集，列出最新 10 筆」→ realestate_land domain
- 「取得 FRED 的美國失業率時間序列，比較近五年趨勢」→ procurement domain
詳見 /data，包含完整 20 個 domain 的 scope 與典型問題。
6. 計費
即將開放
核心工具現已免費——每 5 小時 50 credits，滾動回補（另有每週 500 上限）。免費方案 query_rows 每次最多回傳 10 筆。深度語意搜尋與全文件取回保留給即將推出的 Pro；Pro 定價將於計費前公佈。
呼叫費用每 5 小時扣除 50 credits，額度會滾動回補（另有每週 500 筆上限）。免費方案 query_rows 每次最多回傳 10 筆。深度語意搜尋與全文件取回為 Pro 專屬功能。額度用盡後，gateway 將攔截呼叫，待額度回補後即可恢復。
7. 如何移除
想暫停使用？以下是各 client 移除 Twinkle Hub MCP 的方式。您的 API key 不會被回收，未來若想重新使用，直接加回設定即可。
Claude Code
Claude Code 提供 claude mcp remove 指令，可一鍵移除：
claude mcp remove twinkle-hub想徹底刪除帳號？
上述操作僅移除 client 端設定，hub 帳號與 API key 仍保留。若需完整刪除帳號與資料，請前往 /account/security 申請刪除（72 小時寬限期）。