Figma 연동 가이드

Figma 연동으로 할 수 있는 일

Figma를 연결하면 Nakama가 팀의 프로젝트와 파일(실시간 썸네일 포함)을 자체 패널에 보여줍니다. 파일을 클릭하면 브라우저의 Figma에서 전체 크기로 열리고; 각 파일의 댓글 피드가 패널 바로 안에 자리합니다 — 스레드를 읽고, 답장하고, 나를 언급한 댓글로 필터링하고, 어떤 댓글이든 할 일로 바꿉니다.

앱 추가하기 (연결)

1. Chrome에서 Nakama 사이드 패널을 엽니다.

2. 오른쪽 레일 하단의 + (Add) 버튼을 눌러 Marketplace를 엽니다.

3. Figma를 선택하고 Connect를 누릅니다.

4. Figma 로그인 페이지가 브라우저 탭으로 열립니다. 로그인하고 Allow를 눌러 Nakama를 인증합니다.

5. 최초 1회 설정: Figma 팀 URL을 붙여넣습니다(figma.com에서 팀을 열고 주소 표시줄을 복사) — Figma API에는 "내 팀 목록" 기능이 없어 Nakama가 한 번만 묻습니다.

6. Nakama 레일에 Figma 아이콘이 나타나고 프로젝트가 담긴 패널이 열립니다.

앱 사용하기

프로젝트 둘러보기. 패널 제목이 프로젝트 선택기입니다 — 드롭다운에서 프로젝트를 전환합니다.

파일 열기. 각 파일은 썸네일, 이름, 최종 수정 시간을 보여줍니다. 클릭하면 파일이 브라우저 탭의 Figma에서 열립니다 — Nakama는 패널 안에서 Figma를 실행하려고 절대 시도하지 않습니다.

댓글 따라가기. 파일의 댓글 버튼을 눌러 피드를 봅니다: 스레드가 묶이고, 미해결이 먼저 오며, 나를 언급한 댓글을 위한 @me 필터가 있습니다. 피드가 열려 있는 동안 새 댓글이 흘러 들어옵니다.

답장하고 작업하기. 패널 바로 안에서 답장을 작성하세요; 댓글 위에 마우스를 올려 Todo 목록에 추가합니다. 파일 카드를 Slack이나 Telegram으로 드래그하여 링크를 공유합니다.

권한 및 데이터 처리

Nakama는 Figma 범위 files:read(프로젝트, 파일, 댓글)와 file_comments:write(답장 게시)를 요청합니다. Figma 토큰은 브라우저의 로컬 확장 프로그램 저장소에만 저장되며 Nakama의 서버에는 절대 저장되지 않습니다; 앱 시크릿은 OAuth 교환에만 서버 측에 유지됩니다.

앱 제거하기 (연결 해제)

Nakama에서: 레일에서 + (Add)를 눌러 Marketplace를 열고, Figma(Connected로 표시됨)를 찾아 눌러서 연결을 해제합니다. 아이콘이 레일에서 사라지고 저장된 토큰이 브라우저에서 삭제됩니다.

Figma에서: Figma Settings → Connected apps에서 액세스를 취소할 수도 있으며, 이는 Figma 측에서 액세스를 취소합니다.

문제 해결

"That doesn't look like a team URL": 팀 URL에는 /team/<number>/가 포함되어야 합니다 — figma.com의 파일 브라우저에서 팀을 열고 전체 주소를 복사하세요.

그 밖의 문의: 고객센터을(를) 확인하거나 help@rexplore.xyz로 문의하세요.