← 로그인

마이 워크 허브 · 처음 시작하기

내 업무 허브 배포 준비

코드를 내 계정으로 배포하는 분을 위한 안내예요. 이미 준비된 앱을 사용하는 분은 로그인 후 ‘처음 시작하기’만 따라가면 돼요.

Vercel은 앱을 실행하는 곳, Supabase는 로그인과 업무 자료를 보관하는 곳, AI Gateway는 여러 AI를 하나의 연결로 사용하는 곳이에요.

1. 내 코드와 배포 공간 준비

  1. 코드 사본을 내 GitHub 저장소에 준비하고, Vercel에서 가져오기를 선택해요. 프레임워크는 Next.js예요.
  2. Vercel이 발급한 앱 주소를 메모해요. 주소는 내 배포의 주소를 사용하며 다른 사람의 운영 주소를 복사하지 않아요.
  3. 아래 환경변수를 등록한 뒤 새 배포에 반영해요. 환경변수는 서버가 읽는 설정값이며, Vercel 프로젝트의 Settings → Environment Variables에 넣어요.

2. Supabase와 첫 로그인 준비: 필수

  1. Supabase에서 새 프로젝트를 만들어요. 프로젝트 URL·anon 키·service role 키를 아래 이름으로 Vercel에 등록해요. 코드가 사용하는 키 종류를 그대로 사용해요.
  2. 새 빈 DB에는 코드의 supabase/migrations SQL 파일을 번호 순서대로 적용해야 해요. 0001의 초기 소유자 이메일은 로그인할 내 이메일로 바꿔요. 이미 운영 중인 DB에 전체 파일을 다시 실행하는 절차는 아니에요.
  3. Google Cloud에서 웹 OAuth 클라이언트를 만들고 Supabase의 Google 로그인 제공자 설정에 클라이언트 ID·비밀값을 등록해요. Google의 승인된 리디렉션 URI에는 Supabase가 안내하는 https://프로젝트주소.supabase.co/auth/v1/callback을 넣어요.
  4. Supabase의 URL Configuration에서 Site URL은 내 앱 주소, Redirect URLs는 https://내앱주소/auth/callback으로 등록해요. Google Client ID·Secret은 앱의 Vercel 환경변수에도 같은 값으로 등록해요.
  5. 메일·일정·Drive·주소록을 쓰려면 Google Cloud의 해당 API와 동의 화면 권한도 준비해요. 메일 추가 계정용 직접 콜백은 /auth/google-link/callback, 이메일 제한 공유용은 /auth/share-verify/callback이에요. 사용할 기능의 콜백을 내 앱 주소와 함께 Google OAuth 클라이언트에 등록해요.

NEXT_PUBLIC_SUPABASE_URL: 프로젝트 URL

NEXT_PUBLIC_SUPABASE_ANON_KEY: 공개 anon 키

SUPABASE_SERVICE_ROLE_KEY: 서버 전용 비밀 키

GOOGLE_CLIENT_ID · GOOGLE_CLIENT_SECRET: 구글 업무 연동

확인 방법: 내 이메일로 로그인하고 프로젝트·메모 화면을 열어 보세요. 입장 거부는 허용 이메일·approved 상태, 로그인 복귀 오류는 두 곳의 콜백 주소를 확인해요.

구글 로그인 공식 설명

3. AI Gateway 준비: AI 사용 시 권장

  1. Vercel에서 내 프로젝트와 같은 팀의 AI Gateway를 열어요. 이용 가능 상태·크레딧·결제 수단·지출 한도를 확인해요. 요금과 한도는 현재 대시보드의 값을 기준으로 해요.
  2. Vercel 배포는 자동 인증(OIDC) 우선이에요. 프로젝트가 제공하는 인증을 앱이 읽으므로, 보통 별도 AI 키를 직접 관리하지 않아도 돼요. 인증이 있다는 것만으로 실제 모델 호출 성공이 보장되지는 않아요.
  3. Vercel 밖의 서버나 로컬 환경에서는 AI Gateway 키 하나를 발급해 AI_GATEWAY_API_KEY라는 서버 환경변수에 등록할 수 있어요. Vercel 로컬 연동은 공식 OIDC 안내를 따라요. OIDC 토큰을 코드에 복사하거나 직접 고정해서 등록하지 않아요.
  4. 로그인 후 설정 → AI 모델에서 비서·요약·메일의 연결을 Gateway 자동 사용으로 선택해요. 원하는 기능에서 지원되는 Gateway 모델을 고르고, 연결 시험을 직접 실행해요. 시험도 AI 사용량과 비용이 발생할 수 있어요.
  5. 설정 → AI 모델 → 사용량·비용과 Vercel AI Gateway 로그를 함께 확인해요. 오류가 나면 같은 팀인지, 크레딧·한도·인증 설정이 맞는지 점검해요.

개별 OpenAI·Anthropic·Gemini 키는 직접 연결을 선택하는 고급 경로예요. Gateway로 쓸 모델마다 제공사 키를 따로 등록할 필요는 없어요. 녹음 전사·영수증 인식 등은 해당 메뉴의 엔진을 별도로 확인해요.

4. 선택 기능은 나중에

앱 설치와 기기 알림, MCP로 외부 AI 앱 연결, 녹음 자동 업로드는 기본 업무 사용 후 추가해도 돼요. 알림·정리 예약을 운영한다면 서버의 CRON_SECRET을 준비하고 Vercel 예약 목록을 확인해요. 음성 기록·푸시 등의 추가 준비는 코드의 .env.example과 메뉴 설정을 참고해요.

헷갈리는 말

API / 키
다른 서비스를 사용하는 연결 / 그 연결을 인증하는 값이에요.
OAuth / 콜백
내 구글 계정 사용을 허용하는 절차 / 허용 후 돌아올 주소예요.
모델 / Gateway
실제로 답을 만드는 AI / 여러 AI를 한 곳에서 연결하는 창구예요.

서버 비밀 키는 Vercel 설정 또는 로컬 .env.local에만 넣어요. 앱의 안내 화면·채팅·GitHub 코드에는 넣지 않아요. 일반 사용자는 운영 담당자에게 설정을 요청하면 돼요.

준비를 마쳤으면 로그인