REST API
REST API
노트, 전사, 요약을 조회하고 Webhook을 연동해요.
MCP ServerMCP Server
Claude, ChatGPT, Cursor에서 Tiro 노트를 사용해요.
API Key 발급
Tiro Platform API Keys 페이지로 이동해 계정 API Key를 생성하세요. 계정 API Key는 현재 접근할 수 있는 모든 워크스페이스에서 사용자와 같은 권한으로 동작해요.1
로그인
platform.tiro.ooo/me/api-keys로 이동하세요.
2
계정 API Key 생성
Create New API Key를 클릭하세요. 점(.)을 포함한 전체 키를 복사하세요 —
abc123.xR7mK9pL2qW4....3
저장
환경 변수로 저장하세요. 생성 대화 상자를 닫으면 다시 볼 수 없어요.
워크스페이스 찾기
노트는 워크스페이스 안에 있어요.GET /v1/external/workspaces로 접근 가능한 워크스페이스 목록을 받고, 응답의 workspaces 배열에서 원하는 항목의 guid 값을 골라두세요 — 아래에서 workspaceGuid로 씁니다.
워크스페이스 없이 호출하는
GET /v1/external/notes는 워크스페이스 개수와 무관하게 deprecated 엔드포인트입니다(하위 호환을 위해 계속 동작해요). 워크스페이스가 하나뿐이더라도 항상 GET /v1/external/workspaces/{workspaceGuid}/notes를 쓰세요.첫 요청 보내기
앞 단계에서 고른 워크스페이스guid로 노트 목록을 가져옵니다.
guid가 담겨 있어요.
이제 목록을 얻었으니 노트 데이터 모델을 읽고 각 guid로 무엇을 할 수 있는지 알아보세요 — 전사, 요약, 문서, 폴더까지요.