Slack 요약봇 MCP 서버
100줄로 만드는 재사용 툴

Session 6 · 재사용 가능한 Slack 요약봇 MCP 서버

FastMCP · Inspector · Slack Bolt · Anthropic Python SDK · claude mcp add

강사 박수현 · 🚀 젠아이랩스(GenAI Labs)

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing a terminal window on the left labeled 'Claude Code' and a Slack channel UI on the right labeled 'Slack'. Between them sits a small server box with a Python snake emblem labeled 'MCP Server'. Two-way arrows flow between the terminal and the server, and between the server and the Slack UI. Clean editorial illustration style, warm orange gradient accents with teal #00b894 and purple #6c5ce7 highlights, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

PART 1

MCP 개념 — 왜 필요한가 · 3요소 · 관계

완성본 데모 · 표준 프로토콜의 등장 · Tool / Resource / Prompt · 클라이언트-서버 프로세스 관계.

세션 목표 — 세 가지가 한꺼번에 돌아간다

이 세션이 끝나면 참여자 노트북에서 다음 세 가지가 한꺼번에 돌아간다.

MCP 가 왜 필요한가 — 같은 통합을 N번 짜던 시대의 종결

LLM 이 나온 뒤 2년 동안 사람들은 같은 문제를 반복해 풀었다. "이 챗봇이 내 슬랙·노션·지라·GitHub 를 다 알면 좋겠다." 그런데 챗봇마다 통합 방식이 다 달랐다.

📌 세 가지 관찰

• HTTP + JSON-RPC 2.0 기반 — 새 프로토콜을 익힐 필요가 없다. 요청·응답 스키마가 명확하다.
• 오픈 스펙·오픈 SDK — 파이썬·타입스크립트 SDK 가 공식으로 나와 있다. 라이선스 MIT.
• Linux Foundation 산하로 이관 (2025) — 특정 벤더의 폐쇄 프로토콜이 아니다. 월 다운로드 9,700만 회 (Anthropic 공식 발표 기준).

📖 출처 · Wikipedia "Model Context Protocol" (en.wikipedia.org/wiki/Model_Context_Protocol) · Anthropic News "Introducing the Model Context Protocol" (anthropic.com/news/model-context-protocol)

MCP 3요소 — Tool · Resource · Prompt

MCP 서버가 클라이언트에 노출하는 것은 정확히 세 가지다. 성격 차이를 처음부터 잡아 두면 서버 설계가 명료해진다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing a server box in the center with three glowing outlets labeled 'Tool', 'Resource', 'Prompt'. From each outlet a thin luminous line flows out to a client silhouette on the right. The 'Tool' outlet is emphasized with a warm orange highlight, the others are dimmer. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

클라이언트 ↔ 서버 관계 — 프로세스 · 프로토콜 · 인증

클라이언트 — 사용자가 대화하는 AI 도구. Claude Code · Codex · Cursor · Windsurf. 서버 — 참여자가 이 세션에서 만드는 것.

PART 2

mcp SDK 기초 — 설치·스캐폴드·Inspector·등록

pip install "mcp[cli]" · FastMCP 뼈대 · MCP Inspector · claude mcp add · 첫 자연어 호출.

설치 · 첫 서버 스캐폴드 — mcp[cli] + FastMCP

파이썬 SDK 는 mcp 라는 이름으로 PyPI 에 올라와 있다. 설치는 한 줄이다.

pip install "mcp[cli]"

[cli] extra 를 붙이면 로컬에서 서버를 띄워 테스트할 수 있는 mcp 커맨드가 함께 깔린다. 강의에서 이 커맨드를 몇 번 쓴다.

뼈대 파일 server.py.

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("slack-summary")

@mcp.tool()
def hello(name: str) -> str:
    """이름을 받아 인사말을 돌려준다."""
    return f"안녕하세요, {name}님."

if __name__ == "__main__":
    mcp.run()

로컬 인스펙터로 확인 — mcp dev server.py

Claude Code 에 붙이기 전에, 서버가 제대로 뜨는지 확인하는 게 먼저다. SDK 가 붙여 주는 MCP Inspector 를 쓴다.

mcp dev server.py

이 명령은 서버를 띄우고 브라우저에서 인스펙터 UI 를 연다. 왼쪽 패널에서 등록된 Tool 목록이 보이고, 오른쪽에서 파라미터를 넣어 호출해 결과를 확인할 수 있다.

Claude Code 에 등록 — claude mcp add

Claude Code 에 MCP 서버를 붙이는 명령은 하나다.

claude mcp add slack-summary -- python /absolute/path/to/server.py

claude mcp list

첫 호출 — Claude Code 에서 hello

Claude Code 를 새로 띄운다. /mcp 로 서버가 잡혔는지 확인. 그리고 자연어로 물어본다.

"hello 툴로 '홍길동' 이라는 이름 넣어서 불러줘"

Claude 는 이 문장을 보고 mcp__slack-summary__hello({name: "홍길동"}) 로 변환해 호출한다. 결과가 대화창에 뜬다. "안녕하세요, 홍길동님."

툴 이름 규칙. mcp__ 접두어 + 서버명 + __ + 툴명. 이 세션에서는 서버명이 slack-summary, 툴명이 hello 라 mcp__slack-summary__hello 가 된다.

PART 3

Slack Bolt 통합 — 앱·히스토리·매퍼·정규화

슬랙 앱 만들기 6단계 · conversations.history · 채널명 → ID 매퍼 · 메시지 → 대화 텍스트.

슬랙 앱 만들기 — 6단계 절차

슬랙 워크스페이스에 API 로 접근하려면 먼저 봇 앱 을 만들고 토큰을 받아야 한다.

export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_SIGNING_SECRET="..."

slack-bolt · conversations.history

파이썬으로 슬랙 API 를 다루는 공식 SDK 는 slack-bolt. Anthropic 이 아니라 슬랙 공식 프로젝트.

pip install slack-bolt

slack-bolt 의 App 은 웹서버 스타일(이벤트 수신) 로도 쓰지만, 이 세션에서는 app.client 만 쓴다. 슬랙 REST API 를 감싼 클라이언트.

핵심 메서드 conversations.history.

from slack_bolt import App
import os

app = App(
    token=os.environ["SLACK_BOT_TOKEN"],
    signing_secret=os.environ["SLACK_SIGNING_SECRET"],
)

result = app.client.conversations_history(
    channel="C0123456789",
    limit=200,
    oldest="1735689600",   # UNIX epoch (2025-01-01 UTC). 이 시각 이후 메시지만.
)

for msg in result["messages"]:
    print(msg["user"], msg["text"])

채널명 → ID 매퍼 — resolve_channel_id

사용자는 #eng 라고 자연어로 부르지 채널 ID 를 외우지 않는다. 이름을 ID 로 바꾸는 헬퍼를 하나 만든다.

def resolve_channel_id(app: App, channel_name: str) -> str:
    """채널 이름(#eng 또는 eng) 을 채널 ID (C0123...) 로 변환."""
    name = channel_name.lstrip("#")
    cursor = None
    while True:
        resp = app.client.conversations_list(
            types="public_channel",
            limit=200,
            cursor=cursor,
        )
        for ch in resp["channels"]:
            if ch["name"] == name:
                return ch["id"]
        cursor = resp.get("response_metadata", {}).get("next_cursor")
        if not cursor:
            break
    raise ValueError(f"채널 '{channel_name}' 을 찾지 못했다.")

메시지 → 대화 텍스트 — format_history

conversations.history 가 돌려주는 messages 는 슬랙 형식 그대로다. user 필드는 사용자 ID (U0...) 이고, text 는 멘션이 <@U0...> 형태로 남아 있다. LLM 에 넣기 전에 사람이 읽는 형태로 다듬는다.

from datetime import datetime

def format_history(app: App, messages: list) -> str:
    """슬랙 메시지 리스트를 요약용 텍스트로 변환."""
    user_cache = {}
    lines = []
    for msg in reversed(messages):  # 슬랙은 최신순 → 시간순으로 뒤집기
        if msg.get("subtype") == "bot_message":
            continue  # 봇 메시지는 요약에서 제외
        user_id = msg.get("user")
        if not user_id:
            continue
        if user_id not in user_cache:
            info = app.client.users_info(user=user_id)
            user_cache[user_id] = info["user"]["real_name"] or info["user"]["name"]
        name = user_cache[user_id]
        ts = datetime.fromtimestamp(float(msg["ts"]))
        text = msg.get("text", "").strip()
        lines.append(f"[{ts:%H:%M}] {name}: {text}")
    return "\n".join(lines)

PART 4

채널 요약 툴 조립 — 프롬프트·Anthropic·Tool 정의

요약 프롬프트 카드 · Anthropic API 호출 · summarize_channel Tool 정의 · 완성본 서버 실행.

요약 프롬프트 카드 — SUMMARIZE_PROMPT

format_history 결과를 Anthropic API 로 넘겨 요약을 받는다. 프롬프트가 이 툴의 품질을 결정한다.

SUMMARIZE_PROMPT = """다음은 슬랙 채널 '{channel}' 의 지난 {hours} 시간 대화다.

--- 대화 시작 ---
{conversation}
--- 대화 끝 ---

다음 4가지를 JSON 으로 반환한다. 코드블록 없이 JSON 만.

{{
  "summary": "3~5문장 요약",
  "participants": ["대화 참여자 이름 배열"],
  "decisions": ["핵심 결정 사항 배열. 없으면 빈 배열"],
  "open_questions": ["미해결 질문 배열. 없으면 빈 배열"]
}}

한국어로 답한다. 대화가 너무 짧아 요약할 게 없으면 summary 필드에 '요약할 대화 부족' 이라고만 쓴다."""

Anthropic API 호출 — summarize 함수

Anthropic Python SDK 로 요약을 뽑는다.

import os, json
from anthropic import Anthropic

anthropic = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

def summarize(channel: str, hours: int, conversation: str) -> dict:
    """대화 텍스트를 받아 요약 JSON 을 반환."""
    if not conversation.strip():
        return {"summary": "요약할 대화 부족",
                "participants": [], "decisions": [], "open_questions": []}
    prompt = SUMMARIZE_PROMPT.format(
        channel=channel, hours=hours, conversation=conversation)
    resp = anthropic.messages.create(
        model="claude-opus-4-8",
        max_tokens=2000,
        messages=[{"role": "user", "content": prompt}],
    )
    return json.loads(resp.content[0].text.strip())

summarize_channel 툴 정의 — 세 조각을 한 툴로

앞의 세 조각 — 채널 ID 매퍼 · 히스토리 포매터 · 요약기 — 을 한 툴로 묶는다.

from datetime import datetime, timedelta, timezone

@mcp.tool()
def summarize_channel(
    channel_name: str,
    lookback_hours: int = 24,
) -> dict:
    """슬랙 채널 지난 N 시간 대화 요약.
    Returns summary·participants·
    decisions·open_questions dict."""
    channel_id = resolve_channel_id(
        app, channel_name)
    oldest = (datetime.now(timezone.utc)
        - timedelta(hours=lookback_hours)
    ).timestamp()
    resp = app.client.conversations_history(
        channel=channel_id, limit=200,
        oldest=str(oldest))
    conversation = format_history(
        app, resp["messages"])
    return summarize(channel_name,
        lookback_hours, conversation)

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing three small function blocks stacked vertically on the left, labeled 'resolve_channel_id', 'format_history', 'summarize'. A thick teal arrow flows from all three into a single big block on the right labeled 'summarize_channel'. From the big block a warm orange arrow flows out labeled 'MCP Tool'. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

완성본 · server.py 조립도

전체 server.py 는 다음처럼 정리된다. 이전 슬라이드의 조각들이 순서대로 들어간다.

"""Slack 채널 요약 MCP 서버."""
import os, json
from datetime import datetime, timedelta, timezone
from mcp.server.fastmcp import FastMCP
from slack_bolt import App
from anthropic import Anthropic

mcp = FastMCP("slack-summary")
app = App(
    token=os.environ["SLACK_BOT_TOKEN"],
    signing_secret=os.environ["SLACK_SIGNING_SECRET"],
)
anthropic = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
SUMMARIZE_PROMPT = """..."""  # 프롬프트 카드 원문 그대로

def resolve_channel_id(app, channel_name): ...   # 채널명 → ID
def format_history(app, messages): ...           # 메시지 → 대화 텍스트
def summarize(channel, hours, conversation): ... # Anthropic 호출

@mcp.tool()
def summarize_channel(channel_name: str, lookback_hours: int = 24) -> dict:
    """..."""  # 앞 슬라이드 본체 그대로

if __name__ == "__main__":
    mcp.run()

실행 시퀀스 — 환경변수 → 인스펙터 → 실 채널

환경 변수 3개 + mcp dev 한 줄로 서버가 뜬다.

export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_SIGNING_SECRET="..."
export ANTHROPIC_API_KEY="sk-ant-..."

mcp dev server.py    # 인스펙터로 먼저 확인

PART 5

Claude Code 실사용 — 등록·시나리오·트러블·로그

--env 로 3키 주입 · 실전 시나리오 3종 · 자주 걸리는 오류 4종 · stderr 로그 규약.

등록 · 재시작 — 환경 변수 3개를 함께 담는다

인스펙터에서 검증이 끝났다면 Claude Code 에 붙일 차례다. 환경 변수 3개를 등록 명령에 함께 담는다.

claude mcp add slack-summary \
  --env SLACK_BOT_TOKEN=xoxb-... \
  --env SLACK_SIGNING_SECRET=... \
  --env ANTHROPIC_API_KEY=sk-ant-... \
  -- python /absolute/path/to/server.py

등록 확인.

claude mcp list
# slack-summary  running  1 tool

Claude Code 를 새 창으로 띄우고 /mcp 를 친다. slack-summary 서버가 connected 상태로 뜨고, 그 아래 summarize_channel 툴이 있으면 준비 완료.

실전 시나리오 3종 — 기본 요약 · 시간 범위 · 병렬 호출

Claude Code 대화창에서 실제로 써 본다.

지난 24시간 #general 요약해줘

#eng 지난 6시간 논의 정리하고
오픈 이슈만 뽑아줘

#eng #product #design 세 채널
지난 12시간 요약해서 부서별로 정리해줘

트러블슈팅 — 자주 걸리는 오류 4종

현장에서 실제로 걸리는 함정들을 미리 짚어 둔다.

로그·디버깅 — stdout 은 JSON-RPC 전용

MCP 서버는 stdio 로 클라이언트와 대화하므로, print() 로 로그를 남기면 프로토콜을 오염시킨다. stderr 나 파일로 뽑아야 한다.

import logging, sys
logging.basicConfig(
    level=logging.INFO, stream=sys.stderr,
    format="%(asctime)s [%(levelname)s] %(message)s",
)
log = logging.getLogger("slack-summary")

@mcp.tool()
def summarize_channel(channel_name: str, lookback_hours: int = 24) -> dict:
    log.info("called: %s / %dh", channel_name, lookback_hours)
    ...

PART 6

정리 · 확장 — 만든 것 · 재사용 · 확장 5선

100줄로 얻은 세 자산 · 재사용 지점 · 같은 뼈대로 만들 수 있는 서버 5종.

만든 것 · 얻은 것 — 100줄이 준 세 자산

만든 것은 server.py 한 파일이다. 실제 코드 라인은 100줄 남짓. 그 100줄로 다음 세 가지를 한꺼번에 얻는다.

📌 재사용 지점 4가지

확장 아이디어 5선 — 같은 뼈대에서 방향만

같은 뼈대에서 방향만 바꾸면 만들 수 있는 서버 목록이다.

마무리 — 표준의 힘은 협업 규약에서

팀에서 슬랙 요약봇 서버 하나를 정리해 두면, 팀원 누구든 Claude Code · Codex 어느 도구를 쓰든 그 서버를 붙여 같은 요약 품질을 얻는다. 도구 선택이 팀 표준을 흔들지 않는다.

팀 리포에 mcp-servers/ 폴더를 두고 각 서버를 데코레이터 함수 단위로 추가해 나가면, 한 사람이 만든 툴이 팀 전체 워크플로에 즉시 반영된다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background centered on a stylized MCP hub emblem. Around the hub, four client icons on the top labeled 'Claude Code', 'Codex', 'Cursor', 'Windsurf', and five service icons on the bottom labeled 'Slack', 'Discord', 'Notion', 'Linear', 'Jira'. Arrows flow from services into the hub and from the hub out to the clients. Clean editorial illustration style, warm orange gradient background accents with teal #00b894 and purple #6c5ce7 highlights, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."