인증
REST API·MCP·CLI는 모두 같은 자격 증명 체계를 써요.- API Key:
{id}.{secret}형식의 Bearer 토큰. REST·MCP·CLI에서 모두 동작해요. - JWT: MCP는 OAuth로 발급된 JWT도 받아요. (대화형 AI 클라이언트용)
키는 누가 발급하나요
platform.tiro.ooo에서 어떤 플랜에서든 API Key를 발급할 수 있어요. 팀 키는 팀 관리자만 발급할 수 있어요.무엇이 무료이고 무엇이 유료인가
대부분의 엔드포인트는 무료예요. 노트·폴더·공유 링크·문서 템플릿·스크립트·단어장 조회에는 크레딧이 들지 않아요.위키 엔드포인트는 유료 플랜이 필요해요. 개인 워크스페이스는 Pro 이상 플랜, 팀 워크스페이스는 Team 이상 플랜이어야 해요. 자격이 없는 플랜에서 호출하면
402 Payment Required를 받아요.search_wiki·get_wiki_page·list_wiki_mentions·get_wiki_graph).
| 응답 코드 | 발생 조건 | 해결 |
|---|---|---|
402 WIKI_PLAN_REQUIRED | 워크스페이스 플랜이 위키를 쓸 수 없는 등급 (Free·Lite·구독 없음·비활성) | 개인은 Pro 이상, 팀은 Team 이상으로 업그레이드 |
402 WIKI_NOT_ACTIVATED | 플랜은 되지만 관리자가 위키를 켜지 않음 | 워크스페이스 관리자가 위키 기능을 활성화 |
음성 인식(STT)과 대량 LLM 처리에 대한 과금은 아직 API·MCP를 통해서는 발생하지 않아요.
Rate limit
API Key 하나당 60초에 600 요청까지 보낼 수 있어요. 초과하면429 Too Many Requests를 받고, 응답에 다시 시도할 시점을 알려주는 Retry-After와 X-RateLimit-* 헤더가 담겨요.
자세한 응답 형식은 에러 처리를 참고하세요.