문서/인증·보안/Naver Works OAuth 앱 등록
GUIDE관리자oauth-provider-setup/naver-works.md·읽는 시간 약 3

Naver Works OAuth 앱 등록

Naver Works 툴킷 사용을 위한 개발자 콘솔 앱 등록 절차.

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. 워크스페이스 관리자 승인 (선택)

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

참고