yt-slack-mcp

Slack용 MCP 서버 — permalink, 스레드, 채널 기록 읽기; 스레드에 답글 달기; 리액션 추가하기.

Model Context Protocol 사양을 구현합니다: stdio 전송으로 실행되며, JSON-RPC 2.0을 사용하고, initialize에서 프로토콜 버전을 협상하며, tools 기능을 광고하고, 각 도구를 JSON Schema로 설명합니다. 프로토콜 버전 협상은 @modelcontextprotocol/sdk의 Server 클래스가 처리하며, 기본값은 최신 지원 버전입니다.

도구

읽기 도구는 비공개 Slack 브라우저 세션 API(xoxc / xoxd 토큰)를 사용하므로 비공개 파일 내용을 가져올 수 있습니다 — PDF는 다운로드되어 텍스트로 추출되고(최대 50페이지 / 100k자), 이미지는 인라인으로 반환됩니다.

Related MCP server: Slack MCP Server

설정

1. 브라우저 세션 토큰 얻기

• xoxc: Slack 웹 localStorage 토큰 (로그인된 브라우저 세션에서).

• xoxd: d라는 이름의 Slack 쿠키.

Slack이 세션을 회전/무효화할 때 이 토큰들을 새로 고쳐야 할 수 있습니다.

2. 비밀 파일 배치

각 토큰을 한 줄짜리 파일로 저장하세요:

~/.config/opencode/secrets/slack-xoxc.txt
~/.config/opencode/secrets/slack-xoxd.txt

또는 구성 파일이나 환경 변수로 경로를 재정의할 수 있습니다.

3. (선택 사항) 허용된 쓰기 채널 및 경로 구성

모든 구성은 ~/.config/yt-slack-mcp/config.json의 JSON 구성 파일에 넣을 수 있습니다 (SLACK_MCP_CONFIG로 재정의 가능):

{
  "secretsDir": "~/.config/opencode/secrets",
  "xoxcPath": "~/.config/opencode/secrets/slack-xoxc.txt",
  "xoxdPath": "~/.config/opencode/secrets/slack-xoxd.txt",
  "allowedWriteChannels": ["C0123456789", "C0987654321"],
  "userAgent": "Mozilla/5.0"
}

기본적으로 쓰기 도구(slack_reply_to_thread, slack_add_reaction)는 잠겨 있습니다 — 어떤 채널도 쓰기 가능하지 않습니다. 모든 필드는 선택 사항이며, 파일이 없으면 기본값을 의미합니다. 환경 변수는 항상 구성 파일보다 우선합니다.

구성

구성 해석 순서: 내장 기본값 → 구성 파일 → 환경 변수.

MCP 호스트 구성

opencode

{
  "mcp": {
    "slack": {
      "type": "local",
      "command": ["npx", "yt-slack-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["yt-slack-mcp"]
    }
  }
}

라이선스

MIT