메인 콘텐츠로 건너뛰기
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 Kind묶이는 대상접근 범위
user 범위 key한 명의 사용자해당 사용자가 접근할 수 있는 모든 노트, 요약, 문서, 폴더 — 여러 워크스페이스에 걸칠 수 있음
workspace 범위 key하나의 워크스페이스해당 단일 워크스페이스의 모든 것. 사용자 신원 없음
어떤 key가 필요한가요? 대부분 user 범위 key로 시작해요. 본인이 속한 모든 워크스페이스에 걸쳐, 팀 폴더의 노트를 포함해 접근 권한이 있는 모든 노트를 검색하고 읽을 수 있어요. workspace 범위 key는 하나의 워크스페이스에 묶여 자동으로 그 워크스페이스를 검색해요. 두 종류 모두 폴더 도구(search_private_folders, search_team_folders)를 쓸 수 있어요 — 둘 다 mcp:folders:read scope만 있으면 되고, 개인/팀 구분은 폴더 타입이지 key 종류가 아니에요.
API key는 Tiro Platform API Keys 페이지에서 폐기하지 않는 한 만료되지 않아요. key는 주기적으로 교체하고, 개발용과 운영용으로 별도의 key를 사용하기를 권장해요. OAuth token은 180일간 유효해요. 더 빨리 교체하려면 클라이언트에서 로그아웃한 뒤 다시 로그인하세요. 즉시 폐기가 필요하면 지원팀에 문의하세요. 연결되면 사용 가능한 도구를 살펴보세요. 클라이언트가 연결되지 않으면 문제 해결로 이동하세요.