멤버 및 권한

OpenPR은 워크스페이스에 범위가 지정된 역할 기반 접근 제어(RBAC)를 사용합니다. 각 워크스페이스 멤버는 권한을 결정하는 역할을 가집니다.

역할

역할	설명	권한
Owner	워크스페이스 생성자 또는 승격된 소유자	전체 접근: 워크스페이스 삭제, 모든 설정 관리, 멤버 승격/강등
Admin	워크스페이스 관리자	프로젝트, 멤버(소유자 제외), 설정, 거버넌스 설정 관리
Member	일반 팀 멤버	이슈, 댓글, 레이블 생성 및 관리; 거버넌스 참여

멤버 초대

워크스페이스 설정 > 멤버 > 초대로 이동합니다:

1. 사용자의 이메일 주소를 입력합니다.
2. 역할을 선택합니다 (Owner, Admin, 또는 Member).
3. 초대를 클릭합니다.

초대된 사용자는 OpenPR 계정이 있어야 합니다. 계정이 없다면 먼저 등록해야 합니다.

멤버 관리

멤버 목록에서 다음을 할 수 있습니다:

• 역할 변경 -- 멤버 승격 또는 강등 (admin은 owner 역할을 변경할 수 없음).
• 제거 -- 워크스페이스에서 멤버 제거.

사용자 유형

OpenPR은 두 가지 엔티티 유형을 지원합니다:

유형	설명	생성 방법
human	일반 사용자	사용자 등록
bot	봇/AI 계정	봇 토큰 생성

봇 사용자는 봇 토큰이 생성될 때 자동으로 생성됩니다. 활동 피드 및 감사 로그에 표시 이름과 함께 나타납니다.

봇 토큰

봇 토큰은 AI 어시스턴트와 외부 도구가 MCP 서버 및 API로 인증할 수 있게 합니다. 각 토큰은:

• opr_ 접두사를 가집니다.
• 하나의 워크스페이스에 범위가 지정됩니다.
• 해당하는 bot_mcp 사용자 엔티티를 생성합니다.
• 워크스페이스 멤버에게 제공되는 모든 읽기/쓰기 작업을 지원합니다.

봇 토큰 생성

워크스페이스 설정 > 봇 토큰 > 생성으로 이동합니다:

1. 표시 이름을 입력합니다 (예: "Claude Assistant").
2. 생성을 클릭합니다.
3. 즉시 토큰을 복사합니다 -- 다시 표시되지 않습니다.

봇 토큰 사용

봇 토큰은 MCP 서버 설정에서 사용됩니다:

# 환경 변수
OPENPR_BOT_TOKEN=opr_your_token_here

또는 API 요청에서:

curl -H "Authorization: Bearer opr_your_token_here" \
  http://localhost:8080/api/workspaces/<workspace_id>/projects

API 레퍼런스

# 워크스페이스 멤버 나열
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/workspaces/<workspace_id>/members

# 봇 토큰 나열
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/workspaces/<workspace_id>/bots

MCP 도구

도구	설명
members.list	모든 워크스페이스 멤버 및 역할 나열

다음 단계

• 워크스페이스 관리 -- 워크스페이스 설정
• MCP 서버 -- 봇 토큰으로 AI 어시스턴트 설정