ドキュメント - Twinkle Hub

1. API キーを取得

/login → Google または GitHub でワンクリックサインイン。初回サインインで自動的に仮想 API キー（sk-...）を発行。新規アカウントは残高 0 から始まります — カードでの入金は近日対応。

CLI でワンライナー（3 つから選択)：以下 3 つ（Claude Code / GitHub Copilot CLI / Codex CLI）から開発環境に合うものを選び、コマンド 1 つで完了。3 つの構文は異なるため、該当節のスニペットをコピーしてください。

2. Claude Code（CLI）

Claude Code には claude mcp add コマンドが付属：

text

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 パターン)：

text

copilot mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
  --header "Authorization: Bearer sk-..."

4. Codex CLI

OpenAI Codex CLI は環境変数でトークンを渡します（Claude Code/Copilot の --header パターンとは異なる）— 先に export、その後 codex mcp add：

text

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

初回起動時に MCP client for twinkle-hub timed out after 30 seconds が出る場合、デフォルトの 30 秒 startup timeout がコールドスタートに足りていません — ~/.codex/config.toml の [mcp_servers.twinkle-hub] ブロックに startup_timeout_sec = 60 を 1 行追加してください。2 回目以降は通常 5 秒以内に接続するので、後で戻せます：

text

[mcp_servers.twinkle-hub]
startup_timeout_sec = 60

5. 何を尋ねるか

どれかを選んで試してみてください（日本語でも台湾繁体字でも動作）：

「台北の過去 30 日の PM2.5 を見せて、トレンドをグラフ化して」→ environment ドメイン
「この区で 5,000 万台湾ドル超の不動産取引を一覧表示」→ realestate_land ドメイン
「今年の政府調達契約、金額順トップ 10」→ procurement ドメイン

/data に 19 カテゴリ全体のスコープと典型的な質問があります。

6. 料金

近日対応

アルファ期間中はすべてのツールが無料。課金開始前にツール単位の料金を発表し、既存ユーザーには移行割引期間を提供します。

アルファ期間中はすべての呼び出しが無料。課金開始後は、各呼び出しのコストが /usage に数秒で表示され、ウォレットがゼロになるとゲートウェイが自動拒否 — サプライズ請求なし。

7. 削除方法

一時停止したい？以下、各クライアントから Twinkle Hub MCP を削除する方法です。API キーは無効化されないので、いつでも再追加可能。

Claude Code

Claude Code には一発削除コマンドがあります：

text

claude mcp remove twinkle-hub

アカウントを完全に閉じたい？

上記はクライアント切断のみ；hub アカウントと API キーは残ります。アカウント + データを完全削除するには /account/security で削除を申請してください（72 時間の猶予期間）。