Figma MCP Beta
Figma MCP, AI가 캔버스에 직접 쓴다고요?
2026년 3월 24일, Figma가 조용히 큰 발표를 했습니다. AI 에이전트가 이제 Figma 캔버스에 직접 쓸 수 있게 됐다는 것. Claude Code, Cursor, Codex 같은 MCP 클라이언트가 use_figma 도구를 통해 컴포넌트를 만들고, 변수를 바인딩하고, 디자인 시스템을 통째로 생성할 수 있습니다. 그런데 “무료 베타”라는 말 뒤에 숨은 제약이 꽤 많습니다. 쓰기 전에 먼저 봐야 할 게 있습니다.
Figma MCP, 3번의 변화를 거쳐 여기까지 왔습니다
Figma MCP 서버는 2025년 6월에 처음 등장했을 때 읽기 전용이었습니다. 디자인 컨텍스트를 추출하고, 코드 생성 힌트를 주는 정도가 전부였죠. 그러다 2026년 2월에 generate_figma_design이 추가되면서 웹 화면을 Figma 레이어로 변환하는 단방향 쓰기가 가능해졌습니다. 그리고 2026년 3월 24일, use_figma 도구가 출시되면서 마침내 에이전트가 캔버스를 양방향으로 읽고 쓸 수 있게 됐습니다.
💡 공식 릴리스 노트와 Figma 블로그 발표문을 같이 놓고 보니 이런 흐름이 보였습니다 — 읽기 전용 6개월 → 단방향 쓰기 1개월 → 양방향 쓰기로 이어지는 점진적 개방 전략입니다.
현재 Figma MCP 서버가 제공하는 도구는 총 16개입니다. (출처: Reddit 커뮤니티 분석, 2026.03.25) 읽기 도구 5개, 쓰기 도구 4개, 디자인 시스템 도구 2개, Code Connect 도구 4개, 그리고 인증 확인용 whoami 1개입니다. 16개라는 숫자가 많아 보이지만, 실제로 대부분의 팀이 쓰는 핵심 도구는 3~4개에 불과합니다.
| 카테고리 | 주요 도구 | 특이사항 |
|---|---|---|
| 읽기 | get_design_context, get_screenshot | 모든 유료 플랜 사용 가능 |
| 쓰기 | use_figma, generate_figma_design | Full/Dev 시트 전용 |
| 디자인 시스템 | search_design_system, create_design_system_rules | 플랜 제한 없음 |
| Code Connect | get_code_connect_map 외 3개 | Org/Enterprise 전용 |
use_figma 도구가 실제로 하는 일
솔직히 말하면, use_figma는 “AI가 디자인을 이해해서 스스로 만든다”는 느낌의 도구가 아닙니다. 정확히는 Figma Plugin API JavaScript를 headless 환경에서 직접 실행하는 코드 실행기입니다. (출처: Figma 공식 블로그, 2026.03.24) AI 에이전트가 JavaScript 코드를 작성하고, 그 코드가 Figma 파일 안에서 돌아가는 구조입니다. 이 말은 Figma Plugin API를 기반으로 하기 때문에 할 수 있는 것과 할 수 없는 것이 명확하게 나뉜다는 뜻입니다.
만들 수 있는 것은 프레임, Auto Layout, 컴포넌트 라이브러리, 변수 컬렉션, 텍스트·이펙트 스타일, 13가지 셰이프 노드입니다. 반면 figma.notify()나 figma.showUI(), figma.teamLibrary.* 전체 네임스페이스는 headless 환경 특성상 지원되지 않습니다. 한 번의 호출에 주어진 실행 시간은 약 15초이고, 15초 안에 끝나지 않으면 전체 작업이 원자 단위로 롤백됩니다. 실패했을 때 아무것도 바뀌지 않는다는 점은 오히려 안전망이 됩니다.
⚠️ 자주 빠지는 함정 — 컬러 값은 0~255가 아니라 0~1 범위입니다. fills와 strokes는 읽기 전용 배열이라 복제 후 수정 후 재할당 순서를 반드시 지켜야 합니다. 페이지 컨텍스트는 매 호출마다 첫 번째 페이지로 초기화됩니다.
이 구조가 기존 Figma 플러그인 개발과 다른 점은, CORS 제약과 iframe 샌드박스 문제, OAuth 배포 절차가 전부 사라진다는 점입니다. 이전에 자동화 플러그인을 만들다가 포기했다면, MCP를 통한 접근이 확실히 더 단순합니다.
“무료 베타”라는 말을 너무 믿으면 안 됩니다
Figma 공식 문서에는 “베타 기간 동안 무료 제공”이라고 나와 있습니다. (출처: Figma 공식 도움말 센터, help.figma.com) 그런데 무료라고 무제한은 아닙니다. Starter 플랜 사용자에게는 MCP 도구 호출이 월 6회로 제한됩니다. 읽기와 쓰기를 합산한 숫자입니다.
🚨 Starter 플랜이라면 테스트조차 어렵습니다
figma-generate-library 스킬 하나를 완성하려면 use_figma 호출이 최소 20회, 복잡한 디자인 시스템은 100회 이상 필요합니다. 월 6회로는 스킬 하나도 실행을 끝낼 수 없습니다.
유료 플랜의 Full 시트와 Dev 시트는 Tier 1 분당 요청 한도를 적용받으며, 캔버스 쓰기 기능(use_figma)은 Full 시트와 Dev 시트 전용입니다. Dev 시트는 Drafts 외부 파일에서 읽기 전용으로만 동작합니다. 팀에서 디자이너가 아닌 개발자 계정을 쓰고 있다면, 쓰기 접근 권한이 파일 위치에 따라 달라질 수 있습니다.
결국 use_figma를 제대로 쓰려면 유료 플랜이 필요하고, 이후 베타가 끝나면 사용량 기반 과금으로 전환됩니다. 지금 당장 비용이 없다는 것이지, 영구 무료를 의미하지는 않습니다.
스킬(Skills)이 있어야 AI가 팀처럼 움직입니다
Figma가 같이 공개한 스킬(Skills)은 마크다운 파일로 작성된 에이전트 행동 지침입니다. 단순한 설명서처럼 보이지만, 실제로는 꽤 중요한 역할을 합니다. AI 모델은 본질적으로 비결정론적이어서, 같은 프롬프트를 줘도 결과가 달라집니다. 스킬은 구체적인 단계와 순서, 따라야 할 규칙을 코드처럼 인코딩해서 이 비결정성을 줄여줍니다. (출처: Figma 공식 블로그, 2026.03.24)
💡 공식 발표문과 실제 스킬 구조를 같이 놓고 보니 이런 차이가 보였습니다 — 스킬은 “무엇을 만들지”가 아니라 “어떻게 안전하게 호출할지”를 정의합니다. 모든 스킬은 기초 레이어인 /figma-use를 상속합니다. 이 파운데이션 스킬 하나에 17개 핵심 규칙과 16개 항목 점검 목록이 들어 있습니다.
Figma는 출시와 함께 9개의 예시 스킬을 공개했습니다. 코드베이스에서 새 컴포넌트를 만드는 /figma-generate-library, 기존 컴포넌트와 변수로 새 화면을 만드는 /figma-generate-design, 스크린 리더 명세를 자동 생성하는 /create-voice 등이 있습니다. Uber, One North, Edenspiekermann 같은 실무 팀이 직접 만들어 기여한 스킬도 포함됐습니다.
스킬을 직접 만들 때 플러그인 개발 경험이나 코딩 능력은 필요 없습니다. 마크다운으로 작성하면 됩니다. 단, 공식 GitHub 저장소(figma/mcp-server-guide)에서 공개된 스킬 구조를 먼저 살펴보는 걸 권합니다. 실제 스킬에는 WRONG/CORRECT 코드 예시가 34쌍이나 들어 있어서, 처음 작성할 때 참고가 됩니다.
generate_figma_design과 use_figma, 다른 도구입니다
둘 다 Figma에 뭔가를 쓰는 도구처럼 보이지만, 작동 방식이 완전히 다릅니다. generate_figma_design은 살아있는 웹 URL을 캡처해서 편집 가능한 Figma 레이어로 변환하는 도구입니다. 빠르게 기존 화면을 Figma로 가져올 때 쓸 수 있죠. 그런데 독립적인 테스트 결과, 스타일 부정확률이 85~90%에 달합니다. (출처: Reddit 커뮤니티 분석 SFAI Labs 인용, 2026.03.25) 그냥 참조용 레퍼런스로만 써야 한다는 뜻입니다. 프로덕션 디자인 시스템 소스로 활용하면 후속 작업에서 큰 문제가 생깁니다.
use_figma는 반대로 기존 컴포넌트와 변수를 그대로 참조하면서 새 자산을 만들거나 수정합니다. 레이어 구조가 실제 디자인 시스템과 연결됩니다. 두 도구는 경쟁 관계가 아니라 보완 관계입니다. 공식 스킬 문서에서도 두 도구를 병렬로 쓰는 워크플로를 제안합니다. generate_figma_design으로 픽셀 정확도를 확보하고, use_figma로 컴포넌트 시맨틱을 입힌 다음, 전자를 삭제하는 방식입니다.
🔑 핵심 — generate_figma_design은 베타 기간 동안 별도 쿼터로 무제한 사용 가능합니다. use_figma와 다른 할당량이 적용됩니다.
지금 바로 쓸 수 있는 것과 아직 기다려야 하는 것
막상 써보면 이 차이가 꽤 큽니다. 지금 당장 실무에 넣어도 괜찮은 워크플로와, 아직 베타 불안정성이 있어서 주의가 필요한 영역이 분명히 나뉩니다.
지금 써도 되는 것
- Figma → 코드 변환:
figma-implement-design워크플로가 비교적 안정적입니다.get_design_context+get_screenshot조합은 신뢰도가 높습니다. - 디자인 시스템 규칙 파일 생성:
figma-create-design-system-rules는 플랜 제한이 없고, CLAUDE.md나 .cursor/rules 파일을 자동 생성해줍니다. - FigJam 다이어그램 자동화:
generate_diagram으로 Mermaid 문법을 FigJam 다이어그램으로 변환할 수 있습니다.
주의하며 써야 하는 것
- use_figma로 대형 디자인 시스템 빌드: 아직 베타이고 높은 호출 횟수가 필요합니다. 소규모 테스트부터 시작하는 걸 권합니다.
- generate_figma_design의 결과물을 디자인 소스로 사용: 85~90% 스타일 부정확률이 있습니다. 레퍼런스 용도로만 씁니다.
- Code Connect 관련 기능: Org/Enterprise 플랜 전용입니다. 팀 라이브러리에 컴포넌트가 게시돼 있어야 합니다.
Figma 커뮤니티의 스킬 라이브러리에서 지금 당장 써볼 수 있는 스킬 목록을 확인할 수 있습니다. 커뮤니티 기여 스킬도 계속 추가되고 있어서 팔로우해두면 실무 적용 시점을 잡기 수월합니다.
Q&A 5가지
마치며
Figma MCP의 use_figma는 AI가 디자인 도구에서 실질적으로 작업하는 첫 번째 성숙한 형태입니다. 2025년 6월 읽기 전용 MCP부터 2026년 3월 양방향 캔버스 쓰기까지, 방향성은 명확합니다. 에이전트가 디자인 시스템을 실제 소스로 삼아 코드와 캔버스를 오가는 구조를 만드는 것입니다.
다만 지금 당장 Figma를 완전히 AI에게 맡길 수 있는 수준은 아닙니다. Starter 플랜의 월 6회 한도, generate_figma_design의 85~90% 스타일 부정확률, 15초 타임아웃 같은 제약은 실무 적용에 앞서 반드시 확인해야 합니다. 써보고 싶다면 계정 플랜 확인 → 읽기 도구 테스트 → 단순 use_figma 쓰기 테스트 순서로 접근하는 게 현실적입니다.
베타 기간이 얼마나 남았는지 Figma가 공개하지 않았습니다. 지금은 무료로 테스트할 수 있는 시간입니다.
본 포스팅 참고 자료
- Figma 공식 블로그 — Agents, Meet the Figma Canvas (figma.com/blog)
- Figma 공식 도움말 센터 — Get started with the Figma MCP server (help.figma.com)
- Figma 릴리스 노트 2026.03 (figma.com/ko-kr/release-notes)
- Reddit ClaudeCode 커뮤니티 — AI Agents Can Finally Write to Figma (2026.03.25)
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Figma MCP 서버는 현재 베타 단계이며, 요금 정책 및 지원 기능은 공식 사이트에서 최신 정보를 확인하시기 바랍니다.
댓글 남기기