Figma MCP Server
Figma AI 에이전트, 이 경우엔 작동 안 합니다
2026년 3월 24일, Figma가 AI 에이전트에게 캔버스 쓰기 권한을 열었습니다. 하지만 공식 블로그에 나온 것처럼 매끄럽게 작동하는 건 특정 조건을 갖춘 팀에서만 가능합니다. 무조건 쓸 수 있다고 생각하면 첫날부터 막힙니다.
Figma AI 에이전트란 무엇인가 — 3월 24일에 무슨 일이 있었나
2026년 3월 24일, Figma가 공식 블로그에 “Agents, Meet the Figma Canvas”를 올렸습니다. 핵심은 단순합니다. 지금까지 AI 에이전트는 Figma 파일을 읽기만 할 수 있었는데, 이제 직접 쓰기가 가능해졌습니다. (출처: Figma 공식 블로그, 2026.03.24)
이 변화가 생긴 기술적 기반은 MCP(Model Context Protocol)입니다. Anthropic이 만든 AI-앱 연결 표준인데, Figma가 자체 MCP 서버를 통해 캔버스를 에이전트에게 완전히 열어놓았습니다. 이제 Claude Code, Codex, Cursor 같은 코딩 에이전트가 Figma 파일을 직접 열고, 컴포넌트를 만들고, 디자인 시스템 변수를 적용할 수 있습니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니, ‘AI가 디자인을 대신 한다’는 표현은 절반만 맞습니다. 더 정확하게는 ‘팀이 이미 만들어놓은 디자인 시스템 위에서 에이전트가 조립 작업을 한다’는 구조입니다. 디자인 시스템 자체를 처음부터 AI가 만들어주는 기능이 아닙니다.
Figma가 이걸 이번에 급하게 발표한 배경도 있습니다. 불과 6일 전인 3월 18일, Google이 Stitch의 대규모 업데이트를 하며 “바이브 디자인” 기능을 공개했습니다. 경쟁 압박 속에서 Figma가 서둘러 반격 카드를 꺼냈다는 분석이 나오는 이유입니다.
공짜처럼 보이지만, 쓰기 권한은 유료 시트에서만 열립니다
발표문 어디에도 “무료”라고 강조되어 있어서, 처음엔 누구나 바로 쓸 수 있는 줄 압니다. 실제로는 아닙니다.
공식 헬프센터 문서에는 이렇게 나옵니다. “The new write to canvas feature is currently available to Full and Dev seats on paid plans.” (출처: Figma 헬프센터, help.figma.com, 2026.03.24) 베타 기간 중 무료라는 것은 기능 자체의 API 사용료가 없다는 의미이고, Figma 플랜 자체는 유료여야 합니다. 무료 플랜 사용자는 쓰기 기능을 이용할 수 없습니다.
| 시트 유형 | 읽기 (Read) | 쓰기 (Write) | 비고 |
|---|---|---|---|
| Full 시트 (유료) | ✅ 가능 | ✅ 가능 | 전체 기능 이용 |
| Dev 시트 (유료) | ✅ 가능 | ⚠️ 드래프트만 | 드래프트 파일 한정 |
| 무료 플랜 | ✅ 가능 | ❌ 불가 | AI 에이전트 쓰기 불가 |
Dev 시트는 쓰기가 된다고 해도 드래프트 파일 안에서만 가능합니다. 팀 라이브러리나 공유 파일에는 건드리지 못합니다. 실제 협업 환경에서 쓰려면 Full 시트가 필수입니다. 베타 이후엔 사용량 기반 유료 API로 전환 예정이라고 공식 문서에 명시되어 있어, 지금의 무료 기간은 시험 사용 기회로 보는 게 맞습니다. (출처: Figma 공식 블로그, 2026.03.24)
디자인 시스템을 AI가 알아서 찾아준다고요? 직접 해봤더니 달랐습니다
가장 많이 오해하는 부분입니다. “AI 에이전트가 내 Figma 파일을 연결된 디자인 시스템까지 스스로 파악해서 맞춰준다”는 기대가 큽니다. 막상 해보면 다릅니다.
Figma의 파트너사인 Bitovi가 베타 초기에 6가지 시나리오로 실사용 테스트를 진행했습니다. 결론부터 말하면, 디자인 시스템 감지는 자동이 아닙니다. 에이전트는 연결된 디자인 시스템이 있어도 매번 명시적으로 “이 라이브러리를 사용해라”고 지시해야 했습니다. 한 번 지시를 빠뜨렸더니, 화면의 일부 컴포넌트는 디자인 시스템에서 가져오고 나머지는 일반 프레임으로 만들어버렸습니다. (출처: Bitovi 실사용 테스트 보고서, 2026.03.24)
💡 실제 테스트에서 같은 프롬프트로 두 번 실행했을 때 결과물이 달랐습니다. AI 모델 자체가 비결정론적(non-deterministic)이기 때문이고, Figma도 공식 문서에서 이 점을 인정합니다. “AI models are inherently non-deterministic, so the same prompt can produce different results.” (출처: Figma 공식 블로그, 2026.03.24) 이것이 Skills가 필요한 핵심 이유입니다.
색상도 마찬가지입니다. 아무 지시 없이 실행하면 에이전트는 디자인 토큰 대신 하드코딩된 헥스값(#3B82F6 같은)을 박아버립니다. 테마 변경이나 다크 모드 전환이 필요한 순간 이 파일은 쓸 수 없게 됩니다. 명시적으로 “variables를 써라”고 지시했을 때는 올바르게 작동했습니다. 즉, 에이전트 능력의 문제가 아니라 지시의 명확성 문제입니다.
Skills가 없으면 에이전트가 ‘자기 마음대로’ 디자인합니다
Skills는 마크다운으로 쓰는 에이전트 매뉴얼
이번 발표의 또 다른 핵심이 Skills입니다. Skills는 에이전트에게 “우리 팀이 Figma에서 일하는 방식”을 가르치는 마크다운 파일입니다. 플러그인도, 코드도 필요 없습니다. 순수하게 텍스트로 된 지침 파일 하나로 에이전트의 행동을 규격화할 수 있습니다. (출처: Figma 공식 블로그, 2026.03.24)
가장 기초 Skill은 /figma-use입니다. 모든 다른 Skills의 기반이 되는 파운데이션 Skill로, Figma의 파일 구조와 핵심 원칙을 에이전트에게 가르칩니다. 여기서 출발해 팀 전용 규칙을 덧붙이는 방식으로 확장합니다.
출시 당일 커뮤니티가 공개한 9개 Skills:
/figma-generate-library— 코드베이스에서 새 컴포넌트 생성/figma-generate-design— 기존 컴포넌트·변수로 새 화면 생성/create-voice— 스크린 리더 스펙(VoiceOver, TalkBack, ARIA) 자동 생성 (Uber 제공)/apply-design-system— 기존 디자인을 시스템 컴포넌트에 연결 (Edenspiekermann 제공)/sync-figma-token— 코드와 Figma 변수 간 토큰 동기화 + 드리프트 감지 (Firebender 제공)/rad-spacing— 변수 기반 계층적 스페이싱 적용 (Rad Collab 제공)/cc-figma-component— JSON 계약서에서 Figma 컴포넌트 생성 (One North 제공)/edit-figma-design— Warp 기반 디자인 워크플로우 오케스트레이션/multi-agent— 병렬 워크플로우 실행 및 Augment Code 구현
💡 Skills의 존재는 디자인 시스템 문서화에 대한 관점을 바꿉니다. 기존에는 Notion이나 Confluence에 ‘우리 팀 규칙’을 적었고, 그 문서는 사람이 읽었습니다. 이제 그 규칙을 마크다운 Skill 파일로 작성하면 에이전트가 읽고 직접 적용합니다. 문서가 규정이 되는 구조입니다. 디자인 시스템이 탄탄한 팀일수록 이 기능에서 실질적인 이득을 봅니다. 반대로 디자인 시스템이 정리되지 않은 팀은 먼저 정리하는 작업이 선행되어야 합니다.
지금 당장 쓸 수 있는 MCP 클라이언트 9개 비교
Figma MCP 서버는 다양한 코딩 에이전트와 연동됩니다. 공식 문서 기준으로 현재 지원되는 클라이언트는 다음과 같습니다. (출처: Figma 공식 블로그, 2026.03.24)
| 클라이언트 | Skills 호출 | 쓰기 지원 | 특이사항 |
|---|---|---|---|
| Claude Code | /skill-name | ✅ | 토큰 한도 초과 오류 가능 |
| Cursor | 슬래시 명령어 | ✅ | 인증 토큰 만료 버그 있음 |
| Codex (OpenAI) | CLI 명령어 | ✅ | OpenAI 팀 내부 검증 완료 |
| Copilot in VS Code | 슬래시 명령어 | ✅ | VS Code 내 통합 환경 |
| Augment Code | ✅ | ✅ | /multi-agent 병렬 지원 |
| Warp | ✅ | ✅ | /edit-figma-design 공식 지원 |
| Copilot CLI | ✅ | ✅ | 터미널 기반 운용 |
| Firebender | ✅ | ✅ | /sync-figma-token 전용 지원 |
| Factory | ✅ | ✅ | — |
이 중 가장 많이 쓰는 Claude Code와 Cursor는 각각 알려진 버그가 있습니다. 다음 섹션에서 공식 문서에 명시된 오류와 해결 방법을 정리했습니다.
공식 문서에서 확인한 알려진 오류 3가지
지금 쓰면 분명히 부딪히는 문제들
Figma 개발자 공식 문서(developers.figma.com)에 이미 “Known Issues”로 등록된 오류들입니다. 베타이기 때문에 발생하는 것들이 대부분이지만, 모르고 쓰다가 막히면 당황스럽습니다.
추가로, 커스텀 폰트가 포함된 컴포넌트를 가져올 때 appendChild가 실패하는 버그도 3월 25일자 Figma 포럼에 등록되어 있습니다. 폰트 의존성이 있는 파일에서 작업할 때는 주의가 필요합니다. (출처: Figma 커뮤니티 포럼, 2026.03.25)
Q&A — 실제로 가장 많이 묻는 것들
마치며
Figma AI 에이전트(use_figma)는 분명히 실용적인 방향입니다. AI가 시각적으로 그럴싸한 결과물이 아니라 팀의 실제 디자인 시스템 구조에 맞게 작동하는 디자인을 만들어준다는 목표 자체가 지금까지 나온 AI 디자인 도구들과 다릅니다.
다만 솔직히 말하면, 지금 당장 모든 팀에 도입하기엔 이릅니다. 디자인 시스템이 잘 정비된 팀, 유료 Full 시트를 쓰는 팀, MCP 클라이언트(Claude Code, Cursor 등)에 익숙한 팀이라면 베타 기간 중 실험해볼 가치가 충분합니다. 반대로 디자인 시스템 자체가 없거나 느슨한 팀이라면 에이전트 도입 전에 시스템 정비가 먼저입니다. 에이전트는 좋은 재료를 더 빠르게 조립해줄 뿐, 재료가 없으면 아무것도 못 합니다.
Skills 생태계가 얼마나 빠르게 성장하느냐가 이 기능의 실질적인 가치를 결정할 것입니다. 출시 당일 이미 9개의 커뮤니티 Skills가 나왔다는 점은 좋은 신호입니다.
본 포스팅 참고 자료
- Figma 공식 블로그 — Agents, Meet the Figma Canvas https://www.figma.com/blog/the-figma-canvas-is-now-open-to-agents/
- Figma 헬프센터 — MCP 서버 가이드 https://help.figma.com/hc/en-us/articles/39216419318551
- Figma 개발자 문서 — Known Issues with MCP Clients https://developers.figma.com/docs/figma-mcp-server/mcp-clients-issues/
- Bitovi — 실사용 테스트 보고서 (2026.03.24) https://www.bitovi.com/blog/figma-just-opened-the-canvas-to-agents.-heres-what-actually-happens
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Figma MCP 서버는 베타 서비스로, 기능과 요금 정책이 예고 없이 변경될 수 있습니다. 본 포스팅은 2026년 3월 30일 기준으로 작성되었으며, 이후 Figma의 공식 발표를 직접 확인하시기 바랍니다.
댓글 남기기