AI 어시스턴트에게 Studio 설정 맡기기
컴퓨터에서 실행하는 Claude Code, Codex, Cursor 같은 AI 코딩 어시스턴트가 Studio를 대신 온라인에 올려 줄 수 있습니다. 준비된 지침을 붙여넣으면 됩니다. 어시스턴트는 Studio 다운로드에 들어 있는 설정 지침을 읽고, 웹 호스팅과 Cloudflare 계정 중 어느 쪽이 더 잘 맞는지 함께 정한 다음, 무엇이든 바꾸기 전에 먼저 물어봅니다.
- 적합 대상
- 컴퓨터에서 명령을 실행할 수 있는 AI 코딩 어시스턴트를 이미 사용하는 분들께 적합합니다. 웹 호스팅이든 Cloudflare든 어느 쪽 Studio에도 쓸 수 있습니다.
- 필요한 것
- Studio가 있는 계정으로 로그인한 Windows용 또는 Mac용 Maxisnap, 컴퓨터에 설치된 AI 코딩 어시스턴트, 그리고 호스팅 로그인 정보 또는 Cloudflare 계정.
- 소요 시간
- 대부분 어시스턴트에게 맡겨 두면 됩니다. 어시스턴트의 질문에 답하고 각 변경을 승인하세요.
- 결과
- 다른 설정 방법과 같은 Studio를 내 웹 호스팅 또는 내 Cloudflare 계정에서 사용합니다.
어시스턴트가 따르는 지침
모든 Studio 다운로드에는 AI 어시스턴트를 위해 작성된 지침이 들어 있습니다. 이 지침에는 Studio의 두 에디션, 정확한 설치 단계, 비공개로 유지해야 할 항목, 결과를 확인하는 방법이 설명되어 있습니다. 또한 어시스턴트에게 다음과 같이 하도록 안내합니다:
- 서버나 계정에 업로드, 배포, 변경을 하기 전에 항상 먼저 물어보고, 무엇을 바꿀지 정확히 말해 줍니다.
- 이미 있는 웹사이트 파일, DNS 레코드, Worker, 버킷, 데이터베이스를 절대 삭제하거나 덮어쓰거나 이름을 바꾸지 않습니다. Studio는 새 항목만 추가합니다.
- 만드는 파일에 키와 비밀번호를 넣지 않습니다.
- 마지막에 Studio 주소와 관리자 키를 알려 주어 Maxisnap을 연결할 수 있게 합니다.
컴퓨터에 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에서는 두 번 클릭합니다.
압축을 푼 폴더의 위치를 복사해 두세요. 3단계에서 붙여넣습니다. Windows에서는 폴더를 마우스 오른쪽 버튼으로 클릭하고 “경로로 복사”를 선택합니다. Mac에서는 폴더를 선택한 다음 Option+Command+C를 누릅니다.
AI 어시스턴트용 지침 파일은 해당 폴더에 있습니다:
AGENTS.md
원한다면 브랜딩 확정하기
“Maxisnap Studio - Start Here.html”을 두 번 클릭해 열고 로고, 색상, 글꼴을 디자인한 다음 “Lock in my branding”을 클릭하세요. 어시스턴트가 이 설정을 사용합니다. 이 단계를 건너뛰고 나중에 대시보드의 Branding에서 브랜딩을 바꿔도 됩니다.
지침 복사
이 지침을 복사하고, 꺾쇠괄호로 표시된 줄을 Studio 폴더로 바꾼 다음 어시스턴트에 붙여넣으세요.
Set up Maxisnap Studio for me. Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1. Everything is in this folder on my computer: <the folder where I extracted the Studio download> Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result. If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing. Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it. Rules: - Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change. - Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things. - Keep keys and passwords out of files you create and out of chat transcripts where you can. - When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).복사 복사됨 복사했습니다. 어시스턴트에 붙여넣으세요. 브라우저가 복사를 차단했습니다. 대신 텍스트를 선택해서 복사하세요.
어시스턴트의 질문에 답하기
- 웹사이트가 웹 호스팅(cPanel, hPanel, Plesk 등)에 있는지, Cloudflare에 있는지, 아니면 아직 어디에도 없는지 알려 주세요. 웹사이트가 없다면 Cloudflare 에디션이 안전한 선택입니다.
- 웹 호스팅의 경우, 무엇을 어디에 업로드할지 알려 주며, 호스팅에 접근할 수 있게 해 주면 대신 업로드해 줍니다.
- Cloudflare에 배포할 때는 Cloudflare API 토큰을 요청합니다. Cloudflare의 My Profile → API Tokens에서 어시스턴트가 알려 주는 권한으로 토큰을 만들고, 토큰은 직접 터미널에 붙여넣으세요.
승인하기 전에 실행 계획 확인하기
Cloudflare에 배포하기 전에 어시스턴트가 실행 계획을 보여 줍니다. “Will create”에는 Worker 하나, R2 버킷 하나, D1 데이터베이스 하나가 표시되고, “Will not touch”에는 계정의 나머지 항목이 모두 표시됩니다. 웹 호스팅에서는 어떤 폴더를 추가할지 알려 줍니다. 목록이 맞아 보일 때만 승인하세요.
Maxisnap을 연결하고 사용해 보기
정상적으로 작동하면 어시스턴트가 Studio 주소와 관리자 키를 알려 줍니다. 키는 비밀번호 관리자 같은 안전한 곳에 보관하세요.
- 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을 누르면 영역을 캡처하고 바로 업로드합니다. 공유 링크는 클립보드에 복사됩니다.
다음 단계: 대시보드의 People & access에서 팀원을 추가하세요(모든 팀원이 각자의 코드와 역할을 받습니다). 로고나 색상은 Branding에서 언제든 바꿀 수 있습니다.
문제가 생겼을 때
어시스턴트가 파일을 열거나 명령을 실행할 수 없다고 합니다
Claude Code, Codex, Cursor처럼 컴퓨터에서 실행되며 폴더에서 작업할 수 있는 코딩 어시스턴트를 사용하세요. 브라우저 탭의 채팅은 Studio 폴더를 볼 수 없고 배포 도구도 실행할 수 없습니다.
어시스턴트가 지침 파일을 찾지 못합니다
지침에 붙여넣은 폴더를 확인하세요. ZIP 파일이 아니라 압축을 푼 Studio 폴더여야 하며, 이 폴더 안에 AI 어시스턴트용 지침 파일이 있습니다.
어시스턴트가 Node.js가 없거나 너무 오래된 버전이라고 합니다
Cloudflare 배포 도구에는 Node.js 20 이상이 필요합니다. nodejs.org에서 현재 LTS 버전을 설치하거나, 어시스턴트가 설치할 내용을 먼저 알려 준 뒤 설치하도록 맡긴 다음 다시 시작하세요. 웹 호스팅의 Studio에는 Node.js가 필요하지 않습니다.
어시스턴트가 토큰이나 비밀번호를 채팅에 붙여넣으라고 합니다
대신 명령이 요청할 때 터미널에 붙여넣으세요. 그러면 채팅 기록에 남지 않습니다. 이미 Cloudflare 토큰을 채팅에 붙여넣었다면 Studio가 실행되고 나서 Cloudflare의 My Profile → API Tokens에서 그 토큰을 삭제하고, 다음에 필요할 때 새로 만드세요.
어시스턴트가 무언가를 삭제하거나 교체하거나 이름을 바꾸려고 합니다
거절하세요. Studio는 새 항목만 추가하며, Studio의 지침은 어시스턴트가 기존 웹사이트 파일, DNS 레코드, Worker, 버킷, 데이터베이스를 삭제하거나 덮어쓰거나 이름을 바꾸지 않도록 안내합니다. 대신 새 이름을 고르도록 요청하세요.
어시스턴트가 브랜딩 파일이 없다고 합니다
아직 브랜딩을 확정하지 않았습니다. “Maxisnap Studio - Start Here.html”을 열어 브랜딩을 디자인하고 “Lock in my branding”을 클릭하거나, 어시스턴트에게 Maxisnap 기본 디자인으로 진행하라고 알려 주세요. 나중에 대시보드의 Branding에서 바꿀 수 있습니다.
어시스턴트의 최종 확인에서 401 또는 404가 나옵니다
{"error":"unauthorized"}
401은 키가 잘못되었다는 뜻입니다. 설정할 때 표시된 관리자 키를 그대로 사용하세요. 404가 나오거나 짧은 응답 대신 웹 페이지가 표시되면 주소나 폴더가 잘못되었거나, 웹 호스팅에서 Studio의 .htaccess 규칙이 무시되고 있다는 뜻입니다.
Cloudflare 배포가 중간에 멈췄습니다
어시스턴트에게 같은 폴더에서 같은 배포 명령을 다시 실행하도록 요청하세요. 이 명령은 deployment.json을 읽고 멈춘 지점부터 이어서 진행하며, 아무것도 두 번 만들지 않습니다.
어시스턴트가 알려 준 주소와 키로 Maxisnap이 연결되지 않습니다
주소는 Studio 대시보드를 열 때 쓰는 주소이며, 시작 부분과 예시는 각각 다음과 같습니다: https://, https://yourcompany.com/snaps. 키는 앞뒤에 공백 없이 복사하세요. 각 메시지의 의미는 기존 Studio를 연결하는 가이드에서 설명합니다.
그래도 해결되지 않나요?
이메일로 문의해 주시면 담당자가 보통 영업일 기준 하루 안에 답장해 드립니다. 아래 정보를 함께 보내 주시면 한 번에 답변해 드릴 수 있습니다:
- 선택한 설정 방법과 현재 진행 중인 단계.
- 화면 스크린샷(오류 메시지가 있다면 전체 내용이 보이게).
- Studio를 설치할 위치: 새 Cloudflare 계정 또는 기존 Cloudflare 계정, 또는 웹 호스팅 업체 이름.
- Maxisnap 버전: Windows에서는 설정 → 정보에서, Mac에서는 Maxisnap → About Maxisnap에서 확인할 수 있습니다.
관리자 키, Cloudflare 키, 비밀번호는 보내지 말아 주세요. 도움을 드리는 데 필요하지 않습니다.