문서 - 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를 재시작 — Twinkle Hub 도구가 표시됩니다.

4. 무엇을 물을까

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

「타이베이의 지난 30 일 PM2.5 측정값을 보여주고 트렌드를 차트화해 주세요」→ environment 도메인
「영국 data.gov.uk에서 NHS 관련 데이터셋을 검색해 최신 10건을 나열해줘」→ realestate_land 도메인
「FRED에서 미국 실업률 시계열을 가져와 최근 5년을 비교해줘」→ procurement 도메인

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

5. 요금

곧 제공

핵심 도구는 현재 무료입니다 — 5시간마다 50 credits, 서서히 회복(주간 500 상한 별도). Free 플랜에서는 query_rows 가 호출당 최대 10 건을 반환합니다. 일부 심층 코퍼스 검색과 전체 문서 조회는 곧 출시될 Pro 플랜 전용이며, 과금 시작 전에 Pro 가격을 공지합니다.

호출은 5시간마다 주어지는 50 credits 에서 차감되며, 서서히 회복됩니다(주간 500 상한 별도). Free 플랜에서는 query_rows 가 호출당 최대 10 건을 반환합니다. 일부 심층 코퍼스 검색과 전체 문서 조회는 Pro 전용입니다. credits 를 모두 사용하면 회복될 때까지 게이트웨이가 호출을 거부합니다.

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 시간 유예 기간).