Docs - Twinkle Hub

1. Obtenir une clé API

/login → connexion en un clic avec Google ou GitHub. La première connexion émet automatiquement une clé API virtuelle (sk-...). Les nouveaux comptes démarrent à 0 — recharge par carte bientôt disponible.

Installation en une commande CLI (3 options) : choisissez l'une des trois sections suivantes (Claude Code / GitHub Copilot CLI / Codex CLI) qui correspond à votre environnement de développement — une ligne et c'est fait. Les trois CLI utilisent des syntaxes différentes, copiez l'extrait de la section appropriée.

2. Claude Code (CLI)

Claude Code intègre une commande 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 utilise la commande copilot mcp add (même schéma --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 passe le token via une variable d'environnement (différent du schéma --header de Claude Code/Copilot) — export d'abord, puis 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

Si Codex affiche MCP client for twinkle-hub timed out after 30 seconds au premier lancement, le délai par défaut de 30 s ne suffit pas au démarrage à froid — ouvrez ~/.codex/config.toml et ajoutez startup_timeout_sec = 60 dans le bloc [mcp_servers.twinkle-hub]. Les lancements suivants se connectent généralement en moins de 5 s — vous pourrez le baisser ensuite :

text

[mcp_servers.twinkle-hub]
startup_timeout_sec = 60

5. Quoi demander

Choisissez-en une et essayez (fonctionne en français ou en chinois traditionnel) :

「Montre les relevés PM2.5 de Taipei sur les 30 derniers jours et trace la tendance」→ domaine environment
「Liste les ventes immobilières dans ce district au-dessus de 50 M NT$」→ domaine realestate_land
「Top 10 des marchés publics par montant cette année」→ domaine procurement

/data contient le périmètre complet des 20 catégories et les questions typiques pour chacune.

6. Tarifs

Bientôt

Tous les outils sont gratuits en alpha. Nous annoncerons les tarifs par outil avant le début de la facturation, et les utilisateurs existants auront une période de remise de transition.

Tous les appels sont gratuits pendant l'alpha. À l'arrivée de la facturation, le coût de chaque appel apparaît sur /usage en quelques secondes, et la gateway rejette automatiquement quand le portefeuille atteint zéro — pas de factures surprises.

7. Comment retirer

Vous voulez faire une pause ? Voici comment retirer le MCP Twinkle Hub de chaque client. Votre clé API n'est pas révoquée — vous pouvez la réajouter à tout moment.

Claude Code

Claude Code dispose d'une commande de suppression rapide :

text

claude mcp remove twinkle-hub

Vous voulez fermer votre compte complètement ?

Ce qui précède déconnecte juste le client ; votre compte hub et votre clé API restent. Pour supprimer compte + données complètement, allez sur /account/security et demandez la suppression (délai de grâce 72h).