10 分鐘​完成​接入

我們將 Twinkle Hub 打包為 Claude Desktop 的一鍵安裝檔（.mcpb）— 下載後雙擊，貼上您的 sk-... key 即可完成​安裝，​無需​手動​編輯 claude_desktop_config.json。

雙擊​下載的 twinkle-hub.mcpb，Claude Desktop 將彈出​安裝對話框，請輸入 API key（可從 dashboard 取得），​按下確認即可完成。

想自訂​設定？請編輯此檔案：

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

請將 sk-... 替換為您 dashboard 上顯示的 key。​重啟 Claude 後，​Twinkle Hub 的工具即可使用。

Claude Code 內建 claude mcp add 指令：

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

免費額​度、​速率​限制與各方案​差異都整理在定價頁。額度用盡時 gateway 會​先攔下​呼叫，​回補後自動​恢復，​不需要做任何​設定。

想暫停使用？​以下是各 client 移除 Twinkle Hub MCP 的方式。您的 API key 不會被回收，​未來若想重新​使用，​直接​加回​設定​即可。

Claude Desktop

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows 為 %APPDATA%\Claude\claude_desktop_config.json），​刪除 mcpServers 中的 twinkle-hub 段落，​存檔後重啟 Claude Desktop。

Claude Code

claude mcp remove twinkle-hub

想徹底​刪除​帳號？

上述操作僅​移除 client 端​設定，​hub 帳號與 API key 仍保留。​若需​完整刪除帳號與資料，請前往 /account/security 申請​刪除​（72 小時寬限期）。

下面每一條都來自​實際​發生過的呼叫​錯誤。​左邊是你會​看到的訊息，​下面是原因與做法。