Figma MCP로 디자인-코드 반복 주기 최대 80% 단축하기: Model Context Protocol과 AI 코딩 에이전트 실전 연동

이 글의 핵심 3줄 Figma MCP는 AI가 디자인을 이미지가 아닌 구조 데이터로 읽게 해서 코드 정확도와 속도를 동시에 높입니다. Cursor·Claude Code에 MCP를 연결하고, Code Connect로 기존 컴포넌트를 매핑하면 반복 시간을 최대 80% 줄일 수 있습니다. 이 글을 읽고 나면 MCP 서버를 연결하고, 첫 Figma 노드를 컴포넌트로 변환하고, Code Connect까지 적용하는 것을 직접 해볼 수 있습니다.

솔직히 말하면, 저도 처음엔 "Figma를 AI가 직접 읽는다고? 그게 뭐가 다르지?"라고 생각했습니다. 어차피 스크린샷 찍어서 Claude에 붙여넣거나, Figma URL 공유해서 구현하면 되는 거 아닌가 싶었죠. 그런데 직접 써보고 나서 생각이 완전히 바뀌었습니다. AI에게 이미지를 "보여주는" 것과 구조화된 데이터를 "읽게" 하는 것 사이에는 생각보다 훨씬 큰 차이가 있습니다. Builder.io와 Locofy의 보고에 따르면, Figma MCP를 활용하면 디자인-코드 반복 시간을 60~~80% 단축하고 LLM 토큰 소비를 30~~50% 줄일 수 있다고 합니다.

Figma MCP는 Anthropic이 처음 제안한 개방형 표준인 Model Context Protocol(MCP)을 활용해, Figma의 디자인 데이터를 AI 코딩 에이전트에게 직접 전달하는 서버입니다. 현재는 OpenAI, GitHub, Figma 등 수십 개 기업이 이 표준을 채택·기여하고 있습니다. Cursor, Claude Code, VS Code Copilot, Windsurf 같은 AI 코딩 도구가 Figma 파일의 노드 구조, 레이아웃 제약, 디자인 토큰, 컴포넌트 변형까지 구조화 데이터로 직접 읽어서 코드를 생성할 수 있게 됩니다. 코드 예시는 React + TypeScript 기준이지만, 핵심 원리는 Vue, Svelte 등 다른 프레임워크에도 동일하게 적용됩니다.

핵심 개념

MCP와 Figma가 연결되는 방식

Model Context Protocol (MCP): Anthropic이 2024년 말 처음 제안한 개방형 표준으로, AI 에이전트가 외부 애플리케이션과 표준화된 방식으로 상호작용할 수 있도록 정의한 프로토콜. USB-C 포트처럼, 어떤 AI 클라이언트든 같은 인터페이스로 다양한 외부 도구에 연결할 수 있게 해줍니다.

2025년은 MCP 생태계의 확산 원년이라 해도 과언이 아닙니다. 1~2월에 Cursor와 Windsurf가 지원을 시작했고, 3월엔 OpenAI와 GitHub도 합류했습니다. Figma는 2025년 중반 공식 Dev Mode MCP 서버를 출시하면서 디자인-코드 워크플로우에 직접 뛰어들었습니다.

기존 방식과 Figma MCP 방식의 실질적 차이

기존에 AI로 디자인을 코드로 변환할 때 흔히 쓰던 방법은 두 가지였습니다. 스크린샷을 찍어 AI에 붙여넣거나, Figma URL을 공유하거나. 둘 다 AI 입장에서 보면 "이미지를 보고 추측하는" 방식이었습니다.

Figma MCP는 다릅니다. AI가 Figma 파일의 노드 트리 구조, 레이아웃 제약(Auto Layout), 디자인 토큰, 컴포넌트 변형(variant), 자산 참조를 JSON 형태의 구조화 데이터로 직접 읽습니다.

용어 정리: Auto Layout은 Figma의 반응형 레이아웃 시스템(CSS Flexbox와 유사), variant는 하나의 컴포넌트에 정의된 여러 상태(예: Button의 Primary/Secondary/Destructive), 노드 트리는 Figma 디자인의 계층 구조입니다. HTML DOM 트리와 비슷하다고 생각하시면 빠르게 이해가 됩니다.

스크린샷 방식: AI → 이미지 픽셀 분석 → 추측 기반 코드
Figma MCP 방식: AI → 구조화된 노드 데이터 → 정확한 코드

읽기와 쓰기, 양방향으로 작동한다

Figma MCP 서버의 기능은 두 방향으로 작동합니다.

방향	기능	활용 예시
읽기 (Design → Code)	노드 트리, 토큰, 제약 읽기	"이 Figma 화면을 React 컴포넌트로 구현해줘"
쓰기 (Code → Canvas)	프레임, 컴포넌트, Auto Layout 생성·수정	AI가 Figma 캔버스에 직접 디자인 생성

쓰기 기능이 특히 흥미로운 이유는, 개발자가 코드로 구현한 결과물을 Figma 캔버스로 역으로 가져올 수 있기 때문입니다. 디자이너가 누락된 상태(state)를 보완하거나 세부 디테일을 다듬는 양방향 협업 루프가 만들어집니다.

배포 방식: Remote vs Desktop

배포 방식	특징	선택 기준
Remote MCP 서버	Figma 팀이 호스팅, 브라우저 기반 Figma에서 사용, 별도 설치 불필요, OAuth 인증 방식	대부분의 팀에 권장. 인터넷 연결이 안정적이고 설치 없이 바로 쓰고 싶을 때
Desktop MCP 서버	Figma 데스크탑 앱을 통해 로컬 실행, Personal Access Token 방식	오프라인 환경이 필요하거나 네트워크 레이턴시가 체감되는 상황

실무에서는 Remote 서버로 시작해서 레이턴시 문제가 느껴질 때 Desktop으로 전환하는 방식을 권장합니다. Remote는 Figma OAuth 인증을 쓰고, Desktop은 Personal Access Token을 직접 발급해 설정 파일에 넣는 방식이라 초기 설정이 한 단계 더 있습니다.

실전 적용

현장에서 가장 자주 쓰는 패턴: Figma 화면을 React 컴포넌트로 바로 변환하기

실무에서 가장 자주 맞닥뜨리는 시나리오입니다. 디자이너가 Figma 링크를 던져주면서 "이거 구현해줘"라고 할 때, Figma MCP가 연결되어 있으면 작업 방식이 달라집니다.

먼저 Cursor의 MCP 설정 파일에 Figma MCP 서버를 추가합니다. 설정 파일 위치는 프로젝트 루트 기준 .cursor/mcp.json(프로젝트별 설정) 또는 ~/.cursor/mcp.json(전역 설정) 중 선택할 수 있습니다. Claude Code라면 ~/.claude/claude_desktop_config.json을 사용합니다. 아래는 Desktop MCP 서버 방식 예시입니다.

json

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "@figma/mcp-server"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "your_figma_access_token"
      }
    }
  }
}

⚠️ 패키지명(@figma/mcp-server)은 공식 문서의 최신 버전을 반드시 확인하시는 것을 권장합니다. Figma MCP는 베타 기간이라 패키지명이나 설치 방식이 업데이트될 수 있습니다. 공식 헬프센터 가이드가 항상 최신 상태입니다.

설정 후 Cursor에서 Figma 노드 URL을 포함해 프롬프트를 작성하면 됩니다. 실제 Figma 노드 URL은 ?node-id=1234%3A56 형태로 콜론(:)이 URL 인코딩됩니다. Figma에서 노드를 선택한 후 우클릭 → "Copy link to selection"으로 정확한 URL을 복사해서 쓰시면 파싱 오류를 방지할 수 있습니다.

Figma URL: https://www.figma.com/file/xxx/yyy?node-id=1234%3A56
 
이 Figma 컴포넌트를 우리 디자인 시스템의 Button 컴포넌트를 사용해서
React TypeScript로 구현해줘. Tailwind CSS 사용.

이걸 처음 써봤을 때 생각보다 설정이 간단해서 놀랐습니다. AI가 해당 노드의 구조를 직접 읽어서 코드를 생성하는데, 스크린샷 방식과 달리 폰트 크기, 간격, 색상 토큰 값을 픽셀 단위로 정확하게 반영합니다.

비교 항목	스크린샷 방식	Figma MCP 방식
색상 정확도	추측 (근사값)	정확한 토큰 값
간격 수치	육안 추정	Auto Layout 수치 그대로
컴포넌트 변형 인식	불가	variant 구조 직접 파악
LLM 토큰 소비	높음 (이미지 처리)	30~50% 절감 (Builder.io, 2025)

이렇게 하면 잘 작동하는데, 문제가 하나 있었습니다. AI가 디자인을 정확히 읽긴 하는데, 팀에서 이미 만들어놓은 Button 컴포넌트를 쓰지 않고 새 컴포넌트를 또 만들어버리는 겁니다. 이걸 해결하는 게 바로 Code Connect입니다.

처음에 몰라서 헤맸던 것: Code Connect로 기존 컴포넌트 재사용하기

Code Connect: Figma 라이브러리 컴포넌트를 실제 코드베이스 컴포넌트에 1:1로 매핑하는 도구. AI가 Figma에서 Button 컴포넌트를 만났을 때, 팀의 @design-system/Button을 재사용하도록 유도합니다.

⚠️ 플랜 제약: Code Connect UI는 Organization·Enterprise 플랜 전용입니다. Starter나 Professional 플랜 사용자라면 CLI 기반으로 제한적으로 사용할 수 있으니, 시작 전에 플랜을 먼저 확인해 보세요.

Code Connect 설정은 패키지 설치부터 시작합니다.

bash

pnpm add @figma/code-connect

설정 파일을 프로젝트 루트에 추가합니다.

typescript

// figma.config.ts
import { defineConfig } from '@figma/code-connect'
 
export default defineConfig({
  codeConnect: {
    include: ['src/components/**/*.figma.ts'],
  },
})

그다음 .figma.ts 파일을 컴포넌트 옆에 만들면 됩니다. 이 파일은 빌드 타임에만 참조되는 메타데이터 파일로, 런타임 번들에는 포함되지 않습니다. JSX를 사용하므로 tsconfig.json에 "jsx": "react-jsx" 설정이 필요합니다.

typescript

// src/components/Button/Button.figma.ts
import React from 'react'
import figma from '@figma/code-connect'
import { Button } from './Button'
 
figma.connect(Button, 'https://www.figma.com/file/xxx?node-id=1234%3A56', {
  props: {
    variant: figma.enum('Variant', {
      Primary: 'primary',
      Secondary: 'secondary',
      Destructive: 'destructive',
    }),
    size: figma.enum('Size', {
      Small: 'sm',
      Medium: 'md',
      Large: 'lg',
    }),
    label: figma.string('Label'),
    disabled: figma.boolean('Disabled'),
  },
  example: ({ variant, size, label, disabled }) => (
    <Button variant={variant} size={size} disabled={disabled}>
      {label}
    </Button>
  ),
})

처음 팀에 도입했을 때 "Button 하나 연결하는 데 파일을 따로 만들어야 하나"라는 생각이 솔직히 들었습니다. 초기 설정이 번거로운 건 사실입니다. 그런데 한번 연결해두고 나니 AI가 매번 새 컴포넌트를 만드는 대신 디자인 시스템을 정확히 따르는 걸 보고 생각이 바뀌었습니다. Builder.io의 보고에 따르면 Code Connect가 잘 연결된 팀은 컴포넌트 재사용률 80% 이상, 디자인 시스템 준수율 70% 향상을 달성했습니다.

아이디어를 캔버스로 즉시 옮기기: FigJam 다이어그램 자동 생성

이건 개발자 입장에서 생각보다 편리한 기능입니다. 시스템 설계 단계에서 Mermaid 형식으로 다이어그램 구조를 설명하면 FigJam에 바로 생성해줍니다.

Claude Code나 Cursor에서 다음처럼 요청할 수 있습니다.

shell

다음 Mermaid 시퀀스를 FigJam 다이어그램으로 만들어줘:
 
sequenceDiagram
  participant User
  participant APIGateway
  participant AuthService
  User->>APIGateway: POST /login
  APIGateway->>AuthService: validateCredentials()
  AuthService-->>APIGateway: JWT token
  APIGateway-->>User: 200 OK + token

MCP의 쓰기 기능이 작동하면서 Figma가 FigJam 캔버스에 시퀀스 다이어그램을 직접 생성합니다. 플로우차트, 간트 차트, 상태 다이어그램, 시퀀스 다이어그램을 지원하고, 기획 초기 단계에서 AI와 아이디어를 주고받으면서 즉시 시각화할 수 있어 유용합니다.

장단점 분석

처음 팀에 도입을 제안할 때 가장 많이 받은 질문이 "설정 비용 대비 효과가 정말 있냐"였습니다. 직접 써보고 난 뒤 솔직하게 정리하면 이렇습니다.

장점

항목	내용	효과가 최대인 조건
정확도 향상	픽셀 추측이 아닌 정확한 구조 데이터 기반 코드 생성	Figma 파일이 컴포넌트 단위로 잘 정리되어 있을 때
토큰 효율	이미지 대신 구조화 텍스트 전달로 LLM 토큰 30~50% 절감	복잡한 화면일수록 효과 증가
개발 속도	디자인-코드 반복 시간 60~80% 단축 (Builder.io, 2025)	Code Connect까지 연결됐을 때
컴포넌트 재사용	Code Connect 연동 시 실제 컴포넌트 재사용률 80% 이상	디자인 시스템과 코드 컴포넌트가 1:1 대응될 때
양방향 협업	읽기·쓰기 모두 지원해 디자이너-개발자 협업 루프 완성	디자이너가 Figma를 주 도구로 쓸 때
다이어그램 자동화	자연어·Mermaid → FigJam 다이어그램 자동 생성	아키텍처 설계·기획 초기 단계

단점 및 주의사항

항목	내용	대응 방안
반응형 한계	AI가 모바일 적응형 레이아웃을 자동 처리하는 능력 부족	반응형 브레이크포인트는 별도로 명세 제공
컨텍스트 윈도우	대형 파일이나 복잡한 컴포넌트 계층 처리에 한계	노드를 분할해 컴포넌트 단위로 요청
플랜 제약	Starter 플랜·View/Collab 시트는 월 6회 tool call 제한	Professional 이상 플랜 필요 여부 사전 확인
초기 설정 비용	설정에 40~80시간, Code Connect 연동·유지보수 비용 별도	작은 컴포넌트부터 점진적으로 연결
ROI 시간	디자인 시스템 미성숙 팀은 실질 ROI까지 8~12개월 소요	디자인 시스템 정비를 선행하는 것을 권장
비용 전환 예정	현재 베타 무료지만 향후 사용량 기반 유료 전환 예정	사용 패턴 모니터링 후 전환 시점 대비

tool call: MCP에서 AI 에이전트가 외부 서버의 기능을 호출하는 단위. Figma MCP에서는 노드 데이터 읽기, 캔버스 쓰기 등 각 작업이 하나의 tool call로 카운트됩니다.

초기 설정 4080시간이라는 수치가 처음엔 부담스럽게 느껴졌습니다. 저희 팀 기준으로 MCP 연결 자체는 하루 이내로 끝났고, 시간이 걸린 건 Code Connect 매핑을 위해 기존 Figma 파일을 정리하는 작업이었습니다. ROI 812개월 예상치도 디자인 시스템이 없는 팀 기준이고, 이미 컴포넌트 라이브러리가 갖춰진 팀이라면 훨씬 빠르게 효과를 볼 수 있습니다.

실무에서 가장 흔한 실수

디자인 시스템 없이 MCP부터 붙이는 것: Figma 파일 자체가 정리되어 있지 않으면 AI가 읽어도 일관성 없는 코드가 나옵니다. MCP는 좋은 디자인을 더 빠르게 코드로 변환하는 도구지, 엉킨 디자인을 정리해주는 도구가 아닙니다.
Code Connect 없이 컴포넌트 재사용을 기대하는 것: MCP만으로는 AI가 팀의 기존 컴포넌트를 알 방법이 없습니다. Code Connect 매핑 없이 Figma MCP를 쓰면 매번 새 컴포넌트가 생성될 수 있습니다.
대형 페이지 전체를 한 번에 요청하는 것: 컨텍스트 윈도우 제한으로 복잡한 화면 전체를 한 번에 요청하면 정확도가 떨어집니다. 화면을 논리적인 섹션이나 컴포넌트 단위로 나눠서 요청하는 것이 훨씬 좋은 결과를 줍니다.

마치며

Figma MCP는 "AI로 디자인을 코드로 바꾼다"는 기존 시도들과 달리, 디자인 구조를 직접 읽어 정밀도와 속도를 동시에 높이는 실질적인 워크플로우 변화를 가져옵니다. 이 효과를 제대로 보려면 Figma 파일 정리와 디자인 시스템 성숙도가 선행되어야 합니다. MCP는 좋은 기반 위에서 빛을 발하는 도구입니다. 지금 당장 완벽한 환경이 없더라도, 작은 컴포넌트 하나부터 Code Connect를 연결해보면서 워크플로우를 점진적으로 개선해 나갈 수 있습니다.

지금 바로 시작해볼 수 있는 3단계:

Figma Personal Access Token 발급 후 AI 도구에 MCP 서버 연결해보기 — Figma 설정 → Security → Personal Access Tokens에서 토큰을 발급하고, 사용 중인 Cursor나 Claude Code의 MCP 설정 파일에 추가해볼 수 있습니다. 공식 헬프센터 가이드에 클라이언트별 설정 방법이 정리되어 있습니다.
자주 구현하는 컴포넌트 하나에 Code Connect 매핑 적용해보기 — Button이나 Input처럼 자주 쓰는 컴포넌트 하나를 골라 pnpm add @figma/code-connect로 패키지를 설치하고, Figma 노드와 코드 컴포넌트를 연결하는 .figma.ts 파일을 작성해볼 수 있습니다.
기존 화면 구현 요청을 MCP 방식으로 비교해보기 — 최근에 스크린샷이나 Figma URL 공유 방식으로 AI에게 구현을 요청했던 화면이 있다면, 같은 화면을 MCP로 다시 요청해서 결과를 비교해보시면 좋습니다. 정확도 차이가 눈에 보이게 느껴질 겁니다.

참고 자료

Introducing the Figma MCP Server | Figma Blog — Figma Dev Mode MCP 서버 공식 출시 발표
Figma MCP Server | Figma Developers — 공식 개발자 문서 및 API 레퍼런스
Guide to the Figma MCP server | Figma Help Center — 클라이언트별 설정 방법 안내
Design Systems, AI, and the Role of MCP | Figma Blog — Figma MCP와 디자인 시스템 연동 전략
What is MCP? | Figma Resource Library — MCP 개념 공식 설명
Design Context, Everywhere You Build | Figma Blog — Schema 2025 발표 내용 정리
Code Connect Integration | Figma Developers — Code Connect 공식 레퍼런스
GLips/Figma-Context-MCP | GitHub — 공식 서버 출시 이전부터 존재한 커뮤니티 MCP 서버
figma/mcp-server-guide | GitHub — Figma 공식 MCP 서버 가이드 레포
Schema 2025 Design Systems Recap | Figma Blog — 2025 디자인 시스템 컨퍼런스 발표 정리
The Complete Guide to Figma's MCP Integration | Medium — 독립 개발자의 실전 적용 경험 정리
Figma MCP: Disadvantages and Limitations | Locofy — MCP 한계 및 단점 심층 분석, 수치 인용 출처
Figma MCP Server for Design-to-Code | Builder.io — 디자인-코드 전환 속도·토큰 절감 수치 근거

Figma MCP로 디자인-코드 반복 주기 최대 80% 단축하기: Model Context Protocol과 AI 코딩 에이전트 실전 연동 | DEV BAK - 기술블로그

Figma MCP로 디자인-코드 반복 주기 최대 80% 단축하기: Model Context Protocol과 AI 코딩 에이전트 실전 연동

이 글의 핵심 3줄 Figma MCP는 AI가 디자인을 이미지가 아닌 구조 데이터로 읽게 해서 코드 정확도와 속도를 동시에 높입니다. Cursor·Claude Code에 MCP를 연결하고, Code Connect로 기존 컴포넌트를 매핑하면 반복 시간을 최대 80% 줄일 수 있습니다. 이 글을 읽고 나면 MCP 서버를 연결하고, 첫 Figma 노드를 컴포넌트로 변환하고, Code Connect까지 적용하는 것을 직접 해볼 수 있습니다.

핵심 개념

MCP와 Figma가 연결되는 방식

Model Context Protocol (MCP): Anthropic이 2024년 말 처음 제안한 개방형 표준으로, AI 에이전트가 외부 애플리케이션과 표준화된 방식으로 상호작용할 수 있도록 정의한 프로토콜. USB-C 포트처럼, 어떤 AI 클라이언트든 같은 인터페이스로 다양한 외부 도구에 연결할 수 있게 해줍니다.

기존 방식과 Figma MCP 방식의 실질적 차이

용어 정리: Auto Layout은 Figma의 반응형 레이아웃 시스템(CSS Flexbox와 유사), variant는 하나의 컴포넌트에 정의된 여러 상태(예: Button의 Primary/Secondary/Destructive), 노드 트리는 Figma 디자인의 계층 구조입니다. HTML DOM 트리와 비슷하다고 생각하시면 빠르게 이해가 됩니다.

스크린샷 방식: AI → 이미지 픽셀 분석 → 추측 기반 코드
Figma MCP 방식: AI → 구조화된 노드 데이터 → 정확한 코드

읽기와 쓰기, 양방향으로 작동한다

Figma MCP 서버의 기능은 두 방향으로 작동합니다.

방향	기능	활용 예시
읽기 (Design → Code)	노드 트리, 토큰, 제약 읽기	"이 Figma 화면을 React 컴포넌트로 구현해줘"
쓰기 (Code → Canvas)	프레임, 컴포넌트, Auto Layout 생성·수정	AI가 Figma 캔버스에 직접 디자인 생성

배포 방식: Remote vs Desktop

배포 방식	특징	선택 기준
Remote MCP 서버	Figma 팀이 호스팅, 브라우저 기반 Figma에서 사용, 별도 설치 불필요, OAuth 인증 방식	대부분의 팀에 권장. 인터넷 연결이 안정적이고 설치 없이 바로 쓰고 싶을 때
Desktop MCP 서버	Figma 데스크탑 앱을 통해 로컬 실행, Personal Access Token 방식	오프라인 환경이 필요하거나 네트워크 레이턴시가 체감되는 상황

실전 적용

현장에서 가장 자주 쓰는 패턴: Figma 화면을 React 컴포넌트로 바로 변환하기

json

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "@figma/mcp-server"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "your_figma_access_token"
      }
    }
  }
}

⚠️ 패키지명(@figma/mcp-server)은 공식 문서의 최신 버전을 반드시 확인하시는 것을 권장합니다. Figma MCP는 베타 기간이라 패키지명이나 설치 방식이 업데이트될 수 있습니다. 공식 헬프센터 가이드가 항상 최신 상태입니다.

Figma URL: https://www.figma.com/file/xxx/yyy?node-id=1234%3A56
 
이 Figma 컴포넌트를 우리 디자인 시스템의 Button 컴포넌트를 사용해서
React TypeScript로 구현해줘. Tailwind CSS 사용.

비교 항목	스크린샷 방식	Figma MCP 방식
색상 정확도	추측 (근사값)	정확한 토큰 값
간격 수치	육안 추정	Auto Layout 수치 그대로
컴포넌트 변형 인식	불가	variant 구조 직접 파악
LLM 토큰 소비	높음 (이미지 처리)	30~50% 절감 (Builder.io, 2025)

처음에 몰라서 헤맸던 것: Code Connect로 기존 컴포넌트 재사용하기

Code Connect: Figma 라이브러리 컴포넌트를 실제 코드베이스 컴포넌트에 1:1로 매핑하는 도구. AI가 Figma에서 Button 컴포넌트를 만났을 때, 팀의 @design-system/Button을 재사용하도록 유도합니다.

⚠️ 플랜 제약: Code Connect UI는 Organization·Enterprise 플랜 전용입니다. Starter나 Professional 플랜 사용자라면 CLI 기반으로 제한적으로 사용할 수 있으니, 시작 전에 플랜을 먼저 확인해 보세요.

Code Connect 설정은 패키지 설치부터 시작합니다.

bash

pnpm add @figma/code-connect

설정 파일을 프로젝트 루트에 추가합니다.

typescript

// figma.config.ts
import { defineConfig } from '@figma/code-connect'
 
export default defineConfig({
  codeConnect: {
    include: ['src/components/**/*.figma.ts'],
  },
})

typescript

// src/components/Button/Button.figma.ts
import React from 'react'
import figma from '@figma/code-connect'
import { Button } from './Button'
 
figma.connect(Button, 'https://www.figma.com/file/xxx?node-id=1234%3A56', {
  props: {
    variant: figma.enum('Variant', {
      Primary: 'primary',
      Secondary: 'secondary',
      Destructive: 'destructive',
    }),
    size: figma.enum('Size', {
      Small: 'sm',
      Medium: 'md',
      Large: 'lg',
    }),
    label: figma.string('Label'),
    disabled: figma.boolean('Disabled'),
  },
  example: ({ variant, size, label, disabled }) => (
    <Button variant={variant} size={size} disabled={disabled}>
      {label}
    </Button>
  ),
})

아이디어를 캔버스로 즉시 옮기기: FigJam 다이어그램 자동 생성

이건 개발자 입장에서 생각보다 편리한 기능입니다. 시스템 설계 단계에서 Mermaid 형식으로 다이어그램 구조를 설명하면 FigJam에 바로 생성해줍니다.

Claude Code나 Cursor에서 다음처럼 요청할 수 있습니다.

shell

다음 Mermaid 시퀀스를 FigJam 다이어그램으로 만들어줘:
 
sequenceDiagram
  participant User
  participant APIGateway
  participant AuthService
  User->>APIGateway: POST /login
  APIGateway->>AuthService: validateCredentials()
  AuthService-->>APIGateway: JWT token
  APIGateway-->>User: 200 OK + token

장단점 분석

처음 팀에 도입을 제안할 때 가장 많이 받은 질문이 "설정 비용 대비 효과가 정말 있냐"였습니다. 직접 써보고 난 뒤 솔직하게 정리하면 이렇습니다.

장점

항목	내용	효과가 최대인 조건
정확도 향상	픽셀 추측이 아닌 정확한 구조 데이터 기반 코드 생성	Figma 파일이 컴포넌트 단위로 잘 정리되어 있을 때
토큰 효율	이미지 대신 구조화 텍스트 전달로 LLM 토큰 30~50% 절감	복잡한 화면일수록 효과 증가
개발 속도	디자인-코드 반복 시간 60~80% 단축 (Builder.io, 2025)	Code Connect까지 연결됐을 때
컴포넌트 재사용	Code Connect 연동 시 실제 컴포넌트 재사용률 80% 이상	디자인 시스템과 코드 컴포넌트가 1:1 대응될 때
양방향 협업	읽기·쓰기 모두 지원해 디자이너-개발자 협업 루프 완성	디자이너가 Figma를 주 도구로 쓸 때
다이어그램 자동화	자연어·Mermaid → FigJam 다이어그램 자동 생성	아키텍처 설계·기획 초기 단계

단점 및 주의사항

항목	내용	대응 방안
반응형 한계	AI가 모바일 적응형 레이아웃을 자동 처리하는 능력 부족	반응형 브레이크포인트는 별도로 명세 제공
컨텍스트 윈도우	대형 파일이나 복잡한 컴포넌트 계층 처리에 한계	노드를 분할해 컴포넌트 단위로 요청
플랜 제약	Starter 플랜·View/Collab 시트는 월 6회 tool call 제한	Professional 이상 플랜 필요 여부 사전 확인
초기 설정 비용	설정에 40~80시간, Code Connect 연동·유지보수 비용 별도	작은 컴포넌트부터 점진적으로 연결
ROI 시간	디자인 시스템 미성숙 팀은 실질 ROI까지 8~12개월 소요	디자인 시스템 정비를 선행하는 것을 권장
비용 전환 예정	현재 베타 무료지만 향후 사용량 기반 유료 전환 예정	사용 패턴 모니터링 후 전환 시점 대비

tool call: MCP에서 AI 에이전트가 외부 서버의 기능을 호출하는 단위. Figma MCP에서는 노드 데이터 읽기, 캔버스 쓰기 등 각 작업이 하나의 tool call로 카운트됩니다.

실무에서 가장 흔한 실수

디자인 시스템 없이 MCP부터 붙이는 것: Figma 파일 자체가 정리되어 있지 않으면 AI가 읽어도 일관성 없는 코드가 나옵니다. MCP는 좋은 디자인을 더 빠르게 코드로 변환하는 도구지, 엉킨 디자인을 정리해주는 도구가 아닙니다.
Code Connect 없이 컴포넌트 재사용을 기대하는 것: MCP만으로는 AI가 팀의 기존 컴포넌트를 알 방법이 없습니다. Code Connect 매핑 없이 Figma MCP를 쓰면 매번 새 컴포넌트가 생성될 수 있습니다.
대형 페이지 전체를 한 번에 요청하는 것: 컨텍스트 윈도우 제한으로 복잡한 화면 전체를 한 번에 요청하면 정확도가 떨어집니다. 화면을 논리적인 섹션이나 컴포넌트 단위로 나눠서 요청하는 것이 훨씬 좋은 결과를 줍니다.

마치며

지금 바로 시작해볼 수 있는 3단계:

Figma Personal Access Token 발급 후 AI 도구에 MCP 서버 연결해보기 — Figma 설정 → Security → Personal Access Tokens에서 토큰을 발급하고, 사용 중인 Cursor나 Claude Code의 MCP 설정 파일에 추가해볼 수 있습니다. 공식 헬프센터 가이드에 클라이언트별 설정 방법이 정리되어 있습니다.
자주 구현하는 컴포넌트 하나에 Code Connect 매핑 적용해보기 — Button이나 Input처럼 자주 쓰는 컴포넌트 하나를 골라 pnpm add @figma/code-connect로 패키지를 설치하고, Figma 노드와 코드 컴포넌트를 연결하는 .figma.ts 파일을 작성해볼 수 있습니다.
기존 화면 구현 요청을 MCP 방식으로 비교해보기 — 최근에 스크린샷이나 Figma URL 공유 방식으로 AI에게 구현을 요청했던 화면이 있다면, 같은 화면을 MCP로 다시 요청해서 결과를 비교해보시면 좋습니다. 정확도 차이가 눈에 보이게 느껴질 겁니다.

참고 자료

Introducing the Figma MCP Server | Figma Blog — Figma Dev Mode MCP 서버 공식 출시 발표
Figma MCP Server | Figma Developers — 공식 개발자 문서 및 API 레퍼런스
Guide to the Figma MCP server | Figma Help Center — 클라이언트별 설정 방법 안내
Design Systems, AI, and the Role of MCP | Figma Blog — Figma MCP와 디자인 시스템 연동 전략
What is MCP? | Figma Resource Library — MCP 개념 공식 설명
Design Context, Everywhere You Build | Figma Blog — Schema 2025 발표 내용 정리
Code Connect Integration | Figma Developers — Code Connect 공식 레퍼런스
GLips/Figma-Context-MCP | GitHub — 공식 서버 출시 이전부터 존재한 커뮤니티 MCP 서버
figma/mcp-server-guide | GitHub — Figma 공식 MCP 서버 가이드 레포
Schema 2025 Design Systems Recap | Figma Blog — 2025 디자인 시스템 컨퍼런스 발표 정리
The Complete Guide to Figma's MCP Integration | Medium — 독립 개발자의 실전 적용 경험 정리
Figma MCP: Disadvantages and Limitations | Locofy — MCP 한계 및 단점 심층 분석, 수치 인용 출처
Figma MCP Server for Design-to-Code | Builder.io — 디자인-코드 전환 속도·토큰 절감 수치 근거

핵심 개념

MCP와 Figma가 연결되는 방식

기존 방식과 Figma MCP 방식의 실질적 차이

읽기와 쓰기, 양방향으로 작동한다

배포 방식: Remote vs Desktop

실전 적용

현장에서 가장 자주 쓰는 패턴: Figma 화면을 React 컴포넌트로 바로 변환하기

처음에 몰라서 헤맸던 것: Code Connect로 기존 컴포넌트 재사용하기

아이디어를 캔버스로 즉시 옮기기: FigJam 다이어그램 자동 생성

장단점 분석

장점

단점 및 주의사항

실무에서 가장 흔한 실수

마치며

참고 자료

핵심 개념

MCP와 Figma가 연결되는 방식

기존 방식과 Figma MCP 방식의 실질적 차이

읽기와 쓰기, 양방향으로 작동한다

배포 방식: Remote vs Desktop

실전 적용

현장에서 가장 자주 쓰는 패턴: Figma 화면을 React 컴포넌트로 바로 변환하기

처음에 몰라서 헤맸던 것: Code Connect로 기존 컴포넌트 재사용하기

아이디어를 캔버스로 즉시 옮기기: FigJam 다이어그램 자동 생성

장단점 분석

장점

단점 및 주의사항

실무에서 가장 흔한 실수

마치며

참고 자료

Recommended Posts

Boosting AI Component Reuse with Figma Code Connect — From Mapping to Measurement in Large-Scale Design Systems

Figma MCP Server + Claude Code/Cursor Integration: Building React Components from a Single Design URL

Five Inference Optimization Techniques to Double or Quadruple LLM Serving Throughput on the Same GPU — From Quantization to Speculative Decoding

Applying Coding Rules and Design Rules Simultaneously to AI Agents — How to Use CLAUDE.md and DESIGN.md Together for Claude Code Team Setup

DESIGN.md: The Agent-Native File Format That Makes AI Coding Agents Follow Brand Design Rules on Their Own

Building Multi-Agent Systems with MCP and A2A — A Practical Integration Guide to Model Context Protocol and Agent-to-Agent Protocol