Twinkle HubTwinkle Hub
로그인

문서

10 분 셋업

Twinkle Hub는 MCP 엔드포인트 — 모든 MCP 클라이언트가 연결 가능. 자신에게 맞는 경로를 선택하세요.

AI 사용자Claude / 코드 불필요CLI 도구Claude Code / Copilot CLI / Codex CLI개발자curl / SDK / 앱에 통합

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 도메인
  • 「영국 data.gov.uk에서 NHS 관련 데이터셋을 검색해 최신 10건을 나열해줘」→ realestate_land 도메인
  • 「FRED에서 미국 실업률 시계열을 가져와 최근 5년을 비교해줘」→ procurement 도메인

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

6. 요금

곧 제공

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

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

7. 제거 방법

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

Claude Code

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

text
claude mcp remove twinkle-hub

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

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