노트와 스타일러스가 있는 은은한 조명의 스튜디오 책상

문서

Lami를 안심하고 쓰는 법

이 페이지는 제품의 고객용 지도입니다. 온보딩에서 워크스페이스 준비까지 프로젝트가 어떻게 움직이는지, 어떤 표면이 있는지, 이슈를 어떻게 책임 있게 올릴지 설명합니다.

여기서 시작: 계정과 조직

통제 가능한 이메일로 가입합니다. 조직은 결제·멤버·프로젝트를 묶으며, 워크스페이스가 안정되면 협업자를 초대합니다.

신규 멤버에 관리자 승인이 필요한 조직은, 공유 프로젝트 접근 전 승인 메일을 기다려 주세요.

프로젝트 만들기와 Theme 마법사

모든 project 행은 온보딩과 마법사 이후 작업 전체에 걸쳐 유지됩니다—별도의 워크스페이스 전용 프로젝트가 없습니다. 마법사는 레퍼런스, 팔레트 의도, 구조적 신호를 담습니다.

나갔다 돌아올 수 있습니다. 미완 온보딩은 Theme이 워크스페이스 진입에 필요한 완료 상태에 이르기 전까지 이어서 설정 흐름에 보입니다.

워크스페이스 준비 vs 초안

대시보드 활성 목록과 OpenDrive 가져오기 대상에는 활성 상태이고 온보딩이 끝났으며 Theme이 완료된 프로젝트만 포함됩니다. 초안 행은 이어서 설정 흐름에서 계속 다룰 수 있습니다.

이 구분은 팀이 생산 준비 자산을 기대하는 곳에 설정이 덜 된 구성이 나타나지 않게 합니다.

워크스페이스, 미디어, 보드

워크스페이스는 같은 project id에 묶인 캔버스 도구, 배경 워크플로, Object Lab 보드를 호스팅합니다. 미디어 라이브러리는 레퍼런스를 중복 없이 유지해 프롬프트는 짧게, 의도는 풍부하게 유지합니다.

오프라인이나 불안정한 네트워크: 일부 표면은 저장을 큐에 넣습니다. 업로드 중 탭을 닫지 말고 UI의 재시도 상태를 확인하세요.

AI 사용, 한도, 안전

생성 호출은 Lami의 제공자 연동을 통해 라우팅됩니다. 스트리밍과 모델 가용성은 기능마다 다를 수 있으며, 관리자는 집계 사용량을, 멤버는 프로젝트 범위 지표를 봅니다.

규제 대상 건강·금융·개인 식별 고객 데이터를 계약이 명시적으로 허용하지 않는 한 프롬프트에 넣지 마세요. 불확실하면 처리 전 Contact로 문의하세요.

지원과 에스컬레이션

제품, 결제, 개인정보 요청은 Contact 폼을 사용합니다. 생성 실패를 보고할 때 재현 단계와 타임스탬프를 포함해 주세요—로그에 요청 식별자가 붙어 처리가 빨라집니다.

보안 취약점은 같은 채널로, 제목에 SECURITY를 넣어 책임 있게 알려 주세요.

출시 리듬과 변경 관점

Lami는 기능 플래그 뒤에서 지속적으로 배포합니다. 사용자에게 보이는 변경은 프로덕션 조직에 안정될 때 반영되며, 실험 토글은 통제된 환경에서 더 일찍 미리 볼 수 있습니다.

고객 대면 동작이 바뀔 때 이 문서를 갱신합니다. 저장소의 엔지니어링 에픽은 계약적 약속이 아닙니다.

Studio MCP (에이전트 연결)

MCP는 Cursor·Claude Code 등이 Lami Studio 도구(theme_create, theme_items_create_job, theme_characters_create_job 등)를 호출하는 통로입니다. 이 페이지에서 설정은 두 가지입니다. MCP(이 섹션)와 Agent Skill 설치(다음 섹션)를 각각 해야 합니다.

1단계 — API 키: lami.design → 조직 → API keys에서 Studio 키(lami_live_…)를 만듭니다. 테마·job 조회·대기는 themes:read, 파이프라인 실행은 themes:write가 필요합니다.

2단계 — MCP URL: 프로덕션은 https://lami.design/api/mcp 입니다(/mcp만 쓰지 마세요). 로컬 개발은 Lami 저장소에서 bun run dev:mcp 실행 후 http://127.0.0.1:3030/api/mcp 입니다.

3단계 — Cursor 설정: 아래 블록을 ~/.cursor/mcp.json(전역) 또는 프로젝트 .cursor/mcp.json에 넣습니다. Cursor를 띄우는 셸에서 export LAMI_API_KEY=lami_live_… 하거나, Cursor 설정 → Tools & MCP → Environment에 같은 변수를 넣은 뒤 Cursor를 재시작합니다.

4단계 — 확인: 채팅에서 MCP 도구 목록을 보거나 studio://agent-workflow 리소스를 읽게 하세요. 로그인한 멤버는 /dashboard/studio/playground(Studio Playground)에서 같은 도구를 브라우저로 먼저 시험할 수 있습니다.

# 프로덕션 MCP
URL: https://lami.design/api/mcp
헤더: Authorization: Bearer lami_live_<키>

# ~/.cursor/mcp.json (mcpServers에 병합)
{
  "mcpServers": {
    "lami-studio": {
      "url": "https://lami.design/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LAMI_API_KEY}"
      }
    }
  }
}

# 로컬(Lami 저장소): bun run dev:mcp  →  http://127.0.0.1:3030/api/mcp
# 보조 스크립트: bun run dev:mcp:setup

Lami Studio Agent Skill 설치

lami-studio 스킬은 허브(SKILL.md: 개요, cold start, recipe, 규칙)와 참조 파일(async-jobs, contracts, vfx-pipeline, mcp, api, sdk)로 구성된 멀티파일 번들입니다. MCP를 대체하지 않습니다 — 8번 섹션을 먼저 완료하세요.

선행 조건: Studio API 키(lami_live_…)와 MCP 서버 설정.

아무 프로젝트에서 설치:

npx skills add unsanityinc/lami --skill lami-studio -y

전역 설치: -g 추가. 로컬 Lami 클론: repo root에서 npx skills add . --skill lami-studio -y

MCP + skill 설치 후: studio://agent-workflow 읽기 → studio_discover → studio_recipe(new_theme_then_items). 필수: async-jobs.md (create_job은 wait_job이 ready 될 때까지 202).

# 프로젝트 (unsanityinc/lami GitHub 접근 필요)
npx skills add unsanityinc/lami --skill lami-studio -y

# 전역
npx skills add unsanityinc/lami --skill lami-studio -y -g

# 로컬 클론 — Lami repo root에서
npx skills add . --skill lami-studio -y

# .cursor/skills/lami-studio/ 에 번들 설치
# SKILL.md, async-jobs.md, contracts.md, vfx-pipeline.md, mcp.md, api.md, sdk.md, dev-mcp-scripts.md

문서에 없는 도움이 필요하면 Contact로 이동