Tiro API
프로그래밍 방식으로 노트 조회·검색, 음성 파일 처리, 웹훅을 통한 연동을 할 때 사용해요. → API 개발자 문서에서 인증 방법, API Key 발급, 엔드포인트, 웹훅 이벤트를 확인하세요.Tiro MCP
Claude 등 MCP(Model Context Protocol)를 지원하는 AI 에이전트에서 Tiro 노트와 위키를 컨텍스트로 바로 활용할 때 사용해요. AI 에이전트에 “이번 주 미팅 내용 요약해줘”라고 요청하면 바로 답변받을 수 있어요. → Claude(브라우저·데스크톱 앱)나 ChatGPT에 연결하려면 스크린샷과 함께 단계별로 안내하는 티로를 AI와 연결하기를 따라 주세요. → Claude Code·Codex·Cursor 등 개발 도구 연결과 도구 명세는 개발자 문서의 클라이언트별 MCP 설정과 MCP 도구 명세를 확인하세요.Tiro CLI
터미널에서 Tiro 노트를 검색하고 트랜스크립트를 내려받을 때 사용해요. MCP 서버를 연결할 수 없는 자동화 스크립트나 CI 환경에서 유용합니다. → CLI 설치 및 사용법을 개발자 문서에서 확인하세요.앱 화면 용어와 API 분류 맞춰 보기
API·MCP에서 노트 내용은 요약(summary)·전사(transcript)·생성 문서(documents) 세 종류로 나뉘어요. 앱 화면에서 부르는 이름과 분류 이름이 달라서, 아래 표대로 맞춰 조회해야 원하는 내용이 나와요.documents에는 템플릿으로 만든 문서만 담겨요. 한 페이지 문서는 요약(summary)이라서 documents로 조회하면 나오지 않아요. 버그가 아니라 분류 차이예요.
search_notes로 먼저 좁힌 뒤 필요한 노트만 전사를 가져오세요.
전사가 중간까지만 나올 때
구독이 없는 상태에서 무료 이용 시간을 넘긴 노트는 넘긴 지점부터 전사가 가려진 채로 나와요. 가려진 문단은locked: true로 표시되고, 글자 수와 줄 모양은 그대로인 채 내용만 다른 글자로 바뀌어 있어요. 구독을 시작하면 잠금이 풀리고 원래 전사가 그대로 나와요. 자세한 내용은 노트 데이터 모델을 참고하세요.
자주 묻는 질문
누구나 사용할 수 있나요?
네, 모든 플랜에서 쓸 수 있어요. 로그인 방법도 가리지 않아요. 구글·애플·마이크로소프트·이메일(비밀번호)·기업용 SSO(Enterprise SSO) 가운데 어느 방식으로 가입했든 API·MCP·CLI를 똑같이 사용할 수 있어요. 인증이 로그인 방식과 별개인 API Key나 토큰으로 이뤄지기 때문이에요.API Key는 어디서 발급하나요?
Tiro 계정이 있으면 platform.tiro.ooo/me/api-keys의 API Key 화면에서 계정 API Key를 발급할 수 있어요. 특정 플랜 이상이어야 발급되는 제한은 없어요. 계정 API Key는 현재 접근할 수 있는 모든 워크스페이스에서 내 권한으로 동작해요. 워크스페이스 공용 키는 그 워크스페이스에서 키 발급 권한이 있을 때 발급돼요. 웹에서는 설정 사이드바 맨 아래 [개발자] 그룹의 [개발자 센터] 항목을 누르면 새 탭으로 열려요. 데스크탑 앱을 쓴다면 브라우저 주소창에platform.tiro.ooo를 입력해 바로 들어가면 돼요.
추가 과금이 있나요?
아니요. 티로 API·MCP·CLI는 추가 과금이 없어요. 티로 요금은 음성을 텍스트로 바꾸는 처리(STT)와 대량 AI(LLM) 사용량을 기준으로 매겨지는데, API·MCP·CLI는 이미 만들어진 노트와 트랜스크립트를 조회하고 검색할 뿐 새로 STT나 AI 생성을 일으키지 않기 때문이에요. 다만 과도한 호출을 막기 위한 호출 한도(rate limit)가 있고, 한도를 넘으면 잠시 후 다시 시도하면 돼요.앞으로 파일 업로드나 실시간 녹음을 처리하는 API가 추가되면, 그 기능은 STT·AI 사용을 일으킬 수 있어 따로 안내하고 과금될 수 있어요.
관련 페이지: 위키 · Ask Tiro · 티로를 AI와 연결하기