설정 실전 예시

실제 프로젝트에서 자주 쓰이는 설정 패턴과 연결 문제 해결 방법을 정리한다. 업데이트: 2026-03-10

핵심 요약

구분	내용
📖 권장 설정	원격 서버 + Claude Code 조합이 기능이 가장 많다
💡 팀 공유	프로젝트 루트 `.mcp.json`을 git에 포함하면 팀 전체가 동일 설정 사용 가능
🎯 연결 확인	Claude Code: `/mcp` 명령 / Cursor: 하단 상태바
⚠️ 주의	Access Token을 `.mcp.json`에 하드코딩하지 않는다 — 환경 변수 사용

1. Claude Code — 원격 서버 (권장)

~/.claude/mcp.json (전역 설정):

{
  "mcpServers": {
    "figma": {
      "type": "http",
      "url": "https://mcp.figma.com/mcp"
    }
  }
}

연결 확인:

# Claude Code 터미널에서
/mcp
# 출력: figma: connected (13 tools available)

사용 가능한 전체 도구 목록 확인:

사용 가능한 Figma MCP 도구를 모두 나열해줘

2. Cursor — SSE 방식 (구버전 호환)

Cursor 0.43 이하 구버전은 Streamable HTTP를 지원하지 않는다.

~/.cursor/mcp.json:

{
  "mcpServers": {
    "figma": {
      "type": "sse",
      "url": "https://mcp.figma.com/sse"
    }
  }
}

Cursor를 최신 버전으로 업데이트하면 "type": "http" 로 변경하는 것을 권장한다.

3. VS Code — 프로젝트별 설정

프로젝트 루트에 .vscode/mcp.json 생성 (팀 공유 가능):

{
  "servers": {
    "figma": {
      "url": "https://mcp.figma.com/mcp",
      "type": "http"
    }
  }
}

.gitignore에 추가하지 않으면 팀원 전체가 동일한 MCP 설정을 공유한다. Access Token은 포함되지 않으므로 git에 포함해도 안전하다.

4. 원격 + 데스크톱 병행 설정

두 서버를 동시에 등록해 상황에 따라 사용하는 방식:

{
  "mcpServers": {
    "figma": {
      "type": "http",
      "url": "https://mcp.figma.com/mcp"
    },
    "figma-desktop": {
      "type": "http",
      "url": "http://127.0.0.1:3845/mcp"
    }
  }
}

용도	권장 서버
링크 기반 디자인 → 코드 생성	`figma` (원격)
Figma 앱에서 현재 선택 영역 참조	`figma-desktop`
`generate_figma_design` 사용	`figma` (원격)

5. 연결 문제 해결

증상	원인	해결 방법
`figma: disconnected`	인증 만료	브라우저에서 Figma 재로그인 후 `/mcp` 재시도
`429 Too Many Requests`	일일 호출 한도 초과	익일 재시도 또는 플랜 업그레이드
데스크톱 서버 연결 안 됨	Figma 앱 미실행 또는 MCP 비활성화	Figma 앱 실행 → Dev Mode → MCP 서버 활성화
SSE 방식 연결 실패	Cursor 버전 문제	Cursor 업데이트 후 `type: http`로 변경
특정 파일 접근 불가	파일 권한 없음	Figma에서 해당 파일 권한 확인
`whoami` 도구 없음	데스크톱 서버 사용 중	원격 서버로 전환 (원격 서버 전용 도구)

문서 탐색

이전	다음
2.1.2 클라이언트별 설치 가이드	2.2.1 도구 개요

참고 자료

출처	URL	신뢰도
원격 서버 설치 가이드	https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/	★★★★★
Figma MCP GitHub 가이드	https://github.com/figma/mcp-server-guide	★★★★★
Figma Help Center MCP 가이드	https://help.figma.com/hc/en-us/articles/32132100833559	★★★★★

JW's AI_Stash

Explorer

2.1.3 설정 실전 예시