Figma MCP를 연결했는데 에이전트가 파일은 읽어도 직접 고치지는 못한다는 질문이 반복해서 보였다. 연결만 되면 바로 canvas를 수정할 줄 알았지만, 읽기와 쓰기는 같은 단계가 아니었다.

직접 수정하려면 세 가지를 따로 확인해야 한다. 쓰기를 지원하는 remote MCP, Figma 작업 순서를 알려주는 Skill, 수정 권한이 있는 파일이다. 세 조건을 맞춘 다음 작은 변경 하나로 직접 수정이 되는지만 확인해 보자.

기존 구조를 살펴보고 컴포넌트를 재사용해 한 가지만 수정한 뒤 캔버스에서 확인하는 흐름.

MCP는 연결이고, 수정은 도구가 한다

Figma MCP는 AI 에이전트와 Figma 사이의 연결 통로다. 에이전트는 이 통로로 frame, component, variable, auto layout 같은 디자인 구조를 읽는다. 쓰기 도구가 열려 있으면 같은 통로에서 canvas의 객체도 만들거나 고친다.

Figma MCP 개발자 문서는 이 둘을 함께 설명한다. 디자인 정보를 코드 작업 환경으로 가져오는 기능과, Figma 고유 객체를 다시 쓰는 기능이다. 그러므로 “MCP를 연결했다”는 말만으로는 수정 준비가 끝났다고 보기 어렵다. 현재 연결 방식과 실제 도구 목록도 함께 봐야 한다.

핵심 쓰기 도구는 use_figma다. Figma의 도구 목록에 따르면 이 도구는 Figma Design의 page, frame, component, variable, style, text, image 등을 만들거나 수정하고 살펴본다. 이 도구는 remote MCP에서만 제공된다. 읽기 전용 연결이나 desktop 선택 기반 연결만 보고 있다면 같은 결과가 나오지 않는다.

먼저 remote MCP와 쓰기 Skill을 확인한다

Figma는 대부분의 사용자에게 hosted endpoint에 연결하는 remote MCP를 권한다. Desktop 앱이 없어도 연결되고, 현재 가장 넓은 도구 묶음을 제공하기 때문이다. 정확한 설치 방법은 에이전트마다 다르지만 연결 주소는 공식 문서의 https://mcp.figma.com/mcp다.

연결 뒤에는 Figma 계정 인증을 거친다. 그다음 에이전트에서 현재 열린 Figma 도구 목록을 확인한다. 여기서 use_figma가 보이지 않으면 프롬프트를 바꾸기 전에 연결 종류와 지원 client를 다시 보는 편이 빠르다. remote MCP 설치 문서와 Figma MCP client 목록은 지원 범위가 바뀔 때 다시 확인할 기준점이다.

쓰기 도구만 있다고 안정적으로 수정되는 것은 아니다. Figma는 figma-use Skill을 함께 쓰라고 안내한다. 여기서 Skill은 새 권한을 추가하는 기능이 아니다. 어떤 객체를 먼저 확인하고, 기존 component와 variable을 어떻게 찾으며, 수정 뒤 무엇을 다시 볼지 순서를 알려주는 지침 묶음이다.

Figma의 Skill 안내는 remote MCP 연결과 Skill 접근을 별도 조건으로 둔다. 공식 figma-use Skill도 use_figma 호출 전에 이 절차를 먼저 불러오도록 정한다. 연결은 통로를 만들고, Skill은 그 통로를 어떤 순서로 쓸지 알려준다.

화면 전체보다 작은 수정으로 시작한다

처음 확인할 때는 새 앱 화면 전체를 만들지 않는 편이 낫다. 기존 component를 무시한 채 비슷한 객체를 새로 만들거나, spacing과 auto layout을 한꺼번에 바꾸면 결과가 맞는지 판단하기 어렵다.

이미 있는 frame 하나를 고르고, 되돌리기 쉬운 변경 하나만 맡긴다.

이 Figma frame을 먼저 살펴봐.
기존 component와 variable을 그대로 사용해.
새 component는 만들지 말고, 선택한 버튼의 문구만 "저장"으로 바꿔.
수정 뒤 바뀐 객체와 확인할 점을 알려줘.

remote MCP는 선택 상태 대신 Figma의 frame이나 layer 링크로 대상을 받는다. remote와 desktop MCP 비교 문서는 remote 연결은 link 기반이고, desktop 연결은 현재 선택한 layer를 문맥으로 쓴다고 구분한다.

첫 변경이 끝나면 canvas에서 직접 본다. 문구가 맞는지뿐 아니라 기존 component instance를 유지했는지, variable 연결이 끊기지 않았는지, auto layout이 달라지지 않았는지 확인한다. 문제가 있으면 다음 요청은 한 가지 오류만 고치게 한다. 한 번에 범위를 넓히면 어떤 지시가 디자인을 망가뜨렸는지 찾기 어려워진다.

디자인 시스템을 자동으로 이해하지는 않는다

Figma MCP가 연결됐다고 에이전트가 팀의 디자인 판단까지 아는 것은 아니다. Figma의 MCP와 에이전트 역할 설명은 MCP가 component, token, variable 같은 구조를 전달하지만, 팀의 관례와 선택 기준은 저절로 이해하지 못한다고 선을 긋는다.

예를 들어 PrimaryButton과 QuietButton이 모두 있어도 어떤 상황에 무엇을 써야 하는지는 이름만으로 부족하다. 이 규칙은 component 설명, variable, Code Connect, Skill 같은 형태로 따로 드러내야 한다. Figma의 MCP 설명도 디자인 시스템에 이미 적어 둔 내용이 에이전트가 활용할 문맥이 된다고 설명한다.

그래서 첫 요청에 “디자인 시스템을 지켜줘”라고만 쓰지 않는다. 수정할 frame, 재사용할 component, 유지할 variable, 만들지 말아야 할 객체를 구체적으로 적는 편이 낫다.

마지막 판단은 canvas에서 한다

AI 에이전트가 Figma를 직접 고친다는 말은 디자인을 알아서 완성한다는 뜻이 아니다. 읽기 연결과 쓰기 도구가 있고, Skill이 작업 순서를 보완하며, 사람은 실제 canvas에서 결과를 확인한다.

처음에는 다음 네 단계면 충분하다.

  1. remote MCP를 연결하고 Figma 계정을 인증한다.
  2. use_figma와 figma-use Skill이 준비됐는지 확인한다.
  3. 기존 frame 하나에 되돌리기 쉬운 변경 하나만 맡긴다.
  4. component, variable, auto layout이 유지됐는지 canvas에서 직접 확인한다.

Figma는 AI 기능과 지원 client, beta 과금 조건을 계속 조정하고 있다. 이 글의 제품 동작은 2026년 8월 4일 공식 문서를 기준으로 확인했다. 메뉴 이름이나 지원 범위가 다르면 프롬프트보다 Figma MCP 개발자 문서와 client 목록을 먼저 다시 보는 편이 안전하다.

확인한 공식 자료