메인 콘텐츠로 건너뛰기
Tiro MCP 서버는 https://mcp.tiro.ooo/mcp에 있어요. 사용하는 클라이언트를 골라 단계를 따라가면 연결돼요. 각 클라이언트마다 권장 인증 방식이 있고, 대부분 대체 방식도 지원해요.
아직 API key가 없으신가요? Tiro Platform API Keys 페이지에서 만드세요. key는 abc123.xR7mK9pL2qW4... 형태이고, 점(.)을 포함한 전체 문자열을 복사하세요. 대시보드에는 참고용으로 “Key ID”(예: abc123)가 표시되지만, Bearer token은 생성 시 단 한 번만 보이는 전체 문자열이에요. 잃어버리면 새로 생성하세요.

Scopes

scope는 MCP 서버가 사용자를 대신해 접근할 수 있는 범위를 정의해요. 현재 API key는 자동으로 모든 scope를 부여받아요.
Scope설명
mcp:notes:read노트, transcript, 요약, 문서, 템플릿 읽기
mcp:folders:read사용자 및 팀 폴더 구조 검색
세분화된 scope 선택은 아직 제공되지 않아요. 인증된 모든 연결은 전체 접근 권한을 받아요. 세밀한 scope 제어는 향후 릴리스에 계획되어 있어요.

API key 종류

Key Type생성 주체접근 범위
Personal API Key모든 사용자본인의 노트, 요약, 문서, 개인 폴더
Team API Key팀 관리자팀 폴더, 팀 공유 노트
어떤 key가 필요한가요? 대부분 personal API key로 시작해요. 팀 폴더의 노트를 포함해 접근 권한이 있는 모든 노트를 검색하고 읽을 수 있어요. 팀 전용 폴더 구조를 검색하려면 team API key를 사용하세요.
API key는 Tiro Platform API Keys 페이지에서 폐기하지 않는 한 만료되지 않아요. key는 주기적으로 교체하고, 개발용과 운영용으로 별도의 key를 사용하기를 권장해요. OAuth token은 180일간 유효해요. 더 빨리 교체하려면 클라이언트에서 로그아웃한 뒤 다시 로그인하세요. 즉시 폐기가 필요하면 지원팀에 문의하세요. 연결되면 사용 가능한 도구를 살펴보세요. 클라이언트가 연결되지 않으면 문제 해결로 이동하세요.