도구별 실전 가이드 · 공식 정보 확인 2026-08-20
figma-console-mcp MIT 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Desktop, Extension · 페이지 갱신: · 운영·편집 기준
AI 클라이언트가 Figma Desktop의 컴포넌트·변수·스타일을 추출하고 생성·디버깅하도록 MCP 도구를 제공한다.
AI 클라이언트가 Figma Desktop의 컴포넌트·변수·스타일을 추출하고 생성·디버깅하도록 MCP 도구를 제공한다. figma-console-mcp의 첫 실전 과제는 “복제한 Figma 테스트 파일에서 색상 변수 목록만 읽는다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “Local Colors와 Variables의 이름·값을 표로 반환하고 수정 도구는 호출 금지” 같은 입력으로 figma-console-mcp의 핵심 기능을 시험하려는 사람
- Figma 패널의 변수 수·값과 결과가 일치하고 파일 버전 기록에 변경이 생기지 않는다. 기준으로 figma-console-mcp 결과를 직접 검수할 수 있는 경우
- Desktop·Extension 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- Figma 디자인 시스템 읽기·쓰기 MCP 브리지 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: Figma PAT와 Desktop Bridge에 전체 쓰기 권한을 주면 공유 디자인 시스템을 대량 변경할 수 있어 첫 연결은 읽기 전용 SSE와 복제 파일로 검증해야 한다.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
디자인 시스템 변수를 읽기 전용으로 추출하기
Figma 디자인 시스템의 변수 이름과 값을 원본 변경 없이 표로 확보한다.
참고 시작점: Figma 복제 파일에서 Variables와 Local Colors를 extraction 대상으로 삼고, design-systems 구조를 표로 정리해 달라.
- Figma Desktop에서 복제 파일과 MCP 브리지를 연결하되 쓰기 도구는 허용하지 않는다.
- Variables와 Local Colors의 이름·값·컬렉션만 extraction 결과로 요청한다.
- 플러그인 패널의 항목 수와 표를 대조하고 Figma 버전 기록에 변경이 없는지 확인한다.
격리 페이지에 디자인 요소 생성하기
공유 라이브러리를 건드리지 않고 Figma API 기반 creation 경로를 검증한다.
참고 시작점: 테스트 페이지에 사각형과 텍스트 한 쌍만 creation하고 figma-api가 반환한 노드 ID를 기록해 달라.
- 빈 테스트 페이지의 ID와 허용된 좌표 범위를 먼저 고정한다.
- figma-api creation 호출로 사각형과 텍스트를 각각 하나씩 만든다.
- 생성된 두 노드의 부모와 좌표를 확인한 뒤 다른 페이지의 변경 diff가 0인지 살핀다.
깨진 컴포넌트 연결을 진단하기
MCP로 디자인 오류를 재현하고 debugging 단서만 남긴다.
참고 시작점: figma-plugins 환경의 복제 컴포넌트에서 누락된 연결을 debugging하되 자동 수정은 하지 말아 달라.
- 문제가 있는 인스턴스 하나를 복제 페이지에서 선택해 MCP에 전달한다.
- figma-plugins 로그와 반환된 노드 관계에서 끊긴 지점을 debugging한다.
- 진단 결과에 선택 노드 ID와 예상 연결을 적고 원본 컴포넌트가 그대로인지 확인한다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
Figma PAT와 Desktop Bridge에 전체 쓰기 권한을 주면 공유 디자인 시스템을 대량 변경할 수 있어 첫 연결은 읽기 전용 SSE와 복제 파일로 검증해야 한다.
직접 대안과 비교
- figma-use — 둘 다 Figma 문서를 읽어 변수·스타일·노드 값을 구조화할 수 있으므로 복제 파일의 색상 변수 목록을 추출하는 첫 과제를 그대로 수행할 수 있다.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | AI 클라이언트가 Figma Desktop의 컴포넌트·변수·스타일을 추출하고 생성·디버깅하도록 MCP 도구를 제공한다. | figma-console-mcp 공식 사이트 |
| 무료 조건 | MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | AI 클라이언트가 Figma Desktop의 컴포넌트·변수·스타일을 추출하고 생성·디버깅하도록 MCP 도구를 제공한다. | 공식 제품 페이지 |