본문 바로가기
스터디 열기

피그마 MCP 활용하기

피그마 MCP를 Claude Code에 연결하면 피그마 디자인을 코드로 옮기거나, 만든 화면을 피그마 디자인으로 보낼 수 있습니다. 이 절에서는 디자인 도구 피그마(Figma)를 Claude Code에 연결해, 피그마 디자인을 코드로 옮기거나 만든 화면을 피그마로 보내는 방법을 다룹니다. 2026년 10월 기준 피그마 공식 문서로 확인한 원격 MCP 서버 연결 방법을 기준으로 설명합니다.

1. 피그마는 언제 필요할까

피그마는 웹 브라우저에서 화면을 디자인하고, 링크 하나로 여러 사람이 함께 작업하는 디자인 도구입니다. 전 세계 디자이너가 가장 많이 쓰는 도구 가운데 하나이고, 위니브도 디자인 시스템, 웹과 앱 화면, 카드뉴스, 교안 이미지, 책 표지까지 거의 모든 디자인을 피그마로 합니다.

Figma 바로가기

혼자 바이브 코딩을 한다면 피그마를 꼭 배울 필요는 없습니다. 06-3처럼 AI에게 시안을 받아 고르는 편이 빠릅니다. 피그마가 필요해지는 때는 이럴 때입니다.

  • 디자이너와 함께 일할 때: 디자이너가 피그마로 만든 화면을 그대로 코드로 옮겨야 합니다.
  • 이미 피그마에 디자인이 있을 때: 회사나 팀의 디자인 시스템이 피그마에 정리되어 있습니다.
  • 만든 화면을 디자이너에게 넘길 때: AI로 만든 화면을 피그마로 보내 디자이너가 다듬게 합니다.

피그마 커뮤니티에는 무료 템플릿과 디자인 시스템도 많아서 레퍼런스를 찾는 곳으로도 쓸 만합니다.

피그마 커뮤니티에서 무료 템플릿과 디자인 시스템을 둘러보는 화면입니다.

2. 피그마 MCP 서버

MCP는 Claude 같은 AI가 바깥 프로그램과 연결되어 실제 작업을 할 수 있게 해 주는 통로입니다. MCP가 무엇이고 어떻게 추가하는지는 3장의 Claude MCP 절에서 다룹니다.

피그마 MCP 서버는 피그마가 공식으로 제공하는 MCP 서버입니다. 예전 원고를 쓸 때는 피그마 데스크톱 앱을 켜고 개발자 모드에서 'Dev Mode MCP 서버'를 따로 켜야 했고, 유료 요금제가 필요했습니다. 지금은 피그마가 운영하는 원격 서버(https://mcp.figma.com/mcp)에 바로 연결하는 방식이 기본이고, 피그마도 이 방식을 권합니다. 데스크톱 앱을 통한 연결은 일부 유료 요금제의 특별한 경우에만 씁니다.

하고 싶은 일요청 예시
피그마 디자인을 코드로"이 피그마 프레임을 HTML과 CSS로 만들어줘"
디자인 정보 뽑기"이 디자인에 쓰인 색과 글꼴, 간격을 정리해줘"
만든 화면을 피그마로"지금 만든 페이지를 피그마 디자인으로 보내줘"

2.1 요금제와 사용량

원격 서버는 무료 요금제를 포함한 모든 요금제에서 쓸 수 있습니다. 다만 쓸 수 있는 양이 다릅니다. 피그마 공식 문서 기준으로 무료(Starter) 요금제나 보기·협업 좌석은 한 달에 20번까지, 유료 Professional 요금제의 Full·Dev 좌석은 하루 200번(분당 10번)까지입니다. 연습 삼아 몇 번 써 보기에는 무료로도 충분하지만, 실제 작업에 자주 쓰려면 유료 좌석이 필요합니다. 피그마 파일에 디자인을 직접 써 넣는 기능은 아직 베타라 무료이고, 나중에 사용량에 따른 유료 기능이 될 예정이라고 안내되어 있습니다. 요금제와 한도는 바뀔 수 있으니 쓰기 전에 아래 공식 문서를 확인하세요.

3. Claude Code에 연결하기

피그마 공식 문서가 권하는 방법은 플러그인 설치입니다. 터미널에서 다음 명령을 입력합니다.

claude plugin install figma@claude-plugins-official

그다음 순서는 이렇습니다.

  1. Claude Code를 다시 시작합니다.
  2. /plugin을 입력하고, 오른쪽 화살표로 Installed 탭으로 갑니다.
  3. figma를 고르고 Enter를 누른 뒤, 한 번 더 Enter를 눌러 인증을 시작합니다.
  4. 브라우저가 열리면 피그마에 로그인하고 Allow access를 누릅니다.

플러그인을 쓸 수 없는 환경이라면 MCP 서버를 직접 추가해도 됩니다. 예전 원고의 --transport sse 방식은 지금 Claude Code에서 권하지 않는 방식이니 http로 추가합니다.

claude mcp add --transport http figma https://mcp.figma.com/mcp

새 Claude Code 세션에서 /mcp를 입력하고 figma를 골라 Authenticate를 누르면 피그마 로그인 창이 열립니다. 모든 프로젝트에서 쓰려면 명령에 --scope user를 붙여 추가합니다.

4. 피그마 디자인을 코드로 옮기기

연결이 끝나면 피그마에서 옮기고 싶은 프레임의 링크를 복사해 Claude Code에 붙여 넣습니다. 프레임을 고른 상태에서 복사한 링크에는 그 프레임의 위치가 함께 담깁니다.

이 피그마 프레임을 HTML과 CSS로 만들어줘.
https://www.figma.com/design/....

피그마에서 고른 디자인 프레임입니다.

Claude Code가 피그마 디자인을 HTML과 CSS로 옮긴 결과 화면입니다.

옮긴 뒤에는 평소처럼 말로 다듬습니다.

디자인은 그대로 두고 휴대폰 화면에서도 잘 보이게 해줘.
버튼에 마우스를 올리면 자연스럽게 반응하도록 해줘.

반대 방향도 됩니다. 바이브 코딩으로 만든 화면을 피그마로 보내 달라고 하면, 피그마 파일에 편집할 수 있는 디자인으로 옮겨 줍니다. 디자이너에게 "AI로 이렇게 만들어 봤는데 다듬어 주세요"라고 넘길 때 편합니다.

5. 잘 되게 하는 요령

  • 작게 나누기: 긴 랜딩 페이지 전체보다 섹션 하나씩 옮기면 결과가 정확합니다.
  • 결과는 브라우저로 확인하기: 옮긴 화면이 피그마 디자인과 같은지 직접 비교합니다. Claude Code를 크롬과 연결하면 Claude가 직접 브라우저를 열어 비교하게 할 수도 있습니다(11장).
  • 로고와 그림 파일: 로고나 아이콘이 깨져 보이면 피그마에서 직접 SVG나 PNG로 내려받아 프로젝트 폴더에 넣고 "이 파일로 바꿔줘"라고 하는 편이 확실합니다.

추천 도서

MCP 활용법을 더 자세히 알고 싶다면?

「10분 만에 따라 하는 Claude MCP 업무 자동화 혁신 가이드」 - 이호준

마지막 수정