Skip to main content
Tiro MCP 서버 주소는 https://mcp.tiro.ooo/mcp예요. 아래에서 사용하는 클라이언트의 설정 방법을 확인하세요.
API key가 없다면 Tiro Platform API Keys 페이지에서 만드세요. abc123.xR7mK9pL2qW4...처럼 점(.)을 포함한 전체 문자열을 복사해야 해요. 전체 키는 생성할 때 한 번만 볼 수 있어요.

권한 범위

권한 범위는 MCP 서버가 접근할 수 있는 리소스를 정의해요. 현재 API 키에는 모든 권한 범위가 자동으로 부여돼요.
세부 권한 범위 선택은 아직 지원하지 않아요. 인증된 연결에는 전체 접근 권한이 부여돼요.

API 키 종류

어떤 키가 필요한가요? 대부분 사용자 범위 API 키로 시작해요. 사용자가 속한 모든 워크스페이스에서 접근 권한이 있는 노트를 검색하고 읽을 수 있어요. 워크스페이스 범위 API 키는 연결된 워크스페이스만 검색하고, 그 안에서도 전체 구성원에게 공유된 폴더의 노트만 조회해요(시스템 키가 조회하는 노트 범위). 개인 폴더의 노트가 필요하면 사용자 범위 API 키를 쓰세요. MCP 도구는 REST API 와 같은 키를 쓰고 같은 조회 범위 규칙을 따라요. 폴더 도구(search_private_folders, search_team_folders)에는 mcp:folders:read 권한이 필요해요.
API 키는 Tiro Platform API Keys 페이지에서 폐기하지 않는 한 만료되지 않아요. 개발용과 운영용 키를 분리하고 주기적으로 교체하세요. OAuth 토큰은 180일간 유효해요. 교체하려면 클라이언트에서 로그아웃한 뒤 다시 로그인하세요. 즉시 폐기해야 한다면 지원팀에 문의하세요. 연결되면 사용 가능한 도구를 살펴보세요. 클라이언트가 연결되지 않으면 문제 해결로 이동하세요.