09

API 토큰 발급

개인 액세스 토큰(PAT)을 통해 AI 에이전트를 Umtri와 연동할 수 있습니다.

토큰 생성

  1. app.umtri.io에 로그인합니다.
  2. 사이드바 하단의 프로필을 선택하여 서브메뉴의 Settings로 이동하세요.
  3. API Tokens를 선택하세요.
    1. 구분하고 어떤 토큰인지 기억하기 위한 라벨(예: claude-desktop)을 자유롭게 입력합니다.
    2. 스코프를 선택합니다. 기본값은 Write입니다.
      • Read : 읽기 전용 토큰입니다. 이 토큰으로 인증하면 Umtri의 데이터를 읽을 수는 있지만, 편집할 수는 없습니다.
      • Write : 읽기와 쓰기가 가능한 토큰입니다. 편집 권한까지 주어집니다. 활성 Write 토큰은 3개까지 둘 수 있으며, 더 필요하면 하나를 Revoke한 뒤 발급하세요. Read 토큰은 제한이 없습니다.
    3. Generate token을 눌러 토큰을 생성하세요.
    4. 토큰을 발급하면 바로 아래에 ADD UMTRI MCP가 나타납니다. 사용 중인 AI 에이전트에 맞는 명령을 복사하세요 — 복사되는 명령에는 발급한 토큰이 이미 들어 있습니다. Dismiss를 누르면 토큰과 함께 사라져 다시 볼 수 없으니, 먼저 복사해 두세요.
      • MCP 연결에 관련한 내용은 MCP로 연결 문서에 좀 더 자세히 설명되어 있습니다.

팀에서는 토큰이 그 팀에서의 내 역할로 동작합니다. 뷰어의 Write 토큰으로는 팀 배지를 편집할 수 없습니다. 팀 (Team)을 참고하세요.

토큰은 보안 상 SHA-256 해시로만 저장되며, 생성 시점에 한번만 확인이 가능합니다. 꼭 복사하여 안전한 곳에 기록해두세요. 잃어버렸거나, 노출되었거나, 더 이상 쓰지 않는 토큰은 목록에서 Revoke해 무효화하고, 필요하면 새로 발급받아 사용하세요.