AI 어시스턴트 (MCP)

Layerz Canvas 는 Claude Code, Claude Desktop, Cursor 처럼 MCP(Model Context Protocol) 를 쓰는 AI 어시스턴트로 조작할 수 있습니다. 원하는 것을 말로 설명하면("로고, 기능 카드 세 장, 마지막에 색종이가 들어간 15초 출시 티저") 어시스턴트가 열린 문서에 직접 만듭니다 — 진짜 레이어·그룹·키프레임이라 이어서 손으로 고칠 수 있습니다. 직접 만든 것을 고쳐 달라고 할 수도 있습니다("제목이 한 글자씩 튀어나오게", "MP4 와 HTML 로 내보내 줘").

켜기

1. Layerz Canvas ▸ 설정… ▸ MCP 에서 MCP 서버 실행 을 켭니다. 상태에 주소 http://127.0.0.1:4747/mcp 가 보입니다.
2. 클라이언트 연결 에서 쓰는 앱을 고르고 세 단계를 따라 합니다. 지금 포트·토큰에 맞는 명령이나 설정이 복사 버튼과 함께 나옵니다.
   • Claude Code — 터미널에서 claude mcp add … 명령을 한 번 실행한 뒤 claude 를 열고, 예를 들어 "열려 있는 Layerz Canvas 문서를 보여 줘" 라고 요청합니다.
   • Claude Desktop — Claude 설정 파일(Claude ▸ Settings ▸ Developer ▸ Edit Config)에 설정을 붙여 넣고 Claude 를 다시 엽니다. Node.js 가 필요합니다(연결 브리지가 npx 로 실행됨).
   • Cursor — ~/.cursor/mcp.json 에 설정을 넣고 Cursor ▸ Settings ▸ MCP 에서 "layerz-canvas" 가 초록색인지 확인합니다.
   • curl — 스크립트용: HTTP POST 로 보내는 JSON-RPC.
3. 연결 테스트 로 전체 경로를 확인하고 쓸 수 있는 도구 수를 봅니다.

어시스턴트가 작업하는 동안 Layerz Canvas 를 열어 두세요. 서버는 기본으로 꺼져 있고, 켜 두면 앱을 실행할 때 함께 시작됩니다.

어시스턴트가 할 수 있는 일

전체 도구는 어시스턴트에게 물어보면 알려 줍니다("Layerz Canvas 에서 뭘 할 수 있어?"). 요약하면:

• 읽기 — 열린 문서·아트보드·레이어·현재 선택. 결과를 이미지로, 움직임은 여러 시점을 한 장에 모은 격자로 직접 보고 확인합니다.
• 디자인 — 도형·텍스트·프레임·그룹 추가와 수정, 펜으로 그리기(점과 곡선, 또는 SVG 패스 데이터), 그라디언트, 점선·획 스타일, 불리언, 크롭 마스크·마스크 레이어·트랙 매트, 트림 패스, 블렌드 모드, 이펙트(그림자·블러·글로우·그레인·색), 픽셀 아트, 문서에 넣는 폰트, 그림·동영상·소리, Layerz 브랜드(마크·아이콘·워드마크·락업)와 기기·맥 창·브라우저 창 프레임.
• 애니메이션 — 키프레임 한꺼번에(그라디언트 채움·점선 오프셋·트림도; 시각은 타임라인 기준 또는 레이어 시작 기준), 레이어의 애니메이션 통째로 옮기기, 시차를 둔 등장·퇴장 프리셋, 키네틱 타이포, 반복·흔들림, 스프링, 카운터, 그룹 시계, 카메라 이동, 진행 방향으로 도는 모션 패스, 장면 전환, 모핑, 2.5D 회전, 비트 마커, 미리 만든 조각(차트·코드 블록·가상 커서·기기 프레임·파티클). 창 안의 타임라인을 재생·일시정지·이동시킬 수도 있습니다.
• 가져오기·내보내기 — Lottie·SVG 가져오기, PNG·JPEG·PDF·SVG·동영상·GIF·Lottie·HTML 내보내기(무료/Pro 규칙은 앱과 같음).
• 실행 취소 — 한 번의 요청에서 한 여러 변경은 실행 취소 한 번으로 되돌립니다.

AI 가 하는 일 보기

• 어시스턴트가 작업하는 동안 창 툴바에 ✦ 아이콘이 보입니다(편집 중에는 보라색). 누르면 어느 클라이언트가 작업 중인지 보여 줍니다.
• 어시스턴트가 추가하거나 바꾼 레이어는 캔버스와 레이어 목록에서 잠깐 보라색으로 강조됩니다(캔버스에서 변경 사항 강조 로 끔).
• 키프레임을 추가하거나 옮기면 재생 헤드가 그 시각으로 이동하고(작업 중인 아트보드가 활성화됨), 0초의 문서가 아니라 지금 키를 찍는 자세가 강조되어 보입니다. 재생 중에는 움직이지 않고, 강조를 끄면 함께 꺼집니다.
• AI 의 편집은 모두 실행 취소할 수 있고, 편집 메뉴에 실행 취소 AI: … 로 표시됩니다.

개인정보와 안전

• 서버는 127.0.0.1 에서만 받으므로 이 Mac 밖에서는 접근할 수 없고, 웹 페이지가 보내는 요청은 거부합니다. 문서 내용은 어시스턴트에게 읽으라고 할 때만 전달되며, 그 뒤의 처리는 사용하는 어시스턴트에 따릅니다.
• 이 Mac 을 다른 사람도 쓴다면 접근 토큰(생성)을 설정하세요. 클라이언트가 그 토큰을 보내야 연결됩니다. 포트와 토큰은 서버가 꺼져 있을 때 바꿀 수 있습니다.
• 앱은 샌드박스 안에서 동작합니다. 어시스턴트가 경로로 파일을 지정하면(추가할 그림, 열 문서, 내보낼 위치) 설정 ▸ 내보내기 에서 고른 폴더 안에서만 접근할 수 있고, 상대 경로도 그 폴더 기준입니다. 그 밖의 파일은 어시스턴트가 내용이나 URL 로 보내면 됩니다.