Figma MCP 설정 방법: Remote와 Desktop 연결 경로

김희준

2026년 11월 06일 업데이트

Figma MCP와 함께 팀 UI를 마무리해야 한다면 Pixso UI 디자인 메이커도 검토하고, Figma 설정과 별도로 현재 플랜과 권한을 확인하세요. Figma MCP는 AI 클라이언트가 Figma 디자인의 문맥을 읽고 작업하도록 연결합니다. 실제로 읽거나 바꿀 수 있는 범위는 클라이언트, 파일 권한, 워크스페이스 설정에 따라 달라집니다. 먼저 사용할 파일을 열 수 있는 계정과 연결하세요.

빠른 답변: 클라이언트가 지원한다면 Figma의 Remote MCP 경로부터 시작하세요. Desktop MCP는 공식 안내나 조직 정책에서 요구할 때만 사용합니다. 확인되지 않은 서드파티 설정에 토큰을 붙여 넣지 마세요.

1. Remote MCP: 권장되는 시작 경로

Figma의 공식 MCP Server 문서에서 사용하는 클라이언트가 지원 목록에 있는지 확인합니다.
대상 파일을 열 수 있는 Figma 계정으로 로그인합니다. 링크를 안다고 편집 권한이 생기지는 않습니다.
MCP 클라이언트에서 Add 또는 Connect 흐름을 실행하고 Figma 인증 화면을 완료합니다. 승인 전에 요청되는 권한 범위를 검토합니다.
먼저 선택한 프레임을 요약하고 컴포넌트를 나열하는 읽기 전용 요청을 보냅니다. 변경 전에 파일 이름, 페이지와 선택 영역이 맞는지 확인합니다.
편집할 때는 작고 되돌릴 수 있는 변경 하나를 요청한 뒤 Figma에서 결과를 검토합니다. 쓰기마다 명시적 승인이 필요한 클라이언트도 있습니다.

2. Desktop MCP: 필요한 경우에만 사용

일부 팀은 데스크톱 클라이언트나 조직 전용 커넥터를 사용합니다. 오래된 블로그의 설정을 복사하지 말고 해당 클라이언트의 최신 안내를 따르세요. 로컬 런타임, 승인된 클라이언트, 액세스 토큰이 필요할 수 있으며 필드와 토큰 수명은 클라이언트마다 다릅니다. 비밀값은 클라이언트의 시크릿 저장소나 환경 변수에 두고 공개 저장소와 스크린샷에는 남기지 않습니다.

3. MCP와 API는 다릅니다

API: 프로그램이 정해진 요청과 응답을 가진 문서화된 엔드포인트를 호출합니다.
MCP: MCP 호스트가 AI 클라이언트에 도구와 문맥을 노출합니다. 모델도 연결된 서비스의 권한과 승인 규칙 안에서만 동작합니다.

MCP가 모든 페이지, 컴포넌트, 팀 라이브러리에 자동 접근을 부여하지는 않습니다. 권한 오류는 보통 두 번째 시크릿을 추가하는 것이 아니라 Figma 파일과 팀의 접근 설정을 고쳐야 해결됩니다.

4. 안전한 디자인 투 코드 워크플로

쓰기 테스트 전 작업 파일을 복제하거나 브랜치합니다.
변경 전에 클라이언트가 파일, 페이지, 프레임을 식별하도록 요청합니다.
“버튼 모서리를 8px로 바꾸고 라벨은 유지”처럼 승인 기준이 분명한 작은 변경을 요청합니다.
Figma에서 레이아웃, 타이포그래피, 변수, 컴포넌트와 프로토타입 링크를 검토합니다.
다른 팀원이 재현할 수 있도록 클라이언트 버전, 날짜, 파일 권한과 결과를 기록합니다.

5. 문제 해결

Figma 도구가 목록에 보이지 않음

클라이언트 지원 여부를 확인하고 업데이트한 뒤 다시 로그인합니다. 현재 워크스페이스에서 MCP 연결이 켜져 있는지도 확인하세요.

읽기는 되지만 편집이 실패함

파일 편집 권한과 클라이언트의 쓰기 승인을 확인하세요. 읽기 전용 연결이 쓸 수 있다고 추정하지 마세요.

요청이 너무 큼

선택 영역을 줄이고 한 번에 한 페이지나 프레임만 요청합니다. 큰 파일은 클라이언트의 문맥이나 요청 한도를 넘을 수 있습니다.

시크릿이 노출됨

발급 서비스에서 즉시 폐기하고 로그에서 제거한 뒤 교체하고 다시 연결합니다.

6. Pixso는 어디에 맞는가

Pixso는 별도의 협업 UI 디자인 워크스페이스입니다. AI 실험 뒤 UI, 프로토타입 또는 개발자 핸드오프를 완성해야 한다면 Pixso 워크스페이스에서 현재 플랜과 권한을 계정 기준으로 확인하세요. Pixso MCP나 AI 커넥터가 있다면 Figma 설정이 그대로 이전된다고 가정하지 말고 해당 기능의 최신 문서와 승인 범위를 별도로 검토합니다.