본문 바로가기
M MCP모아
튜토리얼

Cursor Figma MCP 설치 방법 — 디자인 파일을 Cursor AI에 바로 연결하기

Cursor Figma MCP 설치 방법을 단계별로 안내합니다. 피그마 디자인 파일을 Cursor AI에 바로 연결해 컴포넌트 스펙·레이아웃 정보를 코드로 변환하세요.

Cursor AI와 Figma 디자인 파일이 MCP 프로토콜로 연결되는 흐름을 보여주는 표지 이미지

Cursor에서 Figma MCP를 설치하면 디자인 파일 URL 하나만으로 컴포넌트 스펙을 AI가 직접 읽어 코드를 생성할 수 있습니다. 별도의 플러그인이나 Export 과정 없이 Figma REST API를 통해 레이아웃·색상·타이포그래피 정보가 Cursor Chat으로 전달됩니다. 이 글에서는 Figma Personal Access Token 발급부터 Cursor MCP 설정, 실제 동작 확인까지 전 과정을 다룹니다.

Cursor Figma MCP가 필요한 이유

디자인-개발 협업에서 가장 많이 낭비되는 시간 중 하나는 디자인 스펙 확인입니다. 개발자가 Figma 파일을 열어 패딩 값을 확인하고, 폰트 크기를 기록하고, 색상 헥스 코드를 복사하는 반복 작업은 생산성을 크게 떨어뜨립니다.

Figma MCP(Model Context Protocol 서버)는 이 과정을 자동화합니다. MCP 표준을 통해 Cursor AI가 Figma REST API에 직접 접근해 필요한 정보를 가져오기 때문에, 개발자는 Figma를 별도로 열지 않아도 됩니다.

Cursor Chat
    │
    ▼  (MCP 프로토콜)
Figma MCP 서버 (로컬 프로세스)
    │
    ▼  (Figma REST API)
Figma 클라우드 (디자인 파일 데이터)

위 흐름처럼 Cursor가 Figma MCP 서버를 통해 Figma 클라우드에서 데이터를 받아옵니다. 개발자가 별도로 Export하거나 스펙 시트를 만들 필요가 없습니다.

준비물 확인

설치 전 아래 항목을 미리 갖추어 두세요.

항목최소 버전/조건확인 방법
Node.js18.0 이상node --version
npm9.0 이상npm --version
Cursor최신 버전 권장앱 메뉴 → 버전 확인
Figma 계정무료 플랜 이상figma.com 로그인
Figma PATPersonal Access Token아래 단계 참고

단계별 설치 방법

1단계: Figma Personal Access Token 발급

Figma MCP 서버는 Figma REST API를 호출할 때 Personal Access Token(PAT)으로 인증합니다.

  1. figma.com에 로그인합니다.
  2. 우측 상단 프로필 아이콘 → Settings를 클릭합니다.
  3. Security 탭 → Personal access tokens 섹션으로 이동합니다.
  4. Generate new token 버튼을 클릭하고, 토큰 이름(예: cursor-mcp)을 입력한 뒤 생성합니다.
  5. 발급된 토큰 문자열을 안전한 곳에 복사해 둡니다. 페이지를 벗어나면 다시 볼 수 없습니다.

2단계: Node.js 환경 확인

node --version
# v20.0.0 이상이 출력되면 정상
npm --version
# 9.0.0 이상이 출력되면 정상

Node.js가 설치되지 않았다면 nodejs.org에서 LTS 버전을 설치하세요.

3단계: Figma MCP 서버 실행 테스트

설치 전 npx로 서버가 정상 실행되는지 확인합니다.

FIGMA_ACCESS_TOKEN=your_token_here npx figma-mcp

your_token_here 자리에 1단계에서 발급한 토큰을 입력하세요. 서버가 정상 시작되면 터미널에 MCP 서버 실행 메시지가 출력됩니다. Ctrl+C로 종료합니다.

4단계: Cursor MCP 설정 파일 작성

Cursor는 .cursor/mcp.json 파일을 통해 MCP 서버 목록을 관리합니다.

프로젝트별 설정(권장): 프로젝트 루트에 .cursor/mcp.json 파일을 생성합니다.

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["figma-mcp"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "여기에_발급받은_토큰_입력"
      }
    }
  }
}

전역 설정(모든 프로젝트에 적용): 홈 디렉토리의 ~/.cursor/mcp.json에 동일한 내용을 작성합니다.

중요: .cursor/mcp.json 파일을 Git 저장소에 커밋하면 토큰이 노출됩니다. 반드시 .gitignore에 추가하세요.

echo ".cursor/mcp.json" >> .gitignore

환경 변수를 별도로 관리하고 싶다면 토큰 값을 env 블록에 직접 넣는 대신 시스템 환경 변수(FIGMA_ACCESS_TOKEN)를 미리 설정해 두고 설정 파일에서는 참조하는 방식도 사용할 수 있습니다.

5단계: Cursor 재시작 및 연결 확인

설정 파일을 저장한 뒤 Cursor를 완전히 종료 후 다시 실행합니다. 단순 창 닫기가 아니라 프로세스 종료가 필요합니다.

  • macOS: Cmd+Q
  • Windows: 작업 표시줄에서 우클릭 → 창 닫기

Cursor가 재시작되면 좌측 하단 또는 Settings → MCP 메뉴에서 figma 서버가 연결됨 상태인지 확인합니다.

6단계: Figma URL로 디자인 데이터 조회

Cursor Chat 창을 열고 Figma 파일 URL을 포함해 요청을 보냅니다.

https://www.figma.com/design/XXXXXX/프로젝트명 파일의 Button 컴포넌트 스펙을 알려줘

AI가 MCP를 통해 Figma 파일에 접근해 컴포넌트 이름, 크기, 색상 코드, 폰트 정보 등을 반환합니다. 이어서 “이걸 React 컴포넌트로 만들어줘”라고 요청하면 스펙에 맞는 코드를 생성합니다.

흔한 오류와 해결 방법

증상원인해결 방법
MCP 서버가 목록에 나타나지 않음Cursor를 완전히 재시작하지 않음Cursor 프로세스 종료 후 재실행
JSON parse errormcp.json 문법 오류jsonlint.com에서 JSON 유효성 검사
Unauthorized 오류잘못된 Figma PATFigma에서 토큰 재발급 후 mcp.json 업데이트
Cannot find module 'figma-mcp'Node.js 또는 npm 버전 문제node --version 확인, Node.js 18+ 설치
Figma 파일 접근 거부해당 파일 접근 권한 없음파일이 공개 상태이거나 계정에 공유되어 있는지 확인

Cursor Figma MCP 활용 팁

Figma MCP를 설치하면 다음과 같은 실용적인 워크플로우가 가능합니다.

디자인 스펙 자동 추출: Figma URL을 붙여넣으면 특정 프레임의 모든 속성(패딩, 마진, 색상, 폰트 등)을 텍스트로 요약해줍니다.

컴포넌트 코드 생성: 스펙을 확인한 뒤 “Tailwind CSS로 구현해줘” 또는 “styled-components로 만들어줘”처럼 요청하면 디자인에 충실한 코드가 생성됩니다.

디자인 시스템 일관성 검토: 여러 컴포넌트를 한 번에 불러와 색상이나 간격이 일관되게 사용되고 있는지 AI에게 검토시킬 수 있습니다.

자주 묻는 질문

Cursor Figma MCP를 사용하면 어떤 점이 달라지나요?

Figma 디자인 파일의 컴포넌트 이름, 크기, 색상, 레이아웃 등 스펙 정보를 Cursor AI가 직접 읽을 수 있습니다. 디자이너의 의도를 AI가 정확히 파악한 뒤 React, Vue 등의 컴포넌트 코드를 생성하므로, 디자인-개발 간 소통 비용이 줄어듭니다.

Figma MCP는 Figma 무료 플랜에서도 동작하나요?

네, Personal Access Token은 Figma 무료 플랜 계정에서도 발급할 수 있습니다. 단, 접근하려는 파일이 공개(public)이거나 본인 계정에 공유된 파일이어야 합니다.

.cursor/mcp.json과 ~/.cursor/mcp.json 중 어디에 설정해야 하나요?

프로젝트 루트의 .cursor/mcp.json에 설정하면 해당 프로젝트에서만 동작합니다. 모든 프로젝트에서 공통으로 쓰려면 홈 디렉토리의 ~/.cursor/mcp.json에 설정하세요.

Figma MCP 연결 후 Cursor에서 디자인 정보가 보이지 않으면 어떻게 하나요?

먼저 Cursor를 완전히 종료하고 재시작해 보세요. 그래도 안 되면 mcp.json의 JSON 문법 오류 여부를 확인하고, FIGMA_ACCESS_TOKEN 환경 변수 값이 올바른지 점검하세요.

Figma MCP는 Windows에서도 동작하나요?

Node.js가 설치된 Windows 환경에서도 동작합니다. 단, 설정 파일 경로가 %APPDATA%\Cursor\mcp.json일 수 있으니 Cursor 공식 문서를 참고하세요.

Personal Access Token이 노출되면 어떻게 해야 하나요?

즉시 Figma Account Settings에서 해당 토큰을 삭제하고 새 토큰을 발급하세요. 토큰을 mcp.json에 직접 기입할 경우 .gitignore에 해당 파일을 추가해 저장소에 커밋되지 않도록 주의하세요.

다음 단계

Figma MCP 설치를 완료했다면 개발 도구 카테고리의 다른 MCP 서버도 살펴보세요. 한국 업무 환경에서 자주 사용하는 문서 형식을 처리하는 서버도 함께 연결해 두면 편리합니다.

  • 코르독(KorDoc) — HWP·PDF·XLSX 등 한국 공문서를 Markdown으로 변환하는 MCP 서버
  • HWP-MCP — 한글(.hwp/.hwpx) 문서를 AI가 읽고 편집할 수 있게 해주는 MCP 서버
  • 한포지(HwpForge) — HWPX 문서를 AI 에이전트가 읽고 쓰고 변환하는 MCP 서버

더 많은 MCP 서버 목록은 MCP모아 서버 디렉토리에서 확인하세요. 직접 개발한 MCP 서버를 등록하고 싶다면 서버 등록 페이지를 방문해 주세요.

이 글과 관련된 MCP 서버