회사 Cloudflare 계정에 Studio 추가하기
회사 도메인을 이미 Cloudflare에서 관리하고 있다면 Studio를 같은 계정의 웹사이트 옆에 둘 수 있습니다. Studio에는 자체 무료 workers.dev 주소가 생기고, 원하면 내 도메인의 새 하위 도메인도 쓸 수 있습니다. 웹사이트와 DNS 레코드는 지금 그대로 유지됩니다.
- 적합 대상
- 도메인을 이미 Cloudflare에서 관리하는 회사.
- 필요한 것
- Studio가 있는 계정으로 로그인한 Windows용 또는 Mac용 Maxisnap, Worker를 추가할 수 있는 회사 Cloudflare 계정의 로그인 정보(또는 그 계정을 관리하는 담당자), 그리고 컴퓨터에 설치된 AI 코딩 어시스턴트 또는 Node.js 20 이상을 사용할 수 있는 터미널.
- 소요 시간
- 처음에는 약 20분 걸립니다.
- 결과
- 자체 workers.dev 주소의 Studio, 그리고 원한다면 snaps.yourcompany.com 같은 새 하위 도메인. 웹사이트는 지금 그대로 유지됩니다.
- 비용
- Studio는 Cloudflare의 무료 요금제에서 실행되도록 만들어졌습니다. Cloudflare는 R2의 현재 무료 사용량과 요금을 공개합니다.
Studio가 추가하는 것과 건드리지 않는 것
Studio가 추가하는 것
- Studio 앱 자체(Cloudflare에서는 “Worker”라고 부릅니다)
- 캡처를 저장하는 공간(“R2 bucket”)
- 라이브러리와 팀을 위한 작은 데이터베이스(“D1”)
- workers.dev에서의 Studio 주소, 그리고 선택한 경우 새 하위 도메인 하나
- 계정에 아직 없는 경우 계정의 workers.dev 이름(계정 전체에 이름 하나)
Studio가 건드리지 않는 것
- 웹사이트와 그 파일
- 내 도메인에 이미 있는 DNS 레코드
- 그 밖의 모든 Worker, 스토리지, 데이터베이스
- 결제 정보와 그 밖의 계정 설정
이미 사용 중인 이름이면 Studio는 다른 이름을 고르거나 사용자에게 묻습니다. 이미 있는 것을 교체하지는 않습니다.
Cloudflare나 웹사이트를 다른 사람이 관리한다면 먼저 그 사람과 상의하세요. 일부 회사는 회사 계정에 서비스를 추가할 수 있는 사람을 규정으로 정해 두거나, 모든 하위 도메인 앞에 로그인 페이지를 둡니다. 이런 로그인 페이지가 있으면 Maxisnap의 업로드가 막힙니다.
스토리지가 켜져 있는지 확인
Studio는 캡처를 Cloudflare R2에 저장합니다. 회사 Cloudflare 계정에 로그인해 한 번 확인하세요:
- Cloudflare 대시보드에서 Storage & databases → R2 → Overview를 여세요.
- Cloudflare에서 R2 추가를 제안하면 결제 절차를 완료하세요. 계정의 결제 담당자가 아니라면 담당자에게 이 단계를 요청하세요.
Studio 대시보드에서 사용 중인 스토리지 용량을 확인할 수 있습니다. 2026년 10월에 확인한 Cloudflare의 R2 문서에 따르면, R2는 매월 무료 사용량이 포함되어 있어 무료로 시작할 수 있으며, 사용량에 대해서는 월 단위로 청구됩니다.
컴퓨터에 Studio 받기
- Windows: Maxisnap에서 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭한 다음 “대시보드 다운로드”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장하고 그 폴더를 엽니다.
- Mac: Maxisnap에서 Settings → Welcome & Help → Studio Setup Guide를 열고 “Get Started”를 클릭한 다음 “Download Dashboard”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장합니다.
ZIP 파일의 압축을 풉니다. Windows에서는 마우스 오른쪽 버튼으로 클릭하고 “모두 추출”을 선택합니다. Mac에서는 두 번 클릭합니다.
처음부터 로고와 색상을 적용하고 싶으신가요? “Maxisnap Studio - Start Here.html”을 두 번 클릭해 열고 브랜딩을 디자인한 다음 “Lock in my branding”을 클릭하세요. 어시스턴트가 이 설정을 사용합니다. 건너뛰고 나중에 대시보드의 Branding에서 브랜딩을 바꿔도 됩니다.
주소 정하기
Studio에는 항상 workers.dev 주소가 생기며, 이 주소는 처음부터 작동합니다. 도메인이 이 Cloudflare 계정에서 활성 상태라면 snaps.yourcompany.com 같은 내 도메인의 새 하위 도메인도 추가할 수 있습니다.
주소는 다음과 같은 형태입니다: snaps.yourcompany.workers.dev
내 도메인은 나중에 아무것도 잃지 않고 추가할 수 있습니다.
AI 어시스턴트에게 맡기기
- AI 코딩 어시스턴트를 여세요. Claude Code, Codex, Cursor 또는 컴퓨터에서 명령을 실행할 수 있는 다른 어시스턴트면 됩니다.
- 고객센터의 AI 어시스턴트 가이드에서 준비된 지침을 복사하고, 꺾쇠괄호로 표시된 줄을 Studio 폴더로 바꾼 다음 붙여넣으세요.
- 회사가 이미 Cloudflare를 사용하고 있다는 점과 하위 도메인을 원하는지 알려 주세요. 어시스턴트는 Studio 폴더의 지침 파일을 읽고, 각 단계를 실행하기 전에 설명해 줍니다.
어시스턴트가 요청하면 Cloudflare 키 만들기
배포하려면 내 계정에서 작업할 권한이 필요합니다. 이 권한은 Cloudflare API 토큰으로 부여하며, 토큰은 이 작업 하나에만 쓰는 비밀번호와 같습니다.
- Cloudflare에서 My Profile → API Tokens를 열고 “Create Token”을 클릭한 다음 사용자 지정 토큰 만들기를 선택하세요.
- 다음 네 가지 권한을 추가하세요: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit, D1 Edit.
- 하위 도메인을 사용하려면 Zone Read, DNS Read, Workers Routes Read 세 가지를 더 추가하세요.
- Account Resources에서 회사 계정을 선택하세요. 하위 도메인을 사용하려면 Zone Resources에서 내 도메인을 포함하세요.
- “Continue to summary”를 클릭한 다음 “Create Token”을 클릭하세요. Cloudflare는 토큰을 한 번만 보여 주므로 바로 복사하세요.
- 어시스턴트가 요청하면 토큰을 채팅이 아니라 터미널에 직접 붙여넣으세요.
Cloudflare의 API Tokens 페이지 열기.
기술 개요서에서 각 권한이 어디에 쓰이는지 설명합니다. Studio가 실행되고 나면 토큰을 삭제해도 됩니다. 나중에 Studio를 업데이트하거나 제거할 때는 새 토큰이 필요합니다.
실행 계획을 확인한 다음 Studio 만들기
승인하기 전에는 아무것도 만들어지지 않습니다. 어시스턴트가 먼저 실행 계획을 만들어 보여 줍니다. “Will create”에는 Worker 하나, R2 버킷 하나, D1 데이터베이스 하나가 표시되며, 새로 만들어지는 workers.dev 이름과 선택한 하위 도메인도 함께 표시됩니다. “Will not touch”에는 내 도메인과 DNS, 다른 Worker, 버킷, 데이터베이스가 표시됩니다.
- 실행 계획에 이미 사용 중인 이름 같은 문제가 표시되면 다른 이름을 고르고 실행 계획을 다시 만드세요.
- 실행 계획이 맞아 보이면 어시스턴트에게 진행하라고 말하세요. 배포가 중간에 멈춰도 같은 명령을 다시 실행하면 아무것도 두 번 만들지 않고 이어서 진행합니다.
관리자 키 보관
- 배포가 끝나면 Studio 주소와 관리자 키가 한 번만 표시됩니다. 키는 비밀번호 관리자 같은 안전한 곳에 보관하세요. 이 키로 대시보드에 로그인하며, 키를 가진 사람은 누구나 내 Studio를 사용할 수 있습니다.
- cloudflare 폴더에 deployment.json이라는 파일도 만들어집니다. 나중에 Studio를 업데이트하거나 제거할 때 이 파일을 사용하므로 보관하세요.
Maxisnap을 연결하고 사용해 보기
- Windows용 Maxisnap: 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭하고, 4단계 “Maxisnap 연결”이 나올 때까지 “다음”을 클릭합니다. Studio 주소와 키를 붙여넣고 “연결 테스트”를 클릭한 다음 “다음”을 클릭하고, 마지막 페이지에서 “완료 및 저장”을 클릭합니다. 설정할 때 받은 관리자 키도, 대시보드의 People & access에 있는 업로드 코드도 사용할 수 있습니다.
- Mac용 Maxisnap: Settings → Welcome & Help → Studio Setup Guide를 열고 “I already have a dashboard”를 선택합니다. Studio 주소와 키를 붙여넣고 “Test Connection”, “Next”, “Finish & Save”를 차례로 클릭합니다.
무엇이든 캡처한 다음 편집기에서 “업로드”를 클릭하세요. Windows에서는 Ctrl+Alt+7을 누르면 영역을 캡처하고 바로 업로드합니다. 공유 링크는 클립보드에 복사됩니다.
Windows용 Maxisnap과 Mac용 Maxisnap은 각 업로드를 Cloudflare Studio에 요청 한 번으로 보내며, Cloudflare Studio는 파일당 최대 25 MB까지 받습니다.
다음 단계: 대시보드의 People & access에서 팀원을 추가하세요(모든 팀원이 각자의 코드와 역할을 받습니다). 로고나 색상은 Branding에서 언제든 바꿀 수 있습니다.
문제가 생겼을 때
하위 도메인이 이미 사용 중입니다
snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.
그 이름은 이미 어딘가를 가리키고 있으므로 Studio는 건드리지 않습니다. studio나 share처럼 아직 아무도 쓰지 않는 하위 도메인을 고르세요.
이미 Worker 라우트가 해당 하위 도메인을 포함하고 있습니다
The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.
계정의 다른 Worker가 해당 라우트와 일치하는 모든 하위 도메인에 응답하기 때문에 Studio에는 방문자의 요청이 전혀 도달하지 못합니다. 라우트 범위를 벗어난 이름을 고르거나, 그 라우트를 설정한 담당자에게 문의하세요.
Studio가 도메인을 찾지 못합니다
That domain is not in this Cloudflare account.
도메인이 다른 Cloudflare 계정에 있거나 토큰이 해당 도메인을 볼 수 없습니다. 도메인이 있는 계정에서 해당 도메인에 대해 Zone Read, DNS Read, Workers Routes Read 권한으로 토큰을 만드세요.
도메인이 “not active yet” 상태로 표시됩니다
yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.
Cloudflare가 아직 이 도메인에 응답하지 않습니다. 보통 네임서버가 여전히 이전 업체를 가리키고 있기 때문입니다. 지금은 workers.dev 주소를 사용하세요. 하위 도메인은 나중에 아무것도 잃지 않고 추가할 수 있습니다.
새 하위 도메인이 아직 열리지 않습니다
Cloudflare가 새 하위 도메인을 켜는 데 시간이 걸릴 수 있습니다. workers.dev 주소는 처음부터 작동하므로 그때까지 그 주소를 사용하세요.
하위 도메인에서는 업로드가 실패하지만 workers.dev 주소에서는 작동합니다
해당 하위 도메인의 Cloudflare 보안 설정이 Maxisnap을 막고 있습니다. Cloudflare Access(주소 앞에 로그인 페이지를 두는 기능), WAF 규칙, Bot Fight Mode 중 하나가 원인입니다. Cloudflare를 관리하는 담당자에게 Studio 하위 도메인을 통과시켜 달라고 요청하세요. 확인할 항목은 기술 개요서에 나와 있습니다.
실행 계획에서 Worker 라우트를 확인할 수 없다고 합니다
Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).
토큰에 Workers Routes Read를 추가하세요. 이 권한이 없으면 Studio는 다른 Worker가 이미 새 하위 도메인의 요청을 받고 있는지 확인할 수 없습니다.
스토리지가 켜져 있지 않습니다
R2 storage is not turned on for this Cloudflare account yet.
1단계에서 한 것처럼 Cloudflare 대시보드에서 R2를 켠 다음, 어시스턴트에게 실행 계획을 다시 만들도록 요청하세요.
Studio 이름이 이미 사용 중입니다
A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.
어시스턴트에게 snaps-yourcompany 같은 다른 이름을 알려 주세요. 스토리지나 데이터베이스 이름이 이미 사용 중이면 배포 도구가 다음으로 사용 가능한 이름을 알아서 고릅니다.
Cloudflare가 한 단계를 거부했습니다
Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.
토큰에 권한 하나가 빠져 있습니다. 5단계의 권한으로 새 토큰을 만들고, 어시스턴트가 요청하면 터미널에 다시 붙여넣으세요.
설정이 중간에 멈췄습니다
어시스턴트에게 같은 배포 명령을 다시 실행하도록 요청하세요. 이 명령은 멈춘 지점부터 이어서 진행하며 아무것도 두 번 만들지 않습니다.
새 주소가 아직 열리지 않습니다
Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.
모든 항목은 만들어졌고, Cloudflare가 아직 주소를 켜는 중입니다. 몇 분 기다린 다음 주소를 다시 여세요.
관리자 키를 잃어버렸습니다
어시스턴트가 새 키를 설정할 수 있습니다. 어시스턴트는 Studio 다운로드의 cloudflare 폴더에서, 터미널에 Cloudflare 토큰을 입력한 상태로 이 명령을 실행합니다. 이 명령은 새 키를 한 번만 보여 줍니다. 그런 다음 그 키로 Maxisnap을 다시 연결하세요.
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key큰 동영상이 업로드되지 않습니다
Windows용 Maxisnap과 Mac용 Maxisnap은 각 업로드를 Cloudflare Studio에 요청 한 번으로 보내며, Cloudflare Studio는 파일당 최대 25 MB까지 받습니다.
녹화 영상은 그 크기 이하로 유지하거나, 업로드하기 전에 길이를 줄이세요.
Maxisnap에서 키가 올바르지 않다고 합니다
저장해 둔 곳에서 키를 앞뒤 공백 없이 다시 복사하세요. 주소도 확인하세요. 설정할 때 표시된 주소이며, 다음 문자로 시작합니다: https://.
그래도 해결되지 않나요?
이메일로 문의해 주시면 담당자가 보통 영업일 기준 하루 안에 답장해 드립니다. 아래 정보를 함께 보내 주시면 한 번에 답변해 드릴 수 있습니다:
- 선택한 설정 방법과 현재 진행 중인 단계.
- 화면 스크린샷(오류 메시지가 있다면 전체 내용이 보이게).
- Studio를 설치할 위치: 새 Cloudflare 계정 또는 기존 Cloudflare 계정, 또는 웹 호스팅 업체 이름.
- Maxisnap 버전: Windows에서는 설정 → 정보에서, Mac에서는 Maxisnap → About Maxisnap에서 확인할 수 있습니다.
관리자 키, Cloudflare 키, 비밀번호는 보내지 말아 주세요. 도움을 드리는 데 필요하지 않습니다.