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 outils Twinkle Hub 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
- 「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.
5. 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.
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).