Slack MCP

세션 토큰을 사용하여 AI 에이전트가 Slack 워크스페이스에 접근할 수 있게 해주는 MCP 서버입니다. OAuth 앱, 봇 권한, 관리자 승인이 필요하지 않습니다.

작동 방식

Slack MCP는 기존 브라우저 세션 토큰(xoxc/xoxd)을 사용하여 사용자를 대신해 Slack과 상호작용합니다. 기본적으로 은밀하게 읽기만 수행하며, mark-read 도구만 읽음 확인을 트리거합니다. 그 외 모든 작업은 다른 사용자에게 보이지 않습니다.

토큰 추출은 바이너리에 내장되어 있습니다. Chrome 또는 Firefox에서 Slack에 로그인한 상태라면 설정 흐름이 자동으로 토큰을 추출할 수 있습니다. DevTools에서 복사하여 붙여넣을 필요가 없습니다.

Related MCP server: slack-mpm

사전 요구 사항

브라우저에 활성 Slack 세션이 필요합니다. 설정을 실행하기 전에 Chrome, Chromium, Edge 또는 Firefox에서 app.slack.com에 로그인하세요.

설치

Claude Code

claude mcp add slack-mcp -- npx -y @aaronsb/slack-mcp

그런 다음 Claude에게 auth-setup 도구를 실행하도록 요청하세요. 브라우저 선택, 프로필 선택 및 자동 토큰 추출 과정을 안내합니다.

Claude Desktop

최신 릴리스에서 플랫폼에 맞는 .mcpb 파일을 다운로드하세요:

파일을 열거나(더블 클릭 또는 Claude Desktop으로 드래그) 토큰을 묻는 메시지가 표시되면 다음 중 하나를 선택할 수 있습니다:

• 비워두고 연결 후 auth-setup 도구 사용

• 이미 토큰이 있는 경우 붙여넣기

독립 실행형 바이너리

릴리스에서 플랫폼에 맞는 바이너리를 다운로드한 후:

# Extract tokens from your browser (interactive)
./slack-mcp setup

# Run as MCP server (stdio, default)
./slack-mcp

# Run as MCP server (SSE, for remote/shared access)
./slack-mcp --transport sse

npm (전역)

npm install -g @aaronsb/slack-mcp
slack-mcp setup

토큰 설정

가장 쉬운 방법부터 수동 방법까지 Slack 토큰을 얻는 세 가지 방법이 있습니다:

자동 (Chrome/Edge)

auth-setup MCP 도구 또는 slack-mcp setup CLI 명령은 다음을 수행합니다:

1. 설치된 브라우저 감지

2. Slack이 있는 브라우저와 프로필 선택

3. 브라우저를 열고 Slack으로 이동한 후 Chrome DevTools Protocol을 통해 토큰 추출

4. 토큰 검증 및 저장

추출 전에 Chrome을 완전히 종료해야 합니다. 다시 열면 탭이 복원됩니다.

반자동 (Firefox)

설정 흐름은 임시 브라우저 확장 프로그램을 임시 디렉토리에 작성한 후, about:debugging을 통해 Firefox에서 로드하도록 안내합니다. 확장 프로그램은 토큰을 추출하여 로컬 콜백 서버로 전송합니다. Firefox가 닫히면 자동으로 제거됩니다.

수동

slack-mcp setup을 실행하거나 auth-setup 도구를 사용하세요. 브라우저가 감지되지 않거나 자동 추출이 실패하면 단계별 DevTools 지침이 포함된 localhost 웹 페이지로 대체됩니다.

환경 변수를 통해 직접 토큰을 설정할 수도 있습니다:

export SLACK_MCP_XOXC_TOKEN="xoxc-..."
export SLACK_MCP_XOXD_TOKEN="xoxd-..."
./slack-mcp

도구

개인정보 보호

• 기본적으로 은밀함 — 읽기는 절대 읽음 확인을 트리거하지 않으며, mark-read만 수행합니다

• 채널 이름, ID 아님 — AI는 내부 Slack 식별자를 볼 수 없습니다

• 토큰은 로컬에 유지 — 0600 권한으로 ~/.config/slack-mcp/config.json에 저장됩니다

• Slack 외부 네트워크 트래픽 없음 — 바이너리는 slack.com/api/*에만 연결합니다

• 브라우저 다운로드 없음 — 설치된 브라우저를 사용하며, CDN에서 바이너리를 가져오지 않습니다

개발

make build          # Build for current platform
make test           # Run tests
make build-all-platforms  # Cross-compile (6 platforms)
make release TAG=v1.3.0   # Tag and push (CI handles the rest)

라이선스

MIT