목업을 만들 때마다 같은 이미지를 다시 건네고 있다면
제품 사진으로 브랜드 목업을 만드는 일은 짧아 보여도 도구를 옮길 때마다 손이 갑니다. 챗봇에서 작업을 정리하고, 제작 도구에 이미지를 다시 넣고, 결과를 가져와 다음 수정을 설명해야 하니까요. 디자인보다 입력과 결과를 전달하는 과정이 더 길어질 때도 있습니다.
Figma Weave MCP는 이 왕복을 줄일 수 있는 연결 방식입니다. ChatGPT·Claude·Cursor처럼 Figma Weave를 지원하는 MCP 클라이언트에서 접근 가능한 워크플로우를 찾고, 입력을 확인한 뒤 실행 결과까지 받아볼 수 있습니다.
줄어드는 것은 디자인 앱 자체가 아닙니다. 이미 만들어둔 작업 절차를 다른 대화에서 다시 조립하는 수고예요. 다만 모든 Weave 작업이 자동으로 보이는 것은 아니며, 별도 유료 Weave 계정과 워크플로우별 입력 조건도 갖춰야 합니다.
에이전트가 실행하는 것은 ‘접근 가능한 게시 워크플로우’입니다
Weave 캔버스에 있는 작업이라고 모두 MCP 목록에 나타나지는 않습니다. 공식 명세에 따르면 에이전트가 조회할 수 있는 것은 인증된 사용자가 현재 활성 워크스페이스에서 실행할 수 있는 게시된 워크플로우입니다. 내가 게시한 도구, 워크스페이스에 공유된 도구, 내 이메일로 직접 공유된 도구는 대상이 될 수 있지만 비공개 워크플로우는 반환되지 않습니다.
따라서 “도구를 만들었는데 왜 안 보이지?”라는 문제가 생기면 프롬프트부터 고칠 필요는 없습니다. 먼저 해당 워크플로우가 게시됐는지, 연결한 Figma 계정에 공유됐는지, 올바른 워크스페이스가 활성화돼 있는지 확인해야 합니다.
도구 이름은 예시일 뿐입니다. 이 글에서 사용하는 ‘Brand mockup’은 모든 계정에 기본 제공되는 고정 기능이 아닙니다. 실제 목록에 나타난 워크플로우를 선택하고, 그 도구가 요구하는 입력 필드와 형식을 조회해야 합니다.
Figma MCP Catalog에는 Claude·ChatGPT·Cursor의 지원 제품에 Weave가 표시돼 있습니다. 카탈로그의 읽기·쓰기 표시는 클라이언트 차원의 지원 범위이며, 특정 워크플로우를 누구나 실행할 수 있다는 뜻은 아닙니다. 최종 접근 범위는 인증 계정과 게시·공유 상태에 따라 달라집니다.
한 문장 뒤에는 입력 확인부터 결과 조회까지 이어집니다
실행 전에 가장 먼저 확인할 것은 도구의 입력 계약입니다. Weave MCP는 각 워크플로우의 필수 입력, 유형, 선택지, 범위와 기본값을 조회할 수 있도록 구성돼 있습니다. 이를 확인하지 않고 임의의 이미지나 옵션을 보내면 필수 값 누락이나 형식 불일치로 막힐 수 있습니다.
| 단계 | 확인할 것 | 막히는 대표 원인 |
|---|---|---|
| 도구 조회 | 현재 계정이 접근할 수 있는 게시 워크플로우 | 비공개, 공유 누락, 다른 워크스페이스 |
| 입력 조회 | 필수 여부, 유형, 선택지, 기본값 | 필수 값 누락, 형식 불일치 |
| 자산 전달 | 지원되는 첨부 파일 또는 실제 파일을 반환하는 공개 HTTPS URL | 지원하지 않는 형식, 접근 불가 URL |
| 실행 확인 | 실행 횟수와 크레딧 비용 | 크레딧 부족, 유료 실행 비용 미승인 |
| 결과 조회 | COMPLETED 상태와 출력물 | 입력·권한·워크플로우 오류 |
채팅에 첨부한 파일은 자산 업로드 도구를 거쳐 Weave 입력에 사용할 수 있습니다. 공식 명세에 명시된 이미지 형식은 PNG, JPG/JPEG, WebP, HEIC입니다. 공개 HTTPS URL을 직접 넣을 수도 있지만, 로그인 페이지가 아니라 실제 파일에 공개적으로 접근할 수 있는 주소여야 합니다.
실행 횟수는 1회부터 10회까지 지정할 수 있습니다. 크레딧이 필요한 실행은 비용이 먼저 제시되고 이를 확인한 뒤 시작되며, 무료 실행은 비용 확인 단계를 건너뜁니다. 실행 후 상태는 RUNNING·COMPLETED·FAILED·CANCELED 중 하나로 조회됩니다.
비용은 Figma 플랜과 Weave 플랜을 나눠 봐야 합니다
MCP에서 Weave 도구를 실행하려면 유료 독립형 Figma Weave 계정이 필요합니다. Figma와 Weave는 별도 제품이며 플랜과 크레딧도 분리돼 있습니다. 크레딧이 필요한 Weave 실행에는 Figma AI 크레딧이 아니라 Weave 크레딧이 사용됩니다.
그렇다고 모든 실행에 크레딧 비용이 붙는 것은 아닙니다. 실제 비용은 사용하는 워크플로우의 모델과 구성에 따라 달라지고, 유료 실행이라면 시작 전에 제시됩니다. ChatGPT나 Claude 자체의 유료 요금제가 필요한지는 Figma 문서만으로 일괄 확정할 수 없으므로 사용하는 클라이언트의 현재 조건을 별도로 확인해야 합니다.
Figma 데이터를 읽는 일반 MCP 도구에는 좌석과 플랜별 한도도 있습니다. Starter의 View·Collab 좌석은 월 최대 20회, Professional·Organization·Enterprise의 View·Collab 좌석은 월 최대 6회이며, Dev·Full 좌석은 별도의 일일·분당 한도를 따릅니다.
이 숫자를 Weave 실행 한도로 바꾸어 읽으면 안 됩니다. 공식 문서는 해당 한도가 Figma 데이터를 읽는 도구에 적용된다고 설명하지만 Weave 도구 조회나 실행에 동일하게 적용된다고 명시하지 않습니다. Weave 도입 비용은 계정 수, 반복 실행 횟수, 실행 전에 표시되는 크레딧을 따로 기록해 계산하는 편이 정확합니다.
Cursor에서 실제 이미지로 첫 실행을 연결해보세요
아래 절차는 공식 문서에서 설치 화면과 인증 순서를 확인할 수 있는 Cursor를 기준으로 합니다. 공개 문서를 바탕으로 구성한 절차이며, 편집부가 유료 Weave 실행을 직접 완료한 결과는 아닙니다.
- Cursor를 설치하고 로그인합니다.
Cursor 공식 Quickstart에서 운영체제에 맞는 데스크톱 앱을 내려받아 설치하세요. 앱을 실행한 뒤 Cursor 계정으로 로그인해야 Agent 채팅에서 다음 명령을 입력할 수 있습니다. - 실행 조건을 준비합니다.
OAuth로 연결할 Figma 계정, 유료 독립형 Weave 계정, 현재 워크스페이스에서 그 계정이 접근할 수 있는 게시 워크플로우가 필요합니다. 유료 실행이라면 제시된 비용을 충당할 Weave 크레딧도 준비하세요. - Figma 플러그인을 설치하고 인증합니다.
Cursor의 Agent 채팅에 /add-plugin figma를 입력하세요. 설치 후 Cursor Settings의 Tools & MCP에서 Figma 옆 Connect를 누르고 브라우저에서 Figma OAuth 인증을 완료합니다. 수동 연결에 사용하는 공식 원격 서버 주소는 https://mcp.figma.com/mcp입니다. - 실행 가능한 도구 목록부터 확인합니다.
Agent에 “내가 실행할 수 있는 Weave 도구를 보여줘”라고 요청하세요. 원하는 도구가 없다면 반복 호출하지 말고 Figma 계정, 활성 워크스페이스, 게시·공유 상태를 확인합니다. - 실제 도구의 입력 계약을 조회합니다.
목록에서 도구 하나를 선택해 “이 도구의 필수 입력, 허용 형식, 기본값과 크레딧 사용 여부를 먼저 보여줘”라고 요청하세요. 이미지 입력이 없거나 다른 형식을 요구한다면 아래 예시를 그대로 실행하지 말고 조회된 계약에 맞춰 바꿉니다. - 지원 형식의 실제 이미지를 첨부합니다.
직접 사용할 PNG, JPG/JPEG, WebP 또는 HEIC 파일을 Cursor 대화에 첨부하세요. 첨부한 파일을 Weave에 업로드해 조회한 이미지 입력으로 사용하고, 실행 횟수는 1회로 지정해 달라고 요청합니다. - 비용과 완료 상태를 확인합니다.
크레딧 비용이 표시되면 값을 검토하고 동의할 때만 실행하세요. 무료 실행이라면 이 확인 없이 진행됩니다. 이어서 상태를 조회해 COMPLETED와 출력물이 반환되는지 확인합니다. FAILED라면 반환된 오류에 맞춰 입력 형식, 공유 권한, 활성 워크스페이스 또는 크레딧 문제를 수정하세요.
내가 실행할 수 있는 Weave 도구를 보여줘. 목록에서 내가 선택한 도구의 필수 입력과 기본값, 크레딧 사용 여부를 먼저 알려줘. 이 대화에 첨부한 실제 제품 이미지를 Weave에 업로드해 이미지 입력으로 사용하고 1회 실행해줘.
이 요청문은 구조를 보여주는 예시입니다. 도구 이름과 이미지 입력 필드는 실제로 조회된 계약에 맞춰야 합니다. 공개 URL을 쓰고 싶다면 예시용 주소가 아니라 사용자가 관리하며 실제 이미지 파일을 반환하는 HTTPS URL을 제공하세요.
첫 성공 기준은 결과물이 예쁜지가 아닙니다. 게시 워크플로우가 목록에 나타나고, 입력 계약이 조회되며, 첨부 자산을 전달한 1회 실행이 COMPLETED 상태와 출력물을 반환하는지 확인하세요. 이 기준을 통과한 다음부터 브랜드 적합성과 수정 횟수를 평가하면 됩니다.
