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에서 보이는 키로 교체. 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가 회복될 때까지 호출을 막고, 회복되면 자동으로 다시 열립니다. 따로 설정할 것은 없습니다.

일시 정지하고 싶으신가요? 각 클라이언트에서 Twinkle Hub MCP를 제거하는 방법입니다. API 키는 무효화되지 않아 언제든 다시 추가할 수 있습니다.

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

계정을 완전히 닫으시려나요?

위는 클라이언트 연결 해제만; hub 계정과 API 키는 남아 있습니다. 계정 + 데이터를 완전히 삭제하려면 /account/security에서 삭제를 요청하세요 (72 시간 유예 기간).