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é.
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.
Claude Code (CLI)
Claude Code intègre une commande claude mcp add :
claude mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \ --header "Authorization: Bearer sk-..."
Tarifs
Allocation gratuite, limites de débit et différences entre les forfaits : tout est sur la page Tarifs. Une fois l’allocation épuisée, la gateway refuse les appels jusqu’à ce qu’elle se recharge, puis reprend d’elle-même — rien à réinitialiser.
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 ~/ (Windows : %APPDATA%\), supprimez l'entrée twinkle-hub sous mcpServers, sauvegardez et redémarrez Claude Desktop.
Claude Code
claude mcp remove twinkle-hubVous 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).
Dépannage
Chaque entrée ci-dessous provient d'un appel qui a réellement échoué en production.
Please reconnect to Twinkle Hub…
You called an individual tool name directly (for example tw_search_datasets). This service exposes four tools; individual tools are dispatched through execute_tool.
Call execute_tool instead, with the tool name in tool_id and its parameters in arguments.
Unknown tool_id
That name does not exist — usually an old one. In August 2026 every Taiwan tool gained a tw_ prefix and the old names were not kept.
Use discover_tools, describe the data you want in plain language, and take the current name from the result.
filters[0].field is not a queryable column of this dataset
The field in a filter must be a column that this particular dataset actually has, and the columns differ from dataset to dataset.
Call tw_get_dataset first to see the columns; the error also lists them in details.allowed_columns.
Unrecognised parameter: ['columns']
A parameter name is wrong — commonly columns instead of select, or a name carried over from SQL.
Use the parameter list the error prints; call inspect_tool when you are unsure of a tool's shape.
Out of credits / plan limit reached
Two different situations: credits exhausted (402) waits for the refill or a top-up; a plan limit (409) needs a subscription change or an upgrade.
Read the error code first — 402 and 409 have different fixes, and topping up will not clear a 409.
Semantic search is temporarily paused (reindexing)
Semantic search over judgments pauses occasionally while its index is rebuilt. Keyword search stays available and covers more recent months.
Switch to keyword search: put your terms in jfull_contains, optionally narrowed by court_code and year.