이 글을 따라 하면 Claude Code나 Claude 앱에서 슬랙(Slack) 워크스페이스의 채널 메시지를 읽고, 지난 대화를 검색하고, 최근 논의 내용을 요약받을 수 있게 됩니다. 준비물만 갖춰져 있다면 연결 자체는 10~15분 정도면 끝납니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
MCP(Model Context Protocol) — Claude 같은 AI가 슬랙·깃허브 같은 외부 서비스에 연결해 데이터를 읽고 쓸 수 있게 해주는 공식 규약입니다. Slack은 이 규약에 맞춰 자체 원격 MCP 서버(mcp.slack.com)를 운영하고 있어서, 별도 프로그램을 설치하지 않고도 Claude가 여러분의 워크스페이스에 접근할 수 있습니다.
시작 전 준비물
연결을 시작하기 전에 아래 항목을 먼저 확인하세요. 특히 워크스페이스 관리자 승인은 누락하면 인증 단계에서 막히는 가장 흔한 원인입니다.
- Claude Code로 연결할 경우: Claude Code CLI가 설치되어 있어야 합니다. 터미널에
claude --version을 입력해 버전이 나오는지 확인하세요. - Claude 앱(웹·데스크톱)으로 연결할 경우: claude.ai 계정 로그인 상태면 됩니다.
- 슬랙 워크스페이스에 멤버로 소속되어 있어야 합니다.
- 워크스페이스 관리자의 MCP 통합 승인. 슬랙은 표준 슬랙 앱 승인 절차로 MCP 클라이언트를 관리합니다. 관리자가 미리 승인해두지 않으면 OAuth 인증 자체가 진행되지 않으니, 본인이 관리자가 아니라면 미리 승인을 요청해두세요.
용어 빠른 풀이
- MCP(Model Context Protocol) — Claude가 외부 서비스에 연결해 데이터를 읽고 쓰도록 해주는 공식 연동 규약
- OAuth — 비밀번호를 직접 주고받지 않고, 브라우저로 로그인한 뒤 "허용" 버튼을 눌러 접근 권한만 위임하는 인증 방식
- 플러그인(Plugin) — Claude Code에 MCP 서버 설정과 전용 명령어를 한 번에 설치해주는 패키지
- 마켓플레이스(Marketplace) — 검증된 플러그인을 모아둔 저장소.
@claude-plugins-official은 Anthropic이 공식 운영하는 마켓플레이스를 가리킵니다 - 스코프(Scope) — OAuth 인증에서 "어디까지 허용할지" 범위를 정하는 값(예: 채널 읽기만 허용, 메시지 전송까지 허용 등)
방법 1. Claude Code에 Slack 플러그인 설치하기(추천)
가장 빠른 방법은 Slack이 공식 배포하는 "Slack MCP and Skills Plugin"을 설치하는 것입니다. 이 플러그인은 MCP 서버 연결과 인증까지 자동으로 처리해 줍니다.
- 1단계 · 플러그인 설치. Claude Code 세션 안에서 아래 명령을 실행합니다.
세션 밖 터미널에서 바로 실행하려면/plugin install slack@claude-plugins-officialclaude plugin install slack@claude-plugins-official형태를 사용합니다(정확한 표시 문구는 버전에 따라 다를 수 있으니 화면 안내를 따르세요).
이렇게 보이면 성공: 설치 완료 메시지와 함께 슬랙 MCP 서버가 자동으로 설정되었다는 안내가 표시됩니다. - 2단계 · 브라우저 로그인. 플러그인이 로드되면 슬랙 워크스페이스에 로그인하라는 안내와 함께 브라우저 창이 자동으로 열립니다. 워크스페이스 계정으로 로그인하세요.
주의: 이 시점에 워크스페이스 관리자가 MCP 통합을 사전에 승인해두지 않았다면 로그인 후에도 인증이 진행되지 않습니다. - 3단계 · 권한 승인. 브라우저에 뜨는 권한 요청 화면에서 허용 버튼을 눌러 Claude가 요청하는 스코프(채널 읽기, 검색 등)에 접근하도록 승인합니다.
- 4단계 · 연결 확인. Claude Code로 돌아와 아래 명령을 실행합니다.
이렇게 보이면 성공: 목록에서 slack 서버 옆에 ✔ Connected가 표시됩니다. ! Needs authentication이 보이면 아직 로그인이 끝나지 않은 것입니다./mcp
방법 2. 수동으로 MCP 서버 추가하기
플러그인을 쓰지 않고 직접 서버를 등록하려면, 또는 스코프를 세밀하게 제어하고 싶다면 claude mcp add 명령으로 Slack의 원격 MCP 엔드포인트를 직접 추가할 수 있습니다.
claude mcp add --transport http slack https://mcp.slack.com/mcp명령을 실행하면 Added ... 메시지가 뜨며 설정이 저장됩니다. 이어서 /mcp를 실행해 같은 방식으로 로그인·권한 승인을 진행하면 됩니다. 프로젝트 전체와 설정을 공유하고 싶다면 --scope project를, 이 컴퓨터의 모든 프로젝트에서 쓰고 싶다면 --scope user를 덧붙이세요.
Claude 앱(웹·데스크톱)에서 연결하기
Claude Code를 쓰지 않는다면 Claude 앱의 커넥터 기능으로도 슬랙을 연결할 수 있습니다. 사이드바에서 Customize 페이지로 들어가 Connectors를 클릭하고, + 버튼으로 Slack을 찾아 추가한 뒤 OAuth 인증을 완료하면 됩니다. 조직(Team·Enterprise) 계정에서는 관리자만 커넥터를 추가할 수 있고, 개인 계정 요금제별 이용 가능 여부는 화면에서 최종 확인하는 것이 안전합니다.
최소 권한으로 연결하기(보안)
필요한 권한만 부여하는 것이 안전합니다. 채널을 읽고 검색만 하면 되는데 메시지 전송 권한(chat:write)까지 부여하면, Claude가 실수로든 프롬프트 인젝션 공격으로든 워크스페이스에 메시지를 보낼 위험이 생깁니다.
| 목적 | 필요한 스코프 예시 |
|---|---|
| 채널 검색·읽기만 허용(최소 구성) | channels:read, search:read |
| 메시지 전송까지 허용 | 위 항목 + chat:write |
| 캔버스(공유 문서) 읽기 | canvases:read |
| 사용자 정보 조회 | users:read |
프로젝트의 .mcp.json 파일에 아래처럼 oauth.scopes 값을 직접 지정하면, 슬랙이 기본으로 허용하는 범위보다 좁게 권한을 제한할 수 있습니다.
{
"mcpServers": {
"slack": {
"type": "http",
"url": "https://mcp.slack.com/mcp",
"oauth": {
"scopes": "channels:read chat:write search:read"
}
}
}
}자주 막히는 지점 & 해결
대부분의 연결 문제는 /mcp 화면의 상태 표시만 보면 원인을 알 수 있습니다.
| 화면에 뜨는 상태 | 원인 | 해결 |
|---|---|---|
| ! Needs authentication | 아직 로그인을 마치지 않음 | /mcp 실행 후 브라우저에서 로그인 완료 |
| 로그인해도 인증이 끝나지 않음 | 워크스페이스 관리자가 MCP 통합을 승인하지 않음 | 관리자에게 Slack 앱(MCP 클라이언트) 승인을 요청 |
| ⏸ Pending approval | 프로젝트 범위(.mcp.json)로 추가한 서버가 아직 개인 승인 대기 상태 | 터미널에서 claude를 인터랙티브로 실행해 승인 |
| ✘ Failed to connect | 네트워크 문제 또는 설정 오류 | 잠시 후 재시도, 계속되면 claude mcp get slack으로 설정 확인 |
응용 · 다음 단계
연결이 끝나면 자연어로 바로 요청할 수 있습니다. 예를 들어 "지난주 제품 출시 관련 논의를 찾아줘", "#general 채널 최근 대화를 요약해줘" 같은 문장이면 충분합니다. 이 플러그인은 아래와 같은 전용 슬래시 명령어도 함께 제공합니다.
/slack:summarize-channel— 채널 대화 요약/slack:find-discussions— 특정 주제의 논의 찾기/slack:draft-announcement— 공지 메시지 초안 작성/slack:standup— 스탠드업 정리/slack:channel-digest— 채널 다이제스트 생성
usingclaude.com에 실린 다른 MCP 서버 추천·연결 가이드도 함께 참고하면 워크스페이스 밖의 도구(이슈 트래커, 데이터베이스 등)까지 Claude와 연결하는 범위를 넓힐 수 있습니다.
자주 묻는 질문
Q. 반드시 워크스페이스 관리자의 승인이 필요한가요?
네, 필요합니다. 슬랙은 표준 슬랙 앱 승인 절차로 MCP 클라이언트를 관리하기 때문에, 관리자가 사전에 승인하지 않으면 OAuth 인증 자체가 진행되지 않습니다.
Q. Claude Code 없이 Claude 웹·데스크톱 앱에서도 슬랙을 연결할 수 있나요?
가능합니다. 사이드바의 Customize → Connectors 메뉴에서 Slack을 추가하고 OAuth 인증을 완료하면 됩니다. 다만 조직 계정은 관리자만 추가할 수 있습니다.
Q. 메시지를 읽기만 하고 싶은데 전송 권한까지 부여해야 하나요?
아닙니다. .mcp.json의 oauth.scopes 값을 channels:read search:read처럼 원하는 범위로 좁혀서 최소 권한으로 연결할 수 있습니다.
Q. 연결이 잘 됐는지 어떻게 확인하나요?
Claude Code에서 /mcp를 실행해 확인합니다. 서버 이름 옆에 ✔ Connected가 표시되면 정상 연결된 것이고, ! Needs authentication이면 로그인이 더 필요하다는 뜻입니다.