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. Bot Token Scope 추가
같은 화면 하단 'Scopes' → Bot Token Scopes 에 필요한 권한을 추가합니다. 바로 아래 'User Token Scopes' 가 아니라 Bot Token Scopes 입니다 — 두 칸이 붙어 있어 헷갈리기 쉽습니다.
chat:write— 메시지 발송channels:read— 공개 채널 목록 · 정보 조회channels:history— 공개 채널 메시지 조회groups:read— 프라이빗 채널 조회im:read— DM 조회users:read— 사용자 목록 조회users:read.email— 사용자 이메일 조회files:write— 파일 업로드reactions:write— 이모지 리액션
이 앱은 워크스페이스 단위로 동작합니다. 봇이 볼 수 있는 것만 AI 도 볼 수 있고, 질문한 사람의 개인 권한과는 다릅니다. 봇을 채널에 초대해야 그 채널이 보입니다.
검색은 빠져 있습니다. Slack 이 메시지 검색(search:read)을 봇에게 허용하지 않습니다.
개인 권한으로 검색까지 필요하시면 알려주세요 — 별도 방식으로 준비합니다.
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
- 주의: 이 앱은 Bot Token (
xoxb-*) 으로 동작합니다. 봇이 초대되지 않은 채널은 목록에도 메시지에도 나오지 않습니다 — AI 가 "채널이 없다" 고 답하면 대개 봇 초대가 빠진 것입니다.