대시보드

새 배포 — slug 입력 + 드래그앤드롭 + 배포하기 (시작하기 탭 참고). slug 를 입력하면 칸 아래에 ✓ 사용 가능(공개될 주소 표시) 또는 ✕ 이미 사용 중 / 형식 오류 / 예약어가 실시간으로 표시되며, ✕ 인 동안은 배포 버튼이 잠깁니다. 카드 상단의 사용량 미터에서 프로젝트 개수·저장 용량 한도를 확인할 수 있습니다.

내 프로젝트 — 프로젝트마다 누적 조회수가 표시되며:

• slug 옆 배지 — 🔒 비밀번호 / 🔐 비공개. 배지가 없으면 공개입니다.
• 열기 — 주소를 새 탭에서 확인. 비밀번호·비공개 프로젝트는 소유자 자격으로 바로 열립니다 (방문자에게 보이는 화면을 확인하려면 시크릿 창에서 주소를 열어 보세요).
• 관리 › 공개 범위 — 패널 맨 위의 드롭다운. 공개 / 비밀번호 / 비공개 중 고르면 바로 저장되고, 비밀번호를 고르면 비밀번호 입력칸이 나타나 적용을 눌러야 저장됩니다(취소하면 이전 상태 유지). 비밀번호 상태에서는 비밀번호 변경 버튼이 보입니다. 각 상태의 동작은 시작하기 탭의 "공개 범위" 표를 참고하세요.
• 관리 — 방문 통계(누적·최근 14일 일별 그래프)와 파일 목록, 버전 히스토리(변경 전 자동 저장 — 실수해도 복원 가능). 파일이 하위 폴더에 있으면 폴더 트리로 표시됩니다 — 폴더를 클릭해 접고 펼 수 있고, 폴더 단위로 이름 변경(✎)·전체 삭제(✕)도 됩니다. 배포를 다시 하지 않고 라이브 파일을 편집: 새 탭 열기(↗), HTML·CSS·JS 등 텍스트 파일은 내용 편집(✏)으로 브라우저에서 바로 수정·저장(Tab 들여쓰기·Ctrl+S 지원), 이름 변경(✎)·삭제(✕), 아래 ＋ 추가/덮어쓰기 영역에 파일·폴더·ZIP 을 드롭하면 기존 파일에 병합됩니다. 이미지는 목록에서 썸네일로 보입니다
• 삭제 — 프로젝트와 모든 파일 삭제 (공개 주소도 즉시 내려감)

관리자는 모든 사용자의 프로젝트가 보이며 각 항목에 소유자 이메일이 함께 표시됩니다.

계정 설정

• 비밀번호 변경 — 현재 비밀번호 확인 후 변경
• API 키 — MCP·CLI 등 외부 도구용 키(utw_...) 발급/폐기. 원문 키는 발급 시 딱 한 번만 표시되고 서버에는 해시만 저장됩니다. 계정당 최대 10개, 목록에서 마지막 사용 시각을 확인할 수 있습니다. 키가 유출되면 폐기하고 새로 발급하세요 — 키로는 키를 만들 수 없습니다.

사용자 관리 ADMIN

관리자에게만 보이는 메뉴입니다. 사용자 추가(이메일·이름·비밀번호·역할), 역할(USER/ADMIN) 변경, 비번 초기화, 삭제(해당 사용자의 프로젝트도 함께 삭제)를 할 수 있습니다.

API 키로 배포하기 (CLI / CI)

로그인 후 계정 설정 → API 키에서 키를 발급하세요. 비밀번호 대신 Authorization: Bearer utw_... 헤더로 프로젝트 API 를 호출하며, 키는 발급한 계정의 프로젝트에만 접근할 수 있습니다.

BASE=
KEY=utw_...   # 계정 설정 → API 키에서 발급

# 0) slug 확인 — 형식·예약어·중복 (배포 전에 먼저!)
curl "$BASE/api/projects/check?slug=my-page" -H "Authorization: Bearer $KEY"
# → {"slug":"my-page","valid":true,"available":true,"owned":false,"reason":null}
#   available=false 면 reason 에 이유("이미 사용 중" 등), owned=true 면 내 프로젝트

# 1) 신규 배포 — slug 는 1회성(이미 있으면 409). 하위 경로는 paths(JSON 배열, files 와 같은 순서)
curl -X POST $BASE/api/projects/my-page/upload \
  -H "Authorization: Bearer $KEY" \
  -F "files=@index.html" -F "files=@app.js" \
  -F 'paths=["index.html","assets/app.js"]' -F "title=My Page"

# 2) 기존 프로젝트 수정 — 파일 추가/덮어쓰기(병합) · 이름 변경 · 삭제
curl -X POST $BASE/api/projects/my-page/files \
  -H "Authorization: Bearer $KEY" -F "files=@style.css"
curl -X PATCH $BASE/api/projects/my-page/files \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"from":"style.css","to":"css/style.css"}'
curl -X DELETE "$BASE/api/projects/my-page/files?path=css/style.css" -H "Authorization: Bearer $KEY"

# 3) 공개 범위 — PUBLIC(기본) · PASSWORD(password 필수, 4~72자) · PRIVATE(소유자만)
curl -X PATCH $BASE/api/projects/my-page/access \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"visibility":"PASSWORD","password":"secret1234"}'
curl -X PATCH $BASE/api/projects/my-page/access \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"visibility":"PUBLIC"}'          # 또는 "PRIVATE" — 저장된 비밀번호는 지워짐
# 비공개/비밀번호 프로젝트를 소유자로 여는 1회용 URL(5분 유효) — 브라우저에서 열면 7일 쿠키 발급
curl $BASE/api/projects/my-page/open-token -H "Authorization: Bearer $KEY"

# 4) 조회 — 목록(visibility 포함) / 상세+파일 / 텍스트 파일 내용 / 방문 통계 / 버전
curl $BASE/api/projects -H "Authorization: Bearer $KEY"
curl $BASE/api/projects/my-page -H "Authorization: Bearer $KEY"
curl "$BASE/api/projects/my-page/file?path=index.html" -H "Authorization: Bearer $KEY"
curl $BASE/api/projects/my-page/stats -H "Authorization: Bearer $KEY"
curl $BASE/api/projects/my-page/versions -H "Authorization: Bearer $KEY"
curl -X POST $BASE/api/projects/my-page/versions/3/restore -H "Authorization: Bearer $KEY"

# 5) 삭제 — 주소가 즉시 내려가고 slug 는 다시 사용 가능해짐
curl -X DELETE $BASE/api/projects/my-page -H "Authorization: Bearer $KEY"

한도: 파일당 20MB · 요청당 100개 — 더 많은 파일은 upload 1회 후 files 병합을 반복하세요. 사용량은 GET /api/projects/usage 로 확인합니다.

엔드포인트 요약

공개 콘텐츠 — /<slug>/ (끝 슬래시 권장, 없으면 301). 공개 범위가 비밀번호면 HTML 요청에 401 + 입력 화면, 비공개면 403 + 안내 화면, 첨부 파일은 403. 비밀번호 제출은 POST /<slug>/__gate(password, next) — IP 당 분당 10회.

오류 코드

AI 도구 연동이란?

한 번 연결해 두면 파일을 내려받아 직접 올릴 필요가 없어집니다. AI 에게 "랜딩 페이지 만들어서 myapp 으로 배포해줘" 라고 말하면 AI 가 알아서 이 서비스에 배포까지 해 주고, "myapp 파일 목록 보여줘", "제목을 바꿔서 다시 올려줘" 처럼 대화만으로 관리할 수 있습니다.

이 연결에는 MCP 라는 표준 방식을 사용합니다 — AI 도구가 외부 서비스를 직접 조작할 수 있게 해 주는 일종의 "공용 플러그"라고 생각하면 됩니다. MCP 서버가 이 서비스에 내장되어 있어서 여러분이 설치하거나 실행할 것은 아무것도 없고, AI 도구의 설정 화면에 주소 한 줄만 등록하면 됩니다.

준비물 — API 키 발급 (1분, 로그인 필요)

API 키는 AI 도구가 내 계정임을 증명할 때 비밀번호 대신 쓰는 열쇠입니다.

1. 이 사이트에 로그인 → 상단 메뉴 계정 설정 → API 키 로 이동합니다.
2. 키 이름(예: chatgpt)을 입력하고 키 발급을 누릅니다.
3. utw_ 로 시작하는 긴 문자열이 표시됩니다 — 이때 딱 한 번만 보여지므로 복사해서 안전한 곳에 보관하세요. 아래 안내의 utw_... 자리에 이 키를 넣습니다.

등록할 주소는 이것 하나입니다:

/mcp

키를 전달하는 방법은 도구마다 둘 중 하나입니다 — Authorization: Bearer utw_... 헤더에 넣거나, 헤더 설정이 없는 도구는 주소 뒤에 붙입니다: /mcp?key=utw_... (이 주소 자체가 비밀 열쇠를 포함하므로 다른 사람에게 공유하면 안 됩니다). 키가 유출됐다면 계정 설정에서 폐기하고 새로 발급하면 됩니다.

ChatGPT (웹)

1. ChatGPT 설정 → 커넥터 → 고급 설정에서 개발자 모드를 켭니다.
2. 커넥터 만들기를 누르고 MCP 서버 URL 칸에 /mcp?key=utw_... 를 입력합니다 (인증: 없음 선택 — 키가 주소에 이미 들어 있기 때문입니다).
3. 새 대화에서 이 커넥터를 켜고 "index.html 만들어서 my-page 로 배포해줘" 라고 해 보세요.

커넥터 대신 커스텀 GPT Actions 에 REST API 를 등록(인증: API Key → Bearer, 키 값 utw_...)하는 방법도 사용할 수 있습니다.

Codex CLI 를 쓴다면 — ~/.codex/config.toml 에:

[mcp_servers.uploadtowork]
url = "/mcp"
bearer_token = "utw_..."

Claude (claude.ai · Claude Code)

claude.ai / Claude Desktop — 설정 → 커넥터 → 커스텀 커넥터 추가 에 URL /mcp?key=utw_... 를 등록합니다.

Claude Code (터미널 도구) — 아래 한 줄을 실행합니다:

claude mcp add --scope user --transport http uploadtowork \
  /mcp \
  --header "Authorization: Bearer utw_..."

Gemini (Gemini CLI)

Gemini CLI — ~/.gemini/settings.json 파일에:

{
  "mcpServers": {
    "uploadtowork": {
      "httpUrl": "/mcp",
      "headers": { "Authorization": "Bearer utw_..." }
    }
  }
}

웹 Gemini 는 아직 원격 MCP 연결을 지원하지 않습니다 — Gemini 가 만들어 준 파일을 대시보드에 드래그앤드롭하거나, API·CLI 탭의 방법을 사용하세요.

연결한 뒤에는 이렇게 말해 보세요

• "my-page 라는 주소를 쓸 수 있는지 확인해줘" · "내가 이미 쓰고 있는 주소 목록 보여줘" — slug 는 전체 사용자 중 하나뿐이라 AI 가 check_slug / list_projects 로 먼저 확인합니다
• "방금 만든 HTML 을 my-page 라는 이름으로 배포해줘" (이미 있는 이름이면 AI 가 다른 이름을 제안합니다)
• "my-page 에 어떤 파일이 있어?" · "my-page 의 제목을 바꾸고 다시 올려줘"
• "my-page 를 비밀번호 1234 로 잠가줘" · "my-page 를 나만 볼 수 있게 해줘" · "my-page 를 다시 공개로 바꿔줘" — 공개 범위(set_access)
• "my-page 어제 버전으로 되돌려줘" · "my-page 프로젝트 삭제해줘"

참고 — AI 가 사용할 수 있는 기능(도구): whoami(내 계정 확인) · list_projects(목록) · get_project(상세) · read_file(텍스트 파일 내용 읽기) · get_stats(방문 통계) · check_slug(주소 사용 가능 여부 — 형식·예약어·중복) · deploy_project(새 배포, index.html 필수, slug 1회성) · upload_files(기존 프로젝트에 파일 추가/덮어쓰기) · rename_file · delete_file · set_access(공개 범위: PUBLIC 누구나 · PASSWORD 비밀번호 필수 · PRIVATE 소유자만) · list_versions(버전 목록) · restore_version(버전 복원) · delete_project