2.1.1 서버 설정 개요

서버 설정 개요

원격 서버와 데스크톱 서버의 차이를 이해하고 자신의 환경에 맞는 방식을 선택하는 방법을 설명한다. 업데이트: 2026-03-10

---

핵심 요약

구분	내용
📖 두 가지 방식	원격 서버(mcp.figma.com) vs 데스크톱 서버(127.0.0.1:3845)
💡 권장 선택	빠른 시작 → 원격 서버 / 로컬 디자인 집중 → 데스크톱 서버
🎯 공통 전제	Figma 계정 로그인 + MCP 지원 AI 에디터 설치
⚠️ 주의	데스크톱 서버는 Figma 앱이 켜져 있을 때만 동작한다

---

목차

1. 두 서버 방식 비교
2. 전송 프로토콜 선택
3. 설정 방식 선택 기준

---

1. 두 서버 방식 비교

항목	원격 서버	데스크톱 서버
엔드포인트	https://mcp.figma.com/mcp	http://127.0.0.1:3845/mcp
플랜 요건	모든 플랜	유료 Dev/Full 시트
Figma 앱	불필요	실행 중이어야 함
인증 방식	OAuth (브라우저 로그인)	자동 (앱 세션 공유)
추가 도구	generate_figma_design, whoami	없음
사용 제한	일일 호출 한도	동일

원격 서버 흐름

flowchart TD
    A[AI 에디터] --> B[mcp.figma.com/mcp]
    B --> C[Figma 클라우드 API]
    C --> D[Figma 파일]

데스크톱 서버 흐름

flowchart TD
    A[AI 에디터] --> B[127.0.0.1:3845/mcp]
    B --> C[Figma 데스크톱 앱]
    C --> D[Figma 파일\n현재 선택 영역 포함]

---

2. 전송 프로토콜 선택

MCP는 두 가지 전송 방식을 지원한다. 에디터에 따라 지원 여부가 다르다.

프로토콜	설명	지원 에디터
Streamable HTTP	HTTP 요청 기반. 최신 표준	Claude Code, VS Code, Cursor 등 대부분
SSE (Server-Sent Events)	스트리밍 이벤트 기반. 구형	일부 구형 Cursor 버전

에디터가 Streamable HTTP를 지원하면 "type": "http" 설정을 사용한다. 연결이 안 될 경우 SSE 방식("type": "sse")으로 전환해 본다.

---

3. 설정 방식 선택 기준

flowchart TD
    A{유료 Dev/Full 시트?} --> |아니오| B[원격 서버만 사용 가능]
    A --> |예| C{로컬에서 현재\n선택 영역 참조 필요?}
    C --> |예| D[데스크톱 서버 권장]
    C --> |아니오| E{generate_figma_design\n도구 필요?}
    E --> |예| F[원격 서버 필수]
    E --> |아니오| G[둘 다 가능\n원격 서버 권장]

---

문서 탐색

이전	다음
1.2 환경 및 요금	2.1.2 클라이언트별 설치 가이드

---

참고 자료

출처	URL	신뢰도
원격 서버 설치 공식 문서	https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/	★★★★★
데스크톱 서버 설치 공식 문서	https://developers.figma.com/docs/figma-mcp-server/desktop-server-installation/	★★★★★
Figma MCP GitHub 가이드	https://github.com/figma/mcp-server-guide	★★★★★