---
url: "/ko/commentful/setup/connect-figma-file.md"
description: "Commentful을 처음 실행할 때는 Figma 개인 액세스 토큰을 생성하고 Figma 파일 URL을 추가해 플러그인을 Figma 파일에 연결해야 해요."
---

# Commentful 플러그인에 Figma 파일 연결

> Commentful을 처음 실행할 때는 Figma 개인 액세스 토큰을 생성하고 Figma 파일 URL을 추가해 플러그인을 Figma 파일에 연결해야 해요.

## 1. Figma 개인 액세스 토큰 생성 {#_1-generate-your-figma-personal-access-token}

[Video](/assets/videos/commentful/setup/create-figma-token.mp4)

Figma 파일을 Commentful 플러그인에 연결하려면 Figma 계정에서 [개인 액세스 토큰을 생성](https://help.figma.com/hc/en-us/articles/8085703771159-Manage-personal-access-tokens)해야 해요.

1. **Settings** 패널로 이동하세요(Figma 계정 아이콘 아래 드롭다운 메뉴에 있어요).
2. 설정 팝업의 **Account** 탭에서 **Personal access tokens** 섹션까지 스크롤하세요.
3. **Generate new token**을 클릭하세요.
4. **Token name**을 입력하세요(예: *Commentful Figma Plugin*).
5. **Expiration** 드롭다운 옵션을 **90 Days**로 설정하세요.
6. **File content** 드롭다운 옵션이 **Read-only**로 설정되어 있는지 확인하세요.
7. **Comments** 드롭다운 옵션이 **Write**로 설정되어 있는지 확인하세요.
8. 나머지 드롭다운 옵션은 모두 **No access**로 두면 돼요.
9. **Generate token** 버튼을 클릭하세요.
10. **Copy this token**을 클릭하세요(토큰을 복사할 수 있는 기회는 이번 한 번뿐이에요).

> **Note:** Figma가 **Expiration** 드롭다운에서 *No expiration* 옵션을 없앴기 때문에, Figma 개인 액세스 토큰을 *90일*마다 새로 발급해야 해요. 토큰이 만료되어도 데이터, 댓글, 리뷰 데이터는 *전혀* 사라지지 않아요. 토큰은 Commentful 플러그인이 Figma 파일의 댓글을 볼 수 있도록 인증하는 역할만 해요.

> **Warning:** **Figma API 요청 한도(2024년 11월 17일부터 적용)** Figma는 Starter(무료) 플랜 사용자의 API 요청을 **분당 5회**로 제한해요. Commentful은 캐싱과 요청 제한으로 이 한도의 영향을 자동으로 줄여요. 사용량이 많다면(예: Commentful 플러그인으로 분당 많은 댓글을 게시하는 경우) Figma Full 시트로 업그레이드하는 것을 고려해 보세요.

## 2. Commentful에 토큰과 Figma 파일 URL 붙여 넣기 {#_2-paste-your-token-and-figma-file-url-into-commentful}

[Video](/assets/videos/commentful/setup/connect-figma-file.mp4)

Figma 개인 액세스 토큰을 생성해 클립보드에 복사했다면 Commentful 플러그인을 실행하고 아래 단계를 따르세요.

1. Commentful 플러그인에서 **Connect This Figma File** 버튼을 클릭하세요.
2. 개인 액세스 토큰을 플러그인에 붙여 넣고 **Save Token** 버튼을 클릭하세요.
3. Figma 파일 오른쪽 위의 **Share** 버튼을 클릭해 공유 팝업을 여세요.
4. **Anyone with the link**의 Figma 파일 권한을 **can view**로 설정하세요.
5. **Copy link**를 클릭해 현재 Figma 파일 URL을 클립보드에 복사하세요.
6. Figma 파일 URL을 플러그인에 붙여 넣고 **Save URL** 버튼을 클릭하세요.

> **Warning:** 이미 Commentful에 연결된 Figma 파일을 복제해 새 파일을 만들었다면, Commentful **Settings** 패널의 **Re-link your Figma File** 버튼을 클릭해 복제한 Figma 파일의 새 URL로 [플러그인을 다시 연결](/ko/commentful/setup/relink-figma-file)해야 해요.