도입

`korotovsky/slack-mcp-server`는 Slack 워크스페이스를 MCP 클라이언트와 연결해 주는 Slack용 MCP 서버입니다. Claude Desktop, Cursor 같은 MCP 클라이언트에서 Slack 채널, DM, 스레드 메시지를 조회하거나 검색해야 할 때 활용할 수 있습니다.

특히 팀 대화 기록을 AI 작업 흐름 안으로 가져오고 싶은 경우에 적합합니다. 예를 들어 특정 채널의 최근 논의 내용을 요약하거나, 스레드 답글을 불러오거나, 읽지 않은 메시지를 우선순위별로 확인하는 식으로 사용할 수 있습니다.

왜 좋은가 / 왜 유명한가

- GitHub 검색 결과 기준 별 1.7K개로 표시되는 Slack용 대표 MCP 서버입니다.

- 공식 README에서 “Slack Workspaces를 위한 MCP 서버”로 소개되며, Stdio, SSE, HTTP 전송 방식을 지원한다고 설명합니다.

- Slack 연동 수요가 큰 MCP 분야에서 실제 워크스페이스 연결을 목표로 만든 서버입니다.

- OAuth 모드뿐 아니라 별도 권한이나 봇 설치 없이 동작하는 stealth mode를 지원한다고 README에 명시되어 있습니다.

- DM, Group DM, 채널, 스레드, 검색, 읽지 않은 메시지 조회 등 Slack 실사용에 가까운 기능이 폭넓게 들어 있습니다.

- `best-of-mcp-servers` 계열 목록에서도 별 1.7K개 규모의 서버로 언급되는 등 MCP 서버 큐레이션에서 자주 보이는 자료입니다.

무엇을 할 수 있나 / 무엇이 들어있나

README에서 확인되는 주요 기능은 다음과 같습니다.

- Slack 워크스페이스 연동

- Slack 채널, DM, Group DM의 메시지를 가져올 수 있습니다.

- Enterprise Slack 환경과의 통합 가능성도 언급되어 있습니다.

- 여러 전송 방식 지원

- Stdio

- SSE

- HTTP

- OAuth 모드와 stealth mode

- OAuth 토큰 기반 접근을 지원합니다.

- README 기준으로, 별도 권한이나 봇 설치 없이 동작하는 stealth mode도 지원한다고 설명되어 있습니다.

- 채널과 스레드 조회

- 채널 ID뿐 아니라 `#general` 같은 채널명 형태를 사용할 수 있습니다.

- `@username_dm` 같은 DM 조회 형태도 README의 도구 설명에 포함되어 있습니다.

- 스레드 메시지 조회도 지원합니다.

- Smart History

- 날짜 범위 기반 조회를 지원합니다.

- 예: `1d`, `1w`, `30d`, `90d`

- 메시지 개수 기반 조회도 가능합니다.

- 예: `50`

- 읽지 않은 메시지 처리

- 여러 채널의 읽지 않은 메시지를 효율적으로 가져오는 기능이 소개되어 있습니다.

- 우선순위 정렬 기준으로 DM, 파트너 채널, 내부 채널 순서가 언급되어 있습니다.

- 멘션 필터링과 mark-as-read 지원도 README에 포함되어 있습니다.

- 메시지 검색

- 채널, 스레드, DM에서 메시지를 검색할 수 있습니다.

- 날짜, 사용자, 내용 같은 필터 사용이 가능하다고 설명되어 있습니다.

- 안전한 메시지 작성

- `conversations_add_message` 도구는 안전을 위해 기본 비활성화되어 있습니다.

- 환경 변수로 활성화할 수 있으며, 선택적으로 채널 제한을 둘 수 있다고 README에 적혀 있습니다.

- 사용자 정보 포함

- 메시지에 사용자 정보를 포함해 더 나은 맥락을 제공하는 기능이 있습니다.

- 캐시 지원

- 사용자와 채널 정보를 캐시해 더 빠르게 접근할 수 있습니다.

- 프록시 지원

- 외부 요청을 프록시를 통해 라우팅하도록 설정할 수 있다고 설명되어 있습니다.

설치와 사용법

제공된 README 원문 발췌 범위 안에는 실제 설치 명령, 실행 명령, MCP 클라이언트 설정 블록이 포함되어 있지 않습니다. 따라서 아래 글에서는 원문에서 확인된 도구 사용 방식과 파라미터만 다룹니다. 설치 명령과 클라이언트별 설정은 GitHub 저장소의 최신 README를 직접 확인해 적용해야 합니다.

공식 저장소:

https://github.com/korotovsky/slack-mcp-server

원문에서 확인되는 대표 도구는 `conversations_history`입니다. 이 도구는 채널 또는 DM의 메시지를 가져오는 기능입니다.

Tool: conversations_history

Parameters:
- channel_id: string, required
  - Slack 채널 ID 형식: Cxxxxxxxxxx
  - 또는 채널명: #general
  - 또는 DM 조회명: @username_dm

- include_activity_messages: boolean, default false
  - true이면 channel_join, channel_leave 같은 활동 메시지도 포함

- cursor: string, optional
  - 페이지네이션용 커서
  - 이전 응답의 마지막 행/열에 있는 next_cursor 값을 사용

- limit: string, default "1d"
  - 시간 범위: 1d, 1w, 30d, 90d 등
  - 메시지 개수: 50 등
  - cursor를 제공할 때는 비워야 함

예시 1. `#general` 채널의 최근 하루 메시지 가져오기

{
  "channel_id": "#general",
  "include_activity_messages": false,
  "limit": "1d"
}

이렇게 호출하면 `#general` 채널의 최근 하루 범위 메시지를 가져오는 용도로 사용할 수 있습니다. 활동 메시지까지 보고 싶다면 `include_activity_messages`를 `true`로 바꾸면 됩니다.

{
  "channel_id": "#general",
  "include_activity_messages": true,
  "limit": "1d"
}

예시 2. 특정 DM의 최근 50개 메시지 가져오기

{
  "channel_id": "@username_dm",
  "include_activity_messages": false,
  "limit": "50"
}

README의 파라미터 설명에 따르면 `channel_id`에는 채널 ID뿐 아니라 `#...`, `@...` 형태도 사용할 수 있습니다. 따라서 채널 ID를 매번 복사하지 않고도 이름 기반 조회를 시도할 수 있습니다.

예시 3. 페이지네이션으로 다음 메시지 묶음 가져오기

첫 호출에서 응답 마지막 행/열의 `next_cursor` 값을 확인한 뒤, 다음 호출에 `cursor`로 넣습니다. README 설명상 `cursor`를 제공할 때는 `limit`을 비워야 합니다.

{
  "channel_id": "#general",
  "include_activity_messages": false,
  "cursor": "이전 응답에서 받은 next_cursor 값",
  "limit": ""
}

스레드 조회 도구로는 `conversations_replies`가 README에 언급되어 있습니다. 원문 발췌에는 전체 파라미터가 생략되어 있지만, 설명상 채널 ID와 `thread_ts`를 기준으로 대화 스레드의 메시지를 가져오는 용도입니다.

Tool: conversations_replies

Purpose:
Get a thread of messages posted to a conversation by channelID and thread_ts

MCP 클라이언트에 연결한 뒤에는 다음과 같은 식으로 활용할 수 있습니다.

#general 채널의 최근 하루 메시지를 가져와서 주요 결정사항만 요약해 주세요.

@username_dm의 최근 50개 메시지를 확인하고, 내가 답해야 할 항목을 목록으로 정리해 주세요.

특정 스레드의 답글을 가져와서 논의 흐름과 남은 액션 아이템을 분리해 주세요.

주의할 점

- Slack 데이터는 민감한 업무 정보일 수 있습니다. OAuth 토큰, 세션 정보, 워크스페이스 접근 권한을 설정할 때는 개인 계정보다 조직 보안 정책을 먼저 확인하는 편이 안전합니다.

- `conversations_add_message`는 README 기준 기본 비활성화되어 있습니다. 메시지 작성 기능을 켜는 경우 잘못된 채널에 자동 게시되지 않도록 채널 제한과 승인 절차를 함께 두는 것이 좋습니다.

- 제공된 원문 발췌에는 설치 명령과 구체적인 클라이언트 설정 예시가 포함되어 있지 않습니다. 실제 적용 시에는 저장소의 최신 README에서 Stdio, SSE, HTTP 중 사용할 전송 방식에 맞는 설정을 확인해야 합니다.

출처와 다운로드

GitHub 저장소: https://github.com/korotovsky/slack-mcp-server

Slack 워크스페이스를 MCP 클라이언트와 연결해 채널, DM, 스레드, 검색, 읽지 않은 메시지 조회 등을 사용하려는 분들에게 우선 살펴볼 만한 서버입니다. 하단 첨부파일로도 받을 수 있습니다.