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.
2. Twinkle Hub Desktop Extension
Nous empaquetons Twinkle Hub comme un installateur Claude Desktop en un clic (`.mcpb`) — téléchargez → double-cliquez → collez votre clé sk-... → terminé. Pas besoin d'éditer claude_desktop_config.json.
Double-cliquez sur le twinkle-hub.mcpb téléchargé. Claude Desktop ouvre une boîte de dialogue d'installation, demande votre clé API (récupérez-la depuis le dashboard), terminé.
Vous préférez l'édition manuelle de config ? La section Claude Desktop ci-dessous conserve ces étapes.
3. Claude Desktop
Vous voulez éditer à la main ? Ouvrez ce fichier :
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"twinkle-hub": {
"type": "http",
"url": "https://api.twinkleai.tw/mcp/",
"headers": {
"Authorization": "Bearer sk-..."
}
}
}
}Remplacez sk-... par la clé visible sur votre dashboard. Redémarrez Claude — les 5 outils opendata-* apparaîtront.
4. 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.
5. 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.
6. 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 Desktop
Modifiez ~/Library/Application Support/Claude/claude_desktop_config.json (Windows : %APPDATA%\Claude\claude_desktop_config.json), supprimez l'entrée twinkle-hub sous mcpServers, sauvegardez et redémarrez Claude Desktop.
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).