AI 에이전트 시대의 핵심, MCP(Model Context Protocol) 에 대해 들어보셨나요? 최근 오픈AI CEO 샘 알트먼이 ChatGPT에도 MCP 도입을 결정하면서 이 프로토콜이 AI 활용의 판도를 바꿀 핵심 기술로 떠오르고 있습니다. 오늘은 MCP가 무엇인지, 어떤 장점이 있는지, 그리고 가장 중요한 클로드(Claude) 데스크톱 앱에서 직접 MCP를 설치하고 활용하는 방법까지 상세히 알아보겠습니다. 이 가이드 하나면 여러분도 클로드를 500% 더 똑똑하게 활용할 수 있을 거예요!

1. MCP(Model Context Protocol)란 무엇인가요?

MCP는 모델, 즉 AI 모델이 외부 서비스와 효과적으로 소통하고 필요한 액션을 취할 수 있도록 돕는 표준화된 프로토콜입니다. 마치 개발자들이 API를 활용해 다양한 서비스들을 연결하는 것처럼, MCP는 AI 모델이 다른 서비스들을 이용하기 쉽게 도와주는 '소통 방식'이라고 생각하시면 됩니다.

MCP의 핵심 구조:

  • 호스트 (Host): AI 모델을 활용할 수 있는 서비스입니다. 우리가 오늘 실습할 클로드를 비롯해, AI 코딩 도구인 커서(Cursor)나 윈프(Winfe), AI 에이전트 자동화 툴인 M8 등이 호스트 역할을 할 수 있습니다.
  • 클라이언트 (Client): 호스트와 서버 간의 커뮤니케이션을 돕는 역할을 합니다.
  • 서버 (Server): 가장 중요한 개념으로, 다양한 외부 서비스들을 표준화된 방식으로 활용할 수 있도록 돕습니다. 구글 캘린더, 슬랙, 노션 등 연결하고 싶은 서비스마다 해당 MCP 서버를 설치하여 활용하게 됩니다.

MCP의 장점:

  • 쉬운 서비스 연동: MCP를 활용하면 다양한 외부 서비스들을 호스트 서비스(예: 클로드)에서 활용하고 싶을 때 단순히 해당 서버만 설치해주면 바로 사용할 수 있습니다.
  • 생산성 향상: 기존에는 각 서비스의 API를 개별적으로 코딩하거나 자동화 툴의 복잡한 설정을 해야 했습니다. MCP는 이런 번거로움을 제거하여 AI 에이전트를 만들기가 훨씬 수월해집니다.
  • 표준화된 생태계: MCP가 AI 에이전트를 위한 표준 프로토콜이 되면, 많은 서비스들이 공식적으로 MCP 서버를 제공하게 되어 더욱 효율적인 활용이 가능해질 것입니다.

2. MCP 실습을 위한 사전 준비

클로드 데스크톱 앱에서 MCP를 활용하기 위해서는 몇 가지 준비 작업이 필요합니다.

1) 클로드 데스크톱 앱 설치

아직 웹 버전 클로드에서는 MCP를 활용할 수 없으므로, 클로드 데스크톱 앱을 설치해야 합니다.

2) VS Code 설치 (선택 사항이지만 강력 추천)

config.json 파일을 편집할 때 좀 더 편리하게 작업하기 위해 VS Code(Visual Studio Code) 설치를 추천합니다. 메모장이나 일반 텍스트 편집기로도 가능하지만, VS Code는 코드 편집 및 JSON 파일 편집에 매우 유용합니다.

3) Node.js 설치

MCP 서버를 로컬에서 설치할 때 활용하는 프로그램이므로 Node.js를 설치해야 합니다.

4) 클로드 개발자 옵션 활성화

클로드 데스크톱 앱에서 config.json 파일을 편집할 수 있도록 개발자 옵션을 활성화해야 합니다.

  • 클로드 데스크톱 앱 실행 후, 좌측 하단의 설정(Settings) 탭으로 이동합니다.
  • **"개발자 옵션(Developer Options)"**을 클릭합니다.
  • "설정 편집(Edit Settings)" 아이콘을 클릭하면 claude.config.json 파일이 표시됩니다. 이 파일을 VS Code로 열어줍니다.

3. MCP 서버 설치 및 실전 활용 가이드

이제 실제 MCP 서버를 설치하고 클로드에서 활용하는 방법을 단계별로 알아보겠습니다.

실습 1: 인터넷 검색/크롤링 & Slack 메시지 전송 자동화

이 실습에서는 인터넷에서 AI 최신 뉴스를 크롤링하여 리포트를 만들고, 그 리포트를 Slack으로 전송하는 작업을 자동화할 것입니다.

1단계: 필요한 MCP 서버 확인

  • 인터넷 검색 및 크롤링: Firecrawl MCP 서버 (서드파티 서버)
  • Slack 메시지 전송: Slack MCP 서버 (클로드 공식 레퍼런스 서버)

2단계: MCP 서버 정보 찾기 (GitHub)

MCP 서버 정보는 주로 GitHub에 공유되어 있습니다.

3단계: Firecrawl MCP 서버 설치

Firecrawl은 웹페이지 크롤링에 유용한 서비스입니다.

  1. Firecrawl MCP 서버 페이지 접속:
    • GitHub에서 third_party_servers 폴더로 이동하여 firecrawl-mcp-server를 클릭합니다.
    • usage-with-claude-desktop.md 파일을 열어 설치 가이드를 확인합니다.
  2. config.json 파일 편집:
    • 클로드 데스크톱 앱에서 연 claude.config.json 파일에 다음 코드를 복사하여 붙여넣습니다. (기존 내용이 있다면 mcp_servers 배열 안에 추가)
    JSON
     
    {
  "mcp_servers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-5bba2b8677ba406aa37082303ca77bbc"
      }
    }
  }
}
    • 주의: FIRECRAWL_API_KEY 값은 본인의 Firecrawl API 키로 반드시 변경해야 합니다. 위에 제시된 키는 예시입니다.
    • 파일을 저장합니다 (Ctrl+S 또는 Cmd+S).

4단계: Slack MCP 서버 설치

Slack은 메시지 전송 및 커뮤니케이션에 활용됩니다.

  1. Slack 앱 생성 및 설정:
    • Slack API 페이지에 접속합니다: https://api.slack.com/apps
    • **"Create New App"**을 클릭하고 **"From scratch"**를 선택합니다.
    • 앱 이름(예: Claude App)을 지정하고 워크스페이스를 선택한 후 **"Create App"**을 클릭합니다.
    • 생성된 앱 대시보드에서 "App Home" 탭으로 이동하여 **"Edit"**을 클릭, 앱 표시 정보(이름, 아이콘 등)를 설정합니다.
    • 좌측 메뉴에서 **"OAuth & Permissions"**를 클릭합니다.
    • "Bot Token Scopes" 섹션에서 다음 권한을 추가합니다: channels:read, chat:write, groups:read, im:read, mpim:read (설치 가이드에 따라 필요한 권한을 정확히 추가합니다).
    • 페이지 상단으로 스크롤하여 **"Install to Workspace"**를 클릭하여 앱을 워크스페이스에 설치합니다.
  2. Slack 토큰 및 팀 ID 확인:
  3. config.json 파일 편집:
    • 기존 config.json 파일의 mcp_servers 객체 내에 콤마(,)를 추가한 후, 다음 코드를 복사하여 붙여넣습니다. (기존 Firecrawl 설정 뒤에 추가)
    JSON
     
    ,
"slack": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-slack"
  ],
  "env": {
    "SLACK_BOT_TOKEN": "xoxb-9148176122182-9154315866532-tU3hlLcLm3JApdBR4eqfCPMh",
    "SLACK_TEAM_ID": "T094C563L5C"
  }
}
    • 주의: SLACK_BOT_TOKEN과 SLACK_TEAM_ID 값은 본인의 Slack 토큰과 팀 ID로 반드시 변경해야 합니다. 위에 제시된 키는 예시입니다.
    • 파일을 저장합니다.

5단계: Slack 채널에 Claude 앱 추가 (중요!)

이 단계는 Claude 앱이 특정 Slack 채널에 메시지를 보내거나 채널 정보를 읽을 수 있도록 권한을 부여하는 매우 중요한 과정입니다. 이 과정이 없으면 Claude 앱은 해당 채널에서 작동하지 않습니다.

Slack 채널에 Claude 앱을 추가하는 방법은 두 가지가 있습니다.

  1. 채널 정보(Detail)를 통해 앱 추가하기 (가장 일반적인 방법)
    • 메시지를 보내고 싶은 Slack 채널로 이동합니다. (예: "AI 뉴스" 채널)
    • 채널 화면의 오른쪽 상단에 있는 사람 모양 아이콘 (멤버 아이콘) 또는 'i' (정보) 아이콘을 클릭하여 채널 상세 정보를 엽니다.
    • 채널 상세 정보 팝업에서 "통합(Integrations)" 또는 "앱(Apps)" 섹션을 찾습니다.
    • 해당 섹션 내에서 "앱 추가(Add an App)" 또는 비슷한 이름의 버튼/링크를 클릭합니다.
    • 앱 목록이 나타나면, 이전에 생성했던 **Claude 앱의 이름(예: 'Claude App' 또는 '클로드')**을 검색하여 선택한 후 "추가(Add)" 또는 "설치(Install)" 버튼을 클릭합니다.
    • 성공적으로 추가되면, 해당 채널에 "Claude App이 채널에 추가되었습니다."와 같은 메시지가 표시됩니다.
  2. /invite 명령어를 사용하여 앱 초대하기
    • 메시지를 보내고 싶은 Slack 채널로 이동합니다.
    • 채널 하단의 메시지 입력 창에 /invite라고 입력한 후 한 칸 띄우고 @ 기호를 입력합니다.
    • @ 다음에 이전에 생성했던 **Claude 앱의 이름(예: claude 또는 Claude App)**을 입력하면 자동 완성 목록에 앱이 나타납니다.
    • 해당 앱을 선택한 후 Enter 키를 누릅니다.
    • 채널에 "Claude App이 채널에 초대되었습니다."와 같은 메시지가 나타나면 성공적으로 추가된 것입니다.

6단계: 클로드 데스크톱 앱 재시작

  • 클로드 데스크톱 앱을 완전히 **종료(Quit)**하고 다시 실행합니다.
  • 앱이 실행되면 좌측 하단에 망치 모양 아이콘이 생기고, 이를 클릭하면 Firecrawl 및 Slack 관련 도구들이 추가된 것을 확인할 수 있습니다.
  • "연결(Connections)" 탭에서도 설치된 MCP 서버를 확인할 수 있습니다.

7단계: 클로드로 Slack 메시지 전송 실습

  1. 프롬프트 입력 (인터넷 검색 및 리포트 작성):
  2. 테크크런치(TechCrunch)에서 AI 최신 주요 뉴스 다섯 개를 가져와서 리포트로 정리해 줘. 각 뉴스의 헤드라인과 기사 링크는 1회씩만 포함해 줘. 아웃풋 포맷은 슬랙(Slack) 블록키트(Block Kit) 호환 제이슨으로 해 줘. 아직 슬랙 메시지는 보내지 말고 리포트 내용부터 알려줘.
  3. MCP 도구 권한 허용: 클로드가 Firecrawl 도구 사용을 요청하면 **"허용(Allow)"**을 클릭합니다.
  4. 결과 확인: 클로드가 Firecrawl을 통해 뉴스를 크롤링하고 Slack 블록 키트 형식에 맞춰 리포트를 작성하여 보여줍니다.
  5. 프롬프트 입력 (Slack 메시지 전송):
  6. 해당 리포트를 슬랙 채널 'AI 뉴스'에 슬랙에 보기 좋은 형태로 게시해 줘.
  7. MCP 도구 권한 허용: 클로드가 Slack 도구 사용을 요청하면 **"허용(Allow)"**을 클릭합니다.
  8. Slack 메시지 확인: Slack 채널 "AI 뉴스"에 접속하여 클로드가 전송한 리포트 메시지를 확인합니다. 뉴스 헤드라인, 요약, 링크 등이 깔끔하게 정리되어 표시될 것입니다.

'개발' 카테고리의 다른 글

Docker 컨테이너에서 Node.js 풀스택 앱 실행 시 흔한 문제 해결 가이드  (1) 2025.07.30
프롬프트 엔지니어링 작성 방법  (1) 2025.07.12
책 정리 - 함께 자라기  (1) 2025.05.18
배포 방법과 배포 전략  (0) 2025.02.16
Java의 JIT(Just-In-Time) 컴파일러  (0) 2025.02.16

티스토리툴바