피그마 연결

Windows에서 Talk to Figma MCP(로컬, 무료)로 Claude Code / Codex와 피그마 데스크톱 앱을 붙이는 설치기·관리 앱입니다. 터미널을 몰라도 더블클릭으로 씁니다.

설치

1. 설치.cmd 를 더블클릭합니다. 관리자 권한은 필요 없습니다.

2. 바탕화면 또는 시작 메뉴의 피그마 연결 을 엽니다.

3. 피그마에서 디자인 파일을 하나 열어 둡니다.

4. 연결 을 누릅니다. 여기서 끝입니다.

피그마를 시킬 AI 가 이 PC 에 하나는 있어야 합니다. 없으면 AI 도구 설치 를 누르세요. winget 으로 먼저 시도하고, 안 되면 공식 설치 스크립트로 물러섭니다. 관리자 권한은 필요 없습니다.

로그인은 대신 해 드릴 수 없습니다. 설치가 끝나면 같은 창의 로그인 버튼이 터미널을 열어 주고, 거기서 각자 계정으로 로그인하시면 됩니다. 이 터미널만은 일부러 보이게 띄웁니다.

연결 버튼 하나가 이만큼을 합니다.

• Bun · Talk to Figma MCP 고정 버전 준비

• 중계 서버(127.0.0.1:3055) 실행

• Claude Code / Claude Desktop / Codex 에 MCP 항목 등록

• 피그마 앱 실행 → 창을 앞으로 꺼내 퀵 액션(Ctrl+/)으로 플러그인 실행

• 플러그인이 아직 없으면 설치 페이지를 피그마 앱 안에서 열어 줌

플러그인이 붙었는지는 GUI 의 피그마 플러그인 줄이 직접 알려 줍니다. 로그를 읽어 짐작하지 않고 중계 서버에 물어봅니다.

플러그인: https://www.figma.com/community/plugin/1485687494525374295/talk-to-figma-mcp-plugin

채널 이름은 신경 쓰지 않아도 됩니다

플러그인은 열 때마다 임의의 채널 이름을 만듭니다. 원래는 그 이름을 읽어서 AI에게 불러 줘야 했습니다. 이 앱의 중계 서버(lib/relay.js)는 채널이 달라도 플러그인과 AI 를 서로 이어 줍니다. AI 에게는 그냥 "피그마 보여?" 라고 물으면 됩니다.

창이 뜨지 않습니다

바로가기는 wscript.exe App.vbs 로 GUI 만 띄웁니다. 중계 서버와 설치 작업도 콘솔 창 없이 돌아갑니다. 터미널에서 직접 쓰고 싶으면 App.cmd -Action status 처럼 CLI 를 쓰면 됩니다.

관리

• 연결 / 연결 해제 / 새로고침 / 점검

• 점검이 결정론적으로 못 고치면 AI에게 점검 맡기기 (로컬 Claude Code 또는 Codex)

제거: Uninstall.cmd

런타임과 로그는 %LOCALAPPDATA%\FigmaBridge 에 둡니다. 이 레포는 설치 원본입니다.