도구별 실전 가이드 · 공식 정보 확인 2026-08-20

figma-use MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: CLI · 페이지 갱신: · 운영·편집 기준

100개 이상의 명령으로 도형·텍스트·컴포넌트·스타일 생성, 문서 조회, 이미지 내보내기를 터미널에서 자동화한다.

100개 이상의 명령으로 도형·텍스트·컴포넌트·스타일 생성, 문서 조회, 이미지 내보내기를 터미널에서 자동화한다. figma-use의 첫 실전 과제는 “테스트 파일의 최상위 프레임 이름과 크기만 JSON으로 조회한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “페이지 Demo의 직계 프레임 목록, id·name·width·height 필드만 출력” 같은 입력으로 figma-use의 핵심 기능을 시험하려는 사람
  • Figma 화면과 목록이 일치하고 쓰기·내보내기 명령은 실행 로그에 없다. 기준으로 figma-use 결과를 직접 검수할 수 있는 경우
  • CLI 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • Figma 전체 읽기·쓰기를 제공하는 에이전트용 CLI 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: CLI의 전체 쓰기 접근은 에이전트가 공유 파일을 일괄 수정하거나 비공개 디자인을 내보내게 할 수 있으므로 토큰 범위와 명령 allowlist가 필요하다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

CLI에서 프레임 목록을 JSON으로 읽기

command line에서 Figma 최상위 프레임의 이름과 크기만 수집한다.

참고 시작점: Figma 페이지 Demo를 read하고 100+ commands 중 조회 명령만 사용해 JSON을 출력해 달라.

  1. command line 인증 대상을 복제 파일로 지정하고 현재 페이지 ID를 확인한다.
  2. read 명령으로 직계 프레임의 id·name·width·height만 요청한다.
  3. JSON 항목을 Figma 화면과 대조하고 실행 이력에 쓰기 명령이 없는지 확인한다.

도형과 텍스트로 테스트 배지 만들기

shapes와 text 명령을 조합해 독립된 작은 components 후보를 만든다.

참고 시작점: 테스트 페이지에 shapes 한 개와 text 한 개를 만들고 components 변환 전 상태로 멈춰 달라.

  1. 새 프레임의 좌표와 크기를 정한 뒤 shapes 명령으로 배경만 생성한다.
  2. text 명령으로 상태 라벨을 추가하고 두 노드의 부모 ID를 확인한다.
  3. components 변환은 실행하지 않은 채 색상·문자·경계 상자가 요청과 맞는지 검수한다.

스타일 적용본을 이미지로 내보내기

styles를 지정한 복제 프레임을 export images 기능으로 파일화한다.

참고 시작점: 복제 프레임 하나에만 styles를 적용하고 write access 범위를 유지한 채 PNG로 export images 해 달라.

  1. 원본 대신 복제 프레임 ID를 write access 허용 목록에 넣는다.
  2. styles 명령으로 배경과 텍스트 스타일을 지정하고 변경 노드를 기록한다.
  3. export images 결과의 해상도와 색을 확인한 뒤 원본 프레임 diff가 없는지 살핀다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

CLI의 전체 쓰기 접근은 에이전트가 공유 파일을 일괄 수정하거나 비공개 디자인을 내보내게 할 수 있으므로 토큰 범위와 명령 allowlist가 필요하다.

직접 대안과 비교

  • figma-ui-mcp — 둘 다 기존 Figma 디자인을 구조화해 읽을 수 있으므로 테스트 파일의 최상위 프레임 이름·너비·높이를 조회하는 첫 과제를 JSON 또는 structured data로 수행할 수 있다.

공식 근거와 확인일

figma-use 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보100개 이상의 명령으로 도형·텍스트·컴포넌트·스타일 생성, 문서 조회, 이미지 내보내기를 터미널에서 자동화한다.figma-use 공식 사이트
무료 조건MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지100개 이상의 명령으로 도형·텍스트·컴포넌트·스타일 생성, 문서 조회, 이미지 내보내기를 터미널에서 자동화한다.공식 제품 페이지