글
피그마 MCP 대용량 파일 'Payload Too Large' 에러 대처법
피그마 연동 중 Payload Too Large 에러로 멈추셨나요? 대용량 피그마 파일을 MCP 서버로 불러올 때 발생하는 용량 초과 문제의 원인과, 특정 노드(Node)만 쪼개서 스마트하게 호출하는 분할 로드 방법을 자세히 알아봅니다. 요즘 LLM에 피그마(Figma)를 연동해서 UI 코드를 짜거나 화면을 분석하는 작업, 많이들 하시죠? 저도 최근에 신나서 MCP(Model Context Protocol) 서버를 세팅하고 회사 메인 프로젝트 링크를 딱 넣었는데, 갑자기 붉은 글씨로 Payload Too Large (HTTP 413) 에러가 뜨면서 서버가 뻗어버리더라고요. 진짜 당황스러웠어요. 😅 알고 보니 피그마 파일의 덩치가 너무 커서 발생한 문제였습니다. 디자인 원본 파일에는 우리가 눈으로 보는 화면뿐만 아니라 수많은 숨겨진 레이어, 벡터 데이터, 히스토리까지 엄청난 양의 JSON 데이터가 들어있거든요. 이걸 한 번에 AI의 컨텍스트 윈도우로 욱여넣으려니 시스템이 "이건 너무 무거워서 못 받아!" 하고 뱉어낸 거죠. 오늘은 이렇게 무거운 대용량 피그마 파일을 다룰 때, 에러 없이 필요한 정보만 쏙쏙 빼오는 '노드 분할 호출' 방법에 대해 제 경험을 바탕으로 이야기해 볼게요. Payload Too Large, 왜 터지는 걸까요? 🤔 피그마 API는 기본적으로 파일 링크를 받으면 해당 파일에 있는 모든 페이지와 프레임의 노드(Node) 트리 를 한꺼번에 스캔해서 반환하려고 시도합니다. 작은 프로토타입 파일이라면 문제없겠지만, 수십 개의 페이지와 컴포넌트 라이브러리가 얽힌 실무용 파일은 JSON 텍스트 용량만 수십 메가바이트(MB)를 훌쩍 넘어가곤 해요. MCP 서버와 통신하는 과정에서 이 방대한 JSON 페이로드가 서버의 최대 허용 요청 크기를 초과 하거...