ドキュメント - Twinkle Hub

1. API キーを取得

/login → Google または GitHub でワンクリックサインイン。初回サインインで自動的に仮想 API キー（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 で見えるキーに置き換え。Claude を再起動 — 5 つの opendata-* ツールが表示されます。

4. 何を尋ねるか

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

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

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

5. 料金

近日対応

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

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

6. 削除方法

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（Windows：%APPDATA%\Claude\claude_desktop_config.json）を編集、mcpServers 下の twinkle-hub エントリを削除、保存して Claude Desktop を再起動。

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

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