Skip to content
Skills Library
Design & UX · Tool integration

figma-mcp-setup

/figma-mcp-setup

Connects to Figma for design reading: prefers the local Figma desktop Dev Mode MCP server (http://127.0.0.1:3845/mcp), falls back to raw HTTP calls when the client has not registered it, and only then to the remote Figma MCP. Use when Figma MCP tools are missing or failing, on "connection refused 3845", rate limits, or when setting up Figma MCP for the first time.

Licence
MIT
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
8
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Connects to Figma for design reading: prefers the local Figma desktop Dev Mode MCP server (http://127.0.0.1:3845/mcp), falls back to raw HTTP calls when the client has not registered it, and only then to the remote Figma MCP. Use when Figma MCP tools are missing or failing, on "connection refused 3845", rate limits, or when setting up Figma MCP for the first time.

Triggers from the description

connection refused 3845
Original author description

Connects to Figma for design reading: prefers the local Figma desktop Dev Mode MCP server (http://127.0.0.1:3845/mcp), falls back to raw HTTP calls when the client has not registered it, and only then to the remote Figma MCP. Use when Figma MCP tools are missing or failing, on "connection refused 3845", rate limits, or when setting up Figma MCP for the first time.

How it works

  1. 우선순위
  2. 등록
  3. 읽기 순서
  4. HTTP 직접 호출
  5. 주의
  6. 문제 해결
Original SKILL.md headings · 73 lines, 328 words
SKILL.md preview
---
name: figma-mcp-setup
description: >-
  Connects to Figma for design reading: prefers the local Figma desktop Dev Mode MCP
  server (http://127.0.0.1:3845/mcp), falls back to raw HTTP calls when the client has
  not registered it, and only then to the remote Figma MCP. Use when Figma MCP tools
  are missing or failing, on "connection refused 3845", rate limits, or when setting
  up Figma MCP for the first time.
---

# Figma MCP 연결

## 우선순위

| 순위 | 서버 | 쓰는 경우 |
|---|---|---|
| 1 | **로컬 Dev Mode MCP** `http://127.0.0.1:3845/mcp` (Figma 데스크톱 앱) | 읽기·QA 기본 경로. 한도 걱정이 적고 빠르다 |
| 2 | 같은 서버를 **HTTP로 직접 호출** | 클라이언트에 등록이 안 돼 있을 때. 원격으로 바로 넘어가지 않는다 |
| 3 | 원격 Figma MCP | 로컬을 띄울 수 없을 때만. 좌석에 따라 rate limit이 잦다 |

## 등록

Figma 데스크톱 → Dev Mode → MCP 서버 활성화 후:

```bash
claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp
```

Cursor는 `~/.cursor/mcp.json`:

```json
{ "mcpServers": { "Figma": { "url": "http://127.0.0.1:3845/mcp" } } }
```

## 읽기 순서

URL `...?node-id=12-345` → `nodeId` `12:345`.

1. `get_design_context` — 레이아웃·참고 코드 (`clientLanguages`, `clientFrameworks` 를 넘길 수 있다)
2. `get_screenshot` — 시각 기준
3. `get_metadata` — 프레임 크기·자식 구조
4. `get_variable_defs` — 변수 이름 ↔ 값

## HTTP 직접 호출

```bash
# 1) initialize → 세션 ID
curl -sS -D /tmp/figma_hdr.txt -X POST http://127.0.0.1:3845/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"agent","version":"1.0"}}}'
SID=$(awk -F': ' 'tolower($1)=="mcp-session-id"{print $2}' /tmp/figma_hdr.txt | tr -d '\r')

# 2) initialized 알림
curl -sS -X POST http://127.0.0.1:3845/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}' >/dev/null

# 3) 도구 호출
curl -sS -X POST http://127.0.0.1:3845/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_design_context","arguments":{"nodeId":"12:345","clientLanguages":"typescript","clientFrameworks":"react"}}}'
```

응답은 SSE다. `data: {...}` 줄을 파싱해 `result.content` 의 text·image를 쓴다. 같은 턴에서는 세션을 재사용한다.

## 주의

- `http://localhost:3845/assets/...` 는 세션 임시 URL. 코드·mock에 남기지 않는다.
- 스크린샷 base64는 크다. 파일로 저장한 뒤 이미지로 읽는다.

## 문제 해결

| 증상 | 조치 |
|---|---|
| `connection refused :3845` | Figma 데스크톱 앱에서 해당 파일을 열고 Dev Mode MCP를 켠다 |
| 클라이언트에 Figma 도구가 없음 | 위 HTTP 호출로 진행 |
| 원격 MCP rate limit | 로컬로 다시 시도 |
| 노드를 못 찾음 | 데스크톱 앱에 **그 파일**이 열려 있는지 확인 |

Versions

The database has no other skills named figma-mcp-setup.

Database snapshot: 13.11.2026 · package version 92ad01e5b11a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 91figma-mcp
    Use when reading a Figma file into code, or when the Figma MCP is missing.
  • 100mcp-server-figma
    Use this skill when installing, configuring, and executing tools with the Figma design file inspection, vector frames, and tokens Figma MCP server.
  • 100figma-design-tool-workflows
    Figma mastery and design-to-code: Auto Layout, component architecture, variable modes, Dev Mode handoff, Figma MCP server integration, Code Connect, and token pipelines. Use when working in Figma, converting designs to code, or setting up a design-to-code flywheel.
  • 100figma-connect
    Figma-to-code bridge combining Figma MCP server tools with the Code Connect CLI for end-to-end design implementation workflows. Use this skill when implementing UI components from Figma design URLs, publishing Code Connect mappings to Figma Dev Mode, extracting design tokens…
  • 100extract-figma-assets
    Use when the user wants to extract images, assets, or design context from a Figma selection — e.g. "extract images from my current Figma selection", "pull the assets out of this Figma frame", "download the images from this Figma design", "grab the design context for this node".…
  • 100figma
    Use when working with Figma as the design source for a design system — including Variables, Dev Mode, Code Connect, the REST API, and MCP-based design-to-code workflows. USE FOR: Figma Variables, Figma Dev Mode, Code Connect, Figma REST API, Tokens Studio plugin, Figma MCP…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.