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

권한 범위

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

API Key 종류

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