Canva 템플릿 기반 게시물 생성기

*“스포츠에 관한 중국어 단어 5개”*라고 요청하면, 최근에 사용한 단어를 반복하지 않고 템플릿을 그대로 유지한 슬라이드 5개짜리 새 캐러셀이 Canva 계정에 만들어진다.

비용: 0 €. Canva Free + 공식 Canva MCP 서버 + 로컬 서버 하나. 크기 조정도, Enterprise autofill도, 프리미엄 리소스도 필요 없다.

구성 방법

두 MCP 서버가 작업을 나눠 맡는다.

Canva 쪽은 디자인을 알지만 사용자의 템플릿이나 이미 게시한 내용은 전혀 모른다. 그 빈틈을 로컬 서버가 메우고, 이 도구를 신뢰할 수 있게 만드는 로직이 여기 담긴다. 강제 규칙은 모델이 아니라 코드가 확인한다. 문자 수 세기는 LLM이 특히 서투른 대표적인 일이다.

Related MCP server: XHS-MCP

설치

python3 -m venv .venv
./.venv/bin/pip install -r requirements.txt

Claude에서 Canva를 연결한다(설정 → 커넥터 → Canva). 또는 Claude Code에서:

claude mcp add --transport http canva https://mcp.canva.com/mcp

Canva OAuth가 브라우저에서 열린다.앱을 만들거나 API 키를 관리할 필요는 없다.

로컬 서버는 이미 .mcp.json에 선언되어 있으므로 프로젝트를 열면 Claude Code가 자동으로 띄운다. /mcp로 두 서버가 모두 나타나는지 확인한다.

템플릿 설정

각 템플릿은 Canva의 다중 페이지 디자인이어야 한다. 같은 레이아웃으로 여러 페이지를 복제해 둔 디자인(max_caracteres에 입력한 값까지, 예: 12)이다. N개 슬라이드 게시물은 그중 N개 페이지를 복사해서 만들어지므로, 마스터에는 한 번에 요청할 수 있는 최대 슬라이드 수 이상의 페이지가 있어야 한다.

plantillas.json을 편집하거나 어시스턴트에게 anadir_plantilla를 쓰도록 요청한다. 템플릿마다 다음이 필요하다.

• canva_design_id — 마스터 디자인의 URL에 있다: canva.com/design/DAFxxxxxxxx/edit → 해당 DAFxxxxxxxx.

• max_paginas — 마스터에 몇 페이지가 있는지 (= 이 템플릿으로 만든 하나의 post가 가질 수 있는 최대 슬라이드 수).

• huecos — 각 페이지 바꾸려는 각 블록마다 객체 하나씩. texto_actual 필드는 그 블록에 현재 표기된 문구가 문자 그대로 있어야 한다. 그 값으로 편집 시 해당 블록을 찾는다. 텍스트 블록은 "tipo": "texto"이고 max_caracteres가 있으며, 이미지 블록은 "tipo": "imagen"(max_caracteres 없음)으로 CC0/공용 라이선스 사진을 찾아 채우고, 없으면 사용자가 직접 넣도록 요청한다.

• max_caracteres — 문구가 흘러넘Class when the layout breaks. layout이 깨질 때까지 텍스트를 입력해 보고 문자 두 개 정도를 빼서 정한다.

• reglas_estilo — 명령문으로 쓴 콘텐츠 스타일이다. 결과물의 품질에서 가장 뚜렷이 드러나는 부분이므로 다듬을 가치가 있다.

팁 하나: Canva에서 템플릿 이름은 설명적으로 정하자. (PLANTILLA_chino_5palabras_feed) 올바른 것을 고를 때 도움이 된다.

사용법

Claude Code에서, 프로젝트 폴더 안에서:

> hazme un post de 5 palabras en chino sobre deportes

generar-plant 스킬이 자동으로 작동한다. 흐름은: 템플릿과 슬라이드 수 선택 → 슬롯 계약 요청 → 슬라이드별 콘텐츠 생성 → 검증 → N개 페이지를 복제해 Canva에서 편집 → 전체를 하나의 링크로 내보내기 → 게시물 전체를 이력에 기록.

콘텐츠가 검증에 통과하지 못하면, Canva를 손대기 전에 수정하고 다시 검증한다. 그래야 나중에 깨진 디자인으로 끝나는 일을 막아 준다.

반복을 피하는 방법

• 테마 (temas_publicados) — 정확히 그 주제로 이미 post 한 적이 있으면 알려준다 (예: “스포츠”를 통째로 또.

• 단어 (elementos_usados) — 해당 템플릿의 최근 COOLDOWN_POSTS개 게시물 (기본 15, servidor_catalogo.py에서 변경 가능)에서 이미 사용한 단어를 피한다. 영구적인 차단은 아니다. 그 수만큼 게시물을 지나면 단어가 다시 사용 가능해진다. 아무도 기억하지 못할 만큼의 시간이면 충분하다.

이 프로젝트가 하지 않는 것

• Instagram이나 TikTok에 게시하지 않는다. Canva MCP는 이미지나 PDF로 내보내기까지다. 게시는 또 다른 연동(Meta와 TikTok API)이며 구성 시간이 공평하게 필요하다.

• AI 이미지를 만들지 않는다. 이미지 슬롯에는 CC0/공용 도메인 라이선수(Openverse)의 기존 사진을 찾고, 없으면 직접 추가하도록 요청한다.

• 포맷 사이에 크기를 조절하지 않는다. Canva Pro가 필요하다. 포맷별로 템플릿 하나식을 둔다: 피드 하나와 세로형 하나를 각각 카탈로그에 등록한다.

• 혼자 돌지 않는다. MCP는 사용자가 대화를 열 때만 응답한다. 새벽에 자동으로 게시물을 만드는 일정 같은 것은 없다.

• 검토를 대체하지 않는다. 텍스트를 바꾸면 줄바꿈이 어긋날 수 있고, 자동 검색된 이미지가 완벽히 맞지 않을 수도 있다. 게시 전에 디자인을 열어 확인한다.

로컬 서버가 제대로 작동하는지 확인하기

./.venv/bin/python -c "
import servidor_catalogo as s
print(s.listar_plantillas())
print(s.preparar_encargo('texto-3', 'animales', 4))
print(s.elementos_usados('texto-3'))
"

템플릿 목록을 표시하고, texto-3에 대한 4슬라이드 요청의 계약을 반환해야 한다.