10-minute setup

We package Twinkle Hub as a Claude Desktop one-click installer (.mcpb) — download → double-click → paste your sk-... key → done. No editing of claude_desktop_config.json required.

Double-click the downloaded twinkle-hub.mcpb. Claude Desktop opens an install dialog, asks for your API key (grab it from the dashboard), and you're done.

Want to edit by hand? Open this file:

• 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-..."
      }
    }
  }
}

Replace sk-... with the key you see on your dashboard. Restart Claude — the Twinkle Hub tools will appear.

Claude Code ships with a claude mcp add command:

claude mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
  --header "Authorization: Bearer sk-..."

Free allowance, rate limits and how the plans differ are all on the pricing page. When the allowance runs out, the gateway rejects calls until it refills, then resumes on its own — nothing to reset.

Want to pause? Here's how to remove the Twinkle Hub MCP from each client. Your API key isn't revoked — you can re-add it any time.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json), delete the twinkle-hub entry under mcpServers, save, and restart Claude Desktop.

Claude Code

claude mcp remove twinkle-hub

Want to fully close your account?

The above only disconnects the client; your hub account and API key remain. To fully remove your account + data, go to /account/security and request deletion (72-hour grace period).