> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 사용 정책 & 요금

> REST API·MCP·CLI의 인증, 무료·유료 범위, rate limit을 한곳에서 안내해요.

REST API·MCP·CLI를 어떤 조건으로 쓸 수 있는지, 무엇이 무료이고 무엇이 유료인지 안내해요.

## 인증

REST API·MCP·CLI는 모두 같은 자격 증명 체계를 써요.

* **API Key**: `{id}.{secret}` 형식의 Bearer 토큰. REST·MCP·CLI에서 모두 동작해요.
* **JWT**: MCP는 OAuth로 발급된 JWT도 받아요. (대화형 AI 클라이언트용)

로그인 수단과 **무관**해요. Google·Apple·Microsoft·기업용 SSO 중 무엇으로 가입했든, 유효한 API Key나 토큰만 있으면 똑같이 쓸 수 있어요.

자세한 발급·사용법은 [인증](/ko/developers/fundamentals/authentication)을 참고하세요.

### 키는 누가 발급하나요

[platform.tiro.ooo](https://platform.tiro.ooo)에서 **어떤 플랜에서든** API Key를 발급할 수 있어요. 팀 키는 **팀 관리자**만 발급할 수 있어요.

## 무엇이 무료이고 무엇이 유료인가

대부분의 엔드포인트는 **무료**예요. 노트·폴더·공유 링크·문서 템플릿·스크립트·단어장 조회에는 크레딧이 들지 않아요.

<Note>
  위키 엔드포인트는 유료 플랜이 필요해요. 개인 워크스페이스는 **Pro 이상** 플랜, 팀 워크스페이스는 **Team 이상** 플랜이어야 해요. 자격이 없는 플랜에서 호출하면 `402 Payment Required`를 받아요.
</Note>

위키 게이트는 REST와 MCP에 동일하게 적용돼요 (MCP `search_wiki`·`get_wiki_page`·`list_wiki_mentions`·`get_wiki_graph`).

| 응답 코드                      | 발생 조건                                          | 해결                             |
| -------------------------- | ---------------------------------------------- | ------------------------------ |
| `402` `WIKI_PLAN_REQUIRED` | 워크스페이스 플랜이 위키를 쓸 수 없는 등급 (Free·Lite·구독 없음·비활성) | 개인은 Pro 이상, 팀은 Team 이상으로 업그레이드 |
| `402` `WIKI_NOT_ACTIVATED` | 플랜은 되지만 관리자가 위키를 켜지 않음                         | 워크스페이스 관리자가 위키 기능을 활성화         |

<Info>
  음성 인식(STT)과 대량 LLM 처리에 대한 과금은 아직 API·MCP를 통해서는 발생하지 않아요.
</Info>

## Rate limit

API Key 하나당 **60초에 600 요청**까지 보낼 수 있어요. 초과하면 `429 Too Many Requests`를 받고, 응답에 다시 시도할 시점을 알려주는 `Retry-After`와 `X-RateLimit-*` 헤더가 담겨요.

자세한 응답 형식은 [에러 처리](/ko/developers/fundamentals/error-handling)를 참고하세요.