💻 Cursor + Figma MCP 설치 가이드 (Windows PowerShell 기준)

Figma와 Cursor를 연결하는 MCP 서버를 설치하고 실행하는 방법을 Windows 사용자 기준으로 안내합니다. macOS/Linux와 다른 명령어도 있으니, 본 포스팅에서는 Windows PowerShell 기준으로만 설명드릴게요. (macOS/Linux 사용자는 비교 표를 통해 참고 가능!)

---

1️⃣ Repository 클론하기

먼저 MCP 코드 저장소를 복제합니다. PowerShell을 열고 아래 명령어를 입력하세요.

git clone https://github.com/sonnylazuardi/cursor-talk-to-figma-mcp.git

✅ 참고: macOS/Linux에서도 동일한 명령어를 사용합니다.

---

2️⃣ Bun 설치

Node.js의 대안으로 최근 각광받는 Bun을 설치해야 합니다. Windows에서는 PowerShell 전용 명령어로 설치해야 해요.

iwr https://bun.sh/install.ps1 -useb | iex

⚠️ bash가 없기 때문에 macOS/Linux 명령어(curl ... | bash)는 그대로 쓰면 안 됩니다.

---

3️⃣ 프로젝트 의존성 설치

Bun이 설치되었으면 프로젝트 내부 라이브러리를 설치해봅시다. 다음 명령어를 입력하세요.

bun install

💡 macOS/Linux에서는 bun setup을 사용하기도 하지만, 대부분의 경우 bun install만으로 충분합니다.

---

4️⃣ WebSocket 서버 실행은 생략!

혹시 문서에서 bun socket을 실행하라는 내용을 보셨나요? 현재 MCP 저장소의 package.json에는 "socket"이라는 스크립트가 정의되어 있지 않아서 실행이 되지 않습니다.

❌ 따라서 이 단계는 생략해도 됩니다.

---

5️⃣ MCP 서버 실행

이제 본격적으로 MCP 서버를 실행해볼까요?

bunx cursor-talk-to-figma-mcp

🟢 정상 실행 시 Figma와 WebSocket 연결을 시도합니다.

---

6️⃣ Figma 플러그인 등록 및 실행

이제 MCP가 Figma와 통신할 수 있도록 플러그인을 등록해줘야 해요. 아래 단계를 따라주세요.

1. Figma 실행
2. 메뉴에서 Plugins → Development → Import Plugin from Manifest... 선택
3. 경로 선택: src/cursor_mcp_plugin/manifest.json
4. 등록된 플러그인을 실행

✅ 이 플러그인이 실행되고 있어야 MCP 서버가 정상 작동합니다!

---

✅ 설치 요약 정리표

단계	Windows PowerShell 명령어
코드 클론	git clone ...
Bun 설치	`iwr ...	iex`
의존성 설치	bun install
WebSocket 서버	생략 (스크립트 없음)
MCP 실행	bunx cursor-talk-to-figma-mcp
플러그인 등록	manifest.json 수동 등록

---

🆘 에러가 난다면?

• bunx cursor-talk-to-figma-mcp 실행 시 Socket error: AggregateError 메시지가 반복되면 Figma 플러그인이 실행되고 있는지 꼭 확인해보세요.
• 방화벽 설정이나 포트 충돌 문제로 localhost:3055 접속이 안 되는 경우도 있습니다. 이럴 땐 보안 프로그램이나 방화벽 설정을 점검해보세요.

---

설치 중 막히는 부분이 있다면 댓글로 남겨주세요. 최대한 도움드릴게요 😊
이 가이드를 따라 Cursor와 Figma를 연동해보셨다면, 댓글로 후기도 공유해 주세요!

---