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
「Cherche sur data.gov.uk les jeux de données liés au NHS et liste les 10 plus récents」→ domaine realestate_land
「Récupère la série du taux de chômage américain depuis FRED et compare les cinq dernières années」→ domaine procurement

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

6. Tarifs

Bientôt

Les outils principaux sont actuellement gratuits — 50 crédits par tranche glissante de 5 heures, rechargés progressivement (plus un plafond de 200 crédits par semaine). Sur le forfait Free, query_rows renvoie au maximum 10 lignes par appel. La recherche sémantique approfondie et la récupération de documents complets sont réservées au prochain forfait Pro ; nous annoncerons les tarifs Pro avant le début de la facturation.

Les appels sont décomptés de vos 50 crédits par tranche glissante de 5 heures, rechargés progressivement (plus un plafond de 200 crédits par semaine). Sur le forfait Free, query_rows renvoie au maximum 10 lignes par appel. La recherche sémantique approfondie et la récupération de documents complets sont réservées à Pro. Une fois vos crédits épuisés, la gateway rejette les appels jusqu'à leur rechargement.

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).