Tiro에 연결하는 방법은 두 가지예요. 백엔드에서 프로그래밍 방식으로 접근하는 REST API, 그리고 Claude나 ChatGPT 같은 AI 클라이언트를 위한 MCP Server예요.
API 키 발급
Tiro Platform API Keys 페이지 로 이동해 키를 생성하세요.
키 생성
Create New API Key 를 클릭하세요. 점(.)을 포함한 전체 키 를 복사하세요 — abc123.xR7mK9pL2qW4....
저장
환경 변수로 저장하세요. 생성 대화 상자를 닫으면 다시 볼 수 없어요.
API 키는 환경 변수에 저장하세요. 절대 하드코딩하거나 커밋하지 마세요.
첫 요청 보내기
노트를 가져와 볼게요.
cURL
Node.js
Python
Go
Kotlin + Spring
curl -H "Authorization: Bearer $TIRO_API_KEY " \
-H "Content-Type: application/json" \
https://api.tiro.ooo/v1/external/notes
Tiro는 노트 목록을 페이지네이션된 형태로 반환해요. 각 객체에는 제목, 생성 날짜, 처리 상태, 그리고 전사·요약·문서를 가져올 때 사용하는 guid가 담겨 있어요.
이제 목록을 얻었으니 노트 데이터 모델 을 읽고 각 guid로 무엇을 할 수 있는지 알아보세요 — 전사, 요약, 문서, 폴더까지요.