# Naver Works OAuth 앱 등록 가이드

## 1. 개발자 콘솔 접속

1. https://developers.worksmobile.com 접속
2. Naver Works 관리자 계정 로그인
3. 좌측 메뉴 → 'App' → '앱 등록'

## 2. 앱 정보 입력

- **앱 이름**: 예) "MCP Hub Integration"
- **아이콘**: 128×128 PNG 업로드
- **설명**: 사내 AI 에이전트가 Naver Works 를 도구로 사용

## 3. OAuth 2.0 설정

- **Redirect URI**: `https://mcp-hub.wrks.ai/oauth/callback` 등록 (최대 100개까지 화이트리스트)
- **Grant Type**: Authorization Code (기본)

## 4. Scope 선택

필요한 API 별로 체크:

- `user.read` — 사용자 프로필
- `calendar` — 캘린더 조회 · 이벤트 생성
- `mail` — 메일 조회 · 발송 (유료 플랜)
- `drive` — 파일 관리 (유료 플랜)
- `bot` — Bot 메시지 발송
- `task` — Task 관리
- `directory.read` — 조직 · 사용자 조회

## 5. 자격 정보 발급

- 등록 완료 후 **Client ID** · **Client Secret** 확인
- Studio → Toolkits → New → 'Naver Works' 템플릿 선택
- OAuth 설정 화면에 Client ID · Client Secret 입력

## 6. 워크스페이스 관리자 승인 (선택)

조직 정책에 따라 서비스 사용 승인 필요할 수 있음. 관리자 콘솔 → '외부 앱' → 승인.

## 참고

- 공식 문서: https://developers.worksmobile.com/kr/docs/auth
- API 카테고리: https://developers.worksmobile.com/kr/docs/api
- Rate limit: 240 req/min (Lite/Standard/Standard Plus 플랜)