1. Slack API 콘솔 접속
- https://api.slack.com/apps 접속
- Slack 워크스페이스 관리자 계정으로 로그인
- Create New App → From scratch 선택
2. 앱 정보 입력
- App Name: 예) "MCP Hub Integration"
- Pick a workspace: 앱을 설치할 워크스페이스 선택
- 생성 후 좌측 메뉴에서 'Basic Information' 확인
3. Redirect URL 등록
- 좌측 메뉴 → OAuth & Permissions
- 'Redirect URLs' 섹션에
https://mcp-hub.wrks.ai/oauth/callback추가 → Save URLs
4. User Token Scope 추가
같은 화면 하단 'Scopes' → User Token Scopes 에 필요한 scope 추가 (Bot Token 이 아니라 User Token — 호출자 개인 권한으로 동작해야 하기 때문):
chat:write— 메시지 발송channels:read— 공개 채널 목록 · 정보 조회channels:history— 공개 채널 메시지 조회groups:read— 프라이빗 채널 조회im:read— DM 조회users:read— 사용자 목록 조회users:read.email— 사용자 이메일 조회files:write— 파일 업로드search:read— 메시지 검색reactions:write— 이모지 리액션
5. 자격 정보 발급
- 좌측 메뉴 → Basic Information → 'App Credentials'
- Client ID · Client Secret 확인
- Studio → Toolkits → New → 'Slack' 템플릿 선택 → OAuth 설정 화면에 입력
6. 배포 설정 (여러 워크스페이스 지원 시)
- 좌측 메뉴 → Manage Distribution
- 'Remove Hard Coded Information' 체크리스트 확인 후 Activate Public Distribution
- (단일 워크스페이스 전용이면 이 단계 생략 가능)
참고
- Scope 전체 목록: https://api.slack.com/scopes
- 주의: User Token (
xoxp-*) 은 호출자 개인 권한으로 동작함. 관리자 권한이 없는 사용자가 관리자 scope 를 요청하면 승인 자체는 되지만 실제 API 호출 시 권한 부족 오류 발생.