마이 워크 허브 · 처음 시작하기
내 업무 허브 배포 준비
코드를 내 계정으로 배포하는 분을 위한 안내예요. 이미 준비된 앱을 사용하는 분은 로그인 후 ‘처음 시작하기’만 따라가면 돼요.
Vercel은 앱을 실행하는 곳, Supabase는 로그인과 업무 자료를 보관하는 곳, AI Gateway는 여러 AI를 하나의 연결로 사용하는 곳이에요.
1. 내 코드와 배포 공간 준비
- 코드 사본을 내 GitHub 저장소에 준비하고, Vercel에서 가져오기를 선택해요. 프레임워크는 Next.js예요.
- Vercel이 발급한 앱 주소를 메모해요. 주소는 내 배포의 주소를 사용하며 다른 사람의 운영 주소를 복사하지 않아요.
- 아래 환경변수를 등록한 뒤 새 배포에 반영해요. 환경변수는 서버가 읽는 설정값이며, Vercel 프로젝트의 Settings → Environment Variables에 넣어요.
2. Supabase와 첫 로그인 준비: 필수
- Supabase에서 새 프로젝트를 만들어요. 프로젝트 URL·anon 키·service role 키를 아래 이름으로 Vercel에 등록해요. 코드가 사용하는 키 종류를 그대로 사용해요.
- 새 빈 DB에는 코드의
supabase/migrationsSQL 파일을 번호 순서대로 적용해야 해요. 0001의 초기 소유자 이메일은 로그인할 내 이메일로 바꿔요. 이미 운영 중인 DB에 전체 파일을 다시 실행하는 절차는 아니에요. - Google Cloud에서 웹 OAuth 클라이언트를 만들고 Supabase의 Google 로그인 제공자 설정에 클라이언트 ID·비밀값을 등록해요. Google의 승인된 리디렉션 URI에는 Supabase가 안내하는
https://프로젝트주소.supabase.co/auth/v1/callback을 넣어요. - Supabase의 URL Configuration에서 Site URL은 내 앱 주소, Redirect URLs는
https://내앱주소/auth/callback으로 등록해요. Google Client ID·Secret은 앱의 Vercel 환경변수에도 같은 값으로 등록해요. - 메일·일정·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 사용 시 권장
- Vercel에서 내 프로젝트와 같은 팀의 AI Gateway를 열어요. 이용 가능 상태·크레딧·결제 수단·지출 한도를 확인해요. 요금과 한도는 현재 대시보드의 값을 기준으로 해요.
- Vercel 배포는 자동 인증(OIDC) 우선이에요. 프로젝트가 제공하는 인증을 앱이 읽으므로, 보통 별도 AI 키를 직접 관리하지 않아도 돼요. 인증이 있다는 것만으로 실제 모델 호출 성공이 보장되지는 않아요.
- Vercel 밖의 서버나 로컬 환경에서는 AI Gateway 키 하나를 발급해
AI_GATEWAY_API_KEY라는 서버 환경변수에 등록할 수 있어요. Vercel 로컬 연동은 공식 OIDC 안내를 따라요. OIDC 토큰을 코드에 복사하거나 직접 고정해서 등록하지 않아요. - 로그인 후 설정 → AI 모델에서 비서·요약·메일의 연결을 Gateway 자동 사용으로 선택해요. 원하는 기능에서 지원되는 Gateway 모델을 고르고, 연결 시험을 직접 실행해요. 시험도 AI 사용량과 비용이 발생할 수 있어요.
- 설정 → 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 코드에는 넣지 않아요. 일반 사용자는 운영 담당자에게 설정을 요청하면 돼요.