Paper MCP를 Claude에 연결하는 가이드

Paper(paper.design)의 MCP 서버를 Claude Desktop 및 Claude Code에 연결하여, AI 에이전트가 Paper 디자인 파일을 읽고 편집할 수 있도록 설정하는 방법을 정리한 문서입니다.

공식 문서: https://paper.design/docs/mcp

Paper MCP란?

Paper는 웹 기술 기반의 디자인 툴이고, Paper MCP 서버는 AI 에이전트가 Paper 디자인 파일을 컨텍스트로 읽고 직접 수정할 수 있게 해주는 인증된 API입니다.

주요 활용 사례는 다음과 같습니다.

• Cursor, Claude Code 같은 코딩 에이전트가 Paper 디자인을 컨텍스트로 활용하여 코드 생성
• Figma의 디자인 토큰(컬러, 텍스트 스타일)을 Paper로 동기화
• Notion 같은 외부 데이터 소스의 실제 콘텐츠를 디자인에 반영
• Paper 디자인을 React + Tailwind 같은 실제 웹사이트 코드로 변환

Paper가 웹 DOM 기반이라 LLM이 구조를 이해하기 쉬워, 결과물 품질이 높은 편입니다.

사전 준비

1. Paper Desktop 앱 설치 — MCP 서버는 Paper Desktop이 실행될 때 백그라운드에서 자동으로 시작됩니다. 웹 버전으로는 MCP를 사용할 수 없습니다.
2. Paper 파일 열기 — 앱에서 파일을 열면 MCP 서버가 활성화됩니다.
3. 로컬 포트 확인 — Paper MCP는 기본적으로 http://127.0.0.1:29979/mcp 에서 동작합니다.

Claude Desktop에 연결하기

1. Claude Desktop 앱을 엽니다.
2. Settings → Developer → Edit Config 로 이동합니다.
3. 열린 설정 파일(claude_desktop_config.json)을 텍스트 에디터로 편집합니다.
4. mcpServers 항목에 아래 설정을 추가합니다.