Docs - Twinkle Hub

1. 取得 API key

/login → 支援 Google 或 GitHub 一鍵登入。首次登入將自動發放一支虛擬 API key (sk-...)。新帳號預設餘額為 0，信用卡自助儲值功能即將開放。

2. Twinkle Hub Desktop Extension

我們將 Twinkle Hub 打包為 Claude Desktop 的一鍵安裝檔（`.mcpb`）— 下載後雙擊，貼上您的 sk-... key 即可完成安裝，無需手動編輯 claude_desktop_config.json。

⬇ 下載 Twinkle Hub for Claude Desktop

雙擊下載的 twinkle-hub.mcpb，Claude Desktop 將彈出安裝對話框，請輸入 API key（可從 dashboard 取得），按下確認即可完成。

想查看「手動編輯設定檔」的步驟？下方 Claude Desktop 段落仍保留相關說明。

3. Claude Desktop

想自訂設定？請編輯此檔案：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

text

{
  "mcpServers": {
    "twinkle-hub": {
      "type": "http",
      "url": "https://api.twinkleai.tw/mcp/",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}

請將 sk-... 替換為您 dashboard 上顯示的 key。重啟 Claude 後，5 個 opendata-* tool 即可使用。

4. 試試問問看

挑選一個問題試試看（支援中英文）：

「查詢臺北市最近 30 天的 PM2.5 紀錄，並繪製趨勢圖」→ environment domain
「在英國 data.gov.uk 搜尋 NHS 相關資料集，列出最新 10 筆」→ realestate_land domain
「取得 FRED 的美國失業率時間序列，比較近五年趨勢」→ procurement domain

詳見 /data，包含完整 20 個 domain 的 scope 與典型問題。

5. 計費

即將開放

核心工具現已免費——每 5 小時 50 credits，滾動回補（另有每週 500 上限）。免費方案 query_rows 每次最多回傳 10 筆。深度語意搜尋與全文件取回保留給即將推出的 Pro；Pro 定價將於計費前公佈。

呼叫費用每 5 小時扣除 50 credits，額度會滾動回補（另有每週 500 筆上限）。免費方案 query_rows 每次最多回傳 10 筆。深度語意搜尋與全文件取回為 Pro 專屬功能。額度用盡後，gateway 將攔截呼叫，待額度回補後即可恢復。

6. 如何移除

想暫停使用？以下是各 client 移除 Twinkle Hub MCP 的方式。您的 API key 不會被回收，未來若想重新使用，直接加回設定即可。

Claude Desktop

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows 為 %APPDATA%\Claude\claude_desktop_config.json），刪除 mcpServers 中的 twinkle-hub 段落，存檔後重啟 Claude Desktop。

想徹底刪除帳號？

上述操作僅移除 client 端設定，hub 帳號與 API key 仍保留。若需完整刪除帳號與資料，請前往 /account/security 申請刪除（72 小時寬限期）。