문서 - Twinkle Hub

1. API 키 받기

/login → Google 또는 GitHub로 원클릭 로그인. 첫 로그인 시 가상 API 키 (sk-...)가 자동 발급됩니다. 신규 계정은 잔액 0부터 시작 — 카드 충전 곧 지원.

2. Twinkle Hub Desktop Extension

Twinkle Hub를 Claude Desktop 원클릭 설치 파일 (`.mcpb`)로 패키지화 — 다운로드 → 더블 클릭 → sk-... key 붙여넣기 → 완료. claude_desktop_config.json 편집 불필요.

⬇ Twinkle Hub for Claude Desktop 다운로드

다운로드한 twinkle-hub.mcpb을 더블 클릭. Claude Desktop이 설치 대화 상자를 열고 API key를 요청 (dashboard에서 가져오기), 완료.

수동 설정 편집을 선호? 아래 Claude Desktop 절에 해당 단계가 보존되어 있습니다.

3. Claude Desktop

수동 편집을 원하시나요? 이 파일을 여세요:

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

text

{
  "mcpServers": {
    "twinkle-hub": {
      "type": "http",
      "url": "https://api.twinkleai.tw/mcp/",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}

sk-...를 dashboard에서 보이는 키로 교체. Claude를 재시작 — 5 개의 opendata-* 도구가 표시됩니다.

4. 무엇을 물을까

하나 골라서 시도해 보세요 (한국어 또는 대만 번체로 동작):

「타이베이의 지난 30 일 PM2.5 측정값을 보여주고 트렌드를 차트화해 주세요」→ environment 도메인
「이 구의 NT$50M 초과 부동산 거래를 나열해 주세요」→ realestate_land 도메인
「올해 정부 조달 계약 금액 기준 상위 10」→ procurement 도메인

/data에 19 개 카테고리 전체 스코프와 전형적인 질문이 있습니다.

5. 요금

곧 제공

알파 기간 동안 모든 도구 무료. 과금 시작 전 도구별 가격을 공지하고, 기존 사용자에게 전환 할인 기간을 제공합니다.

알파 기간 동안 모든 호출 무료. 과금 시작 후 각 호출의 비용은 /usage에 몇 초 안에 표시되고, 지갑이 0이 되면 게이트웨이가 자동 거부 — 깜짝 청구 없음.

6. 제거 방법

일시 정지하고 싶으신가요? 각 클라이언트에서 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 재시작.

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

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