@wbjeong/slack-max-api-mcp
v1.0.0
Published
Slack MCP server (stdio) for Codex and Claude Code
Downloads
55
Readme
Slack Max API MCP Server
Slack Web API를 최대한 활용하도록 만든 stdio MCP 서버입니다.Codex CLI와 Claude Code에 바로 연결할 수 있습니다.
포함 범위
- 고정 도구 12개
search_messages_filessearch_userssearch_channelssend_messageread_channelread_threadcreate_canvasupdate_canvasread_canvasread_user_profileslack_api_call(임의 Web API 메서드 호출)slack_http_api_call(SCIM/Audit/Legal Holds 포함 범용 HTTP 호출)
- 카탈로그 기반 메서드 도구 자동 등록
data/slack-catalog.json의 Web API 메서드(현재 304개)를 자동 MCP 도구로 등록- 도구명 형식:
slack_method_<method_name>- 예:
chat.postMessage->slack_method_chat_postMessage
- 예:
- 문서 자동 생성
- SLACK_API_FUNCTIONS_KR.md
- 메서드별 기능 설명(공식 설명 + 한국어 재표현)
- scope 목록, family 요약 포함
준비
- Node.js 20+
- Slack 토큰
- 기본:
xoxbbot token - 필요시
xoxpuser token 병행 - Admin/SCIM/Audit API는 별도 권한/토큰 필요
- 토큰은 기본적으로 프로젝트 루트의
.env.example에서 자동 로드됨
설치/생성/실행
npm install
npm run build:catalog
npm run startCodex CLI 연결
codex mcp add slack-max -- node C:\code_test\test22\src\slack-mcp-server.js확인:
codex mcp list
codex mcp get slack-maxClaude Code 연결
claude mcp add slack-max -- node C:\code_test\test22\src\slack-mcp-server.js확인:
claude mcp list
claude mcp get slack-max메서드 도구 제어용 환경변수
SLACK_CATALOG_PATH
카탈로그 JSON 경로 (기본:data/slack-catalog.json)SLACK_ENABLE_METHOD_TOOLSfalse면 자동 메서드 도구 등록 비활성화SLACK_METHOD_TOOL_PREFIX
자동 도구명 prefix (기본:slack_method)SLACK_MAX_METHOD_TOOLS
0이면 전체 등록, 양수면 앞에서 N개만 등록
권장 scope (현재 고정 도구 10개 기준 최대 사용)
chat.writechannels.read,groups.read,im.read,mpim.readchannels.history,groups.history,im.history,mpim.historyusers.read,users.profile.read,users.read.emailcanvases.read,canvases.writesearch.read
참고: 전체 Slack API 100%는 단일 토큰으로 불가하며, Admin/SCIM/Audit/Legal Holds는 조직/권한 제약이 있습니다.
