문서 - Twinkle Hub

1. API 키 받기

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

CLI 한 줄 설치 (3 가지 중 선택): 아래 세 가지(Claude Code / GitHub Copilot CLI / Codex CLI) 중 개발 환경에 맞는 것을 선택, 명령 한 줄로 완료. 세 CLI의 문법이 다르므로 해당 절의 스니펫을 복사하세요.

2. Claude Code (CLI)

Claude Code에는 claude mcp add 명령이 포함되어 있습니다:

text

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

3. GitHub Copilot CLI

GitHub Copilot CLI는 copilot mcp add 명령을 사용 (동일한 --transport http + --header 패턴):

text

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

4. Codex CLI

OpenAI Codex CLI는 환경변수로 토큰을 전달합니다 (Claude Code/Copilot의 --header 패턴과 다름) — 먼저 export한 뒤 codex mcp add:

text

export TWINKLE_HUB_API_KEY=sk-...
codex mcp add twinkle-hub --url https://api.twinkleai.tw/mcp/ \
  --bearer-token-env-var TWINKLE_HUB_API_KEY

Codex 첫 실행 시 MCP client for twinkle-hub timed out after 30 seconds 가 표시되면, 기본 30초 startup timeout이 콜드 스타트에 부족한 것입니다 — ~/.codex/config.toml을 열어 [mcp_servers.twinkle-hub] 블록에 startup_timeout_sec = 60 한 줄을 추가하세요. 두 번째 실행부터는 보통 5초 이내에 연결되므로 나중에 되돌릴 수 있습니다:

text

[mcp_servers.twinkle-hub]
startup_timeout_sec = 60

5. 무엇을 물을까

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

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

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

6. 요금

곧 제공

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

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

7. 제거 방법

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

Claude Code

Claude Code에는 원샷 제거 명령이 있습니다:

text

claude mcp remove twinkle-hub

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

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