웍스AI·외부 앱
Naver Works 앱 등록
Naver Works 툴킷을 쓰기 위해 개발자 콘솔에 앱을 등록하는 순서입니다.
1. 개발자 콘솔 접속
- https://developers.worksmobile.com 접속
- Naver Works 관리자 계정 로그인
- 좌측 메뉴 → '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 플랜)