SourceCanvas AI Skills

1. AI 앱에 설치

1. ZIP을 풀고 SKILL.md를 읽은 후 이름이 지정된 폴더 전체를 아래 위치 중 하나에 넣으세요. 파일 하나만 옮기지 마세요.
2. 같은 이름의 Skill은 먼저 백업하세요. 개인용 또는 프로젝트용 중 한 범위만 선택하세요.
3. 새 AI 세션에서 Skill 목록을 확인하고 필요하면 앱을 재시작하세요. 다른 Agent Skills 지원 앱은 해당 문서를 따르세요. MCP 지원이 Skill 지원을 의미하지는 않습니다.

Claude Code 경로는 Claude Desktop용이 아닙니다. Skill 미지원 앱에서는 SKILL.md 절차를 수동 프롬프트로 사용할 수 있습니다. Skill 설치만으로 MCP가 설정되지는 않습니다.

2. 실시간 미리보기 연결

1. Mac의 SourceCanvas 설정에서 MCP 및 AI 앱을 열고 AI 앱 연결을 활성화한 뒤 사용할 앱을 연결하세요.
2. macOS 로그인 항목 승인 요청을 따르고 SourceCanvas에서 연결을 확인하세요. AI 앱에서 MCP를 다시 연결하고 list_formats, render_diagram 도구를 확인하세요.
3. 파일 입출력 시 필요한 폴더만 허용하고 AI 작업 공간 범위에도 포함하세요. 표준 도우미 경로는 아래와 같습니다. 다른 설치 위치는 앱 내 설정을 사용하세요.

/Applications/SourceCanvas.app/Contents/Helpers/sourcecanvas-mcp
serve --stdio

MCP는 Mac 로컬 stdio 서비스이며 원격 URL이 아닙니다. iPhone, iPad, Apple Vision Pro에서 생성한 소스를 열 수 있지만 Mac 미리보기 창이 자동 전송되지는 않습니다.

3. 요청해 보기

다이어그램 제작

$sourcecanvas-diagrams 실패, 재시도, 취소를 포함한 결제 흐름을 한국어로 그리고 Mermaid 소스를 출력해 주세요. 미확인 규칙은 가정으로 표시하세요.

미리보기 열기

$sourcecanvas-live-preview 방금 만든 그림을 SC에서 보여 주고 변경할 때 같은 창을 업데이트해 주세요.

작업 진행 시각화

$sourcecanvas-live-preview 로그인 문제를 조사하고 SC에 조사 흐름을 표시해 주세요. 원인 확인, 수정 완료, 테스트 결과 시 같은 그림을 업데이트하세요. 처음만 창을 열고 이후에는 백그라운드로 갱신하며 실제 완료된 단계만 완료로 표시하세요.

Codex는 $, Claude Code는 /로 호출합니다. 요청에 Skill 이름을 적어도 됩니다. 제작 패키지에는 편집 가능한 예제 5개, 미리보기 패키지에는 두 번 갱신하는 API 예제가 있습니다.

4. 업데이트, 내보내기, 개인정보

preview_id는 유지하고 revision을 늘립니다. 중요한 변화만 반영하며 AI 세션이 끝나면 자동 모니터링도 이어지지 않습니다.

렌더링 성공만으로 창이 보인다고 판단하지 마세요. 진단과 표시 결과를 확인하고 실제 UI를 확인하세요. 수동 편집 초안을 보존하고 충돌 시 사용자에게 물어봅니다.

내보내기 형식과 허용된 저장 위치를 지정하세요. 기본적으로 기존 파일을 덮어쓰지 않습니다. PlantUML은 외부 참조 없는 단일 파일을 사용합니다.

로컬 렌더링이어도 AI 앱의 데이터 정책은 적용됩니다. 비밀 정보는 넣지 마세요. 구매나 재검증은 SourceCanvas Pro에서 처리하며 Skill이 대신 구매하지 않습니다.

문제 해결

Skill 없음: 폴더 계층과 경로를 확인한 뒤 새 세션을 여세요. MCP 도구 없음: 로컬 연결 설정을 확인하고 다시 연결하세요.

시간 초과 또는 창 없음: SourceCanvas에서 연결을 확인한 뒤 다시 표시를 요청하세요. 도우미 프로세스를 반복해서 수동 실행하지 마세요.

간트 표시 문제: 날짜와 의존 관계를 확인하고 공식 Mermaid 모드를 사용하세요. 권한 오류: 전체 디스크가 아닌 필요한 폴더만 허용하세요.

설치 참고 자료 및 지원