[Claude Code] MCP(Model Context Protocol)

클로드 코드는 MCP 기능을 내장하고 있다. 이번 포스팅에서는 MCP의 개념과 MCP 활용 방법에 대해 알아볼 것이다.

 

1. MCP(Model Context Protocol)란?

- AI 모델과 외부 시스템간의 연결 장치(통신 규약)

※ "AI 모델"이 외부 시스템과 소통한다는 점에서 API와 차이가 있다. 

- AI가 노션, 깃허브, 데이터베이스 등에 접근하고 관리할 수 있도록 해준다.

 

 

 

2. Claude의 MCP

클로드의 MCP는 클라이언트/서버 모델을 따른다. 클로드의 MCP 클라이언트는 작업 지시만 하고 실제 실행은 다른 MCP 서버가 담당한다. 이 때, MCP 서버의 위치에 따라 로컬 MCP와 원격 MCP로 나뉜다.

 

1) 원격 MCP

- 인터넷상 외부에 위치해 있는 MCP

- 대표적인 예시로 노션 MCP, 깃허브 MCP가 있다.

- 설치 명령어

claude mcp add --transport http [내가 지정할 MCP 이름] [MCP 서버 URL]

 

 

2) 로컬 MCP

- 내 컴퓨터에 위치해 있는 MCP

- 인터넷 없이 개인 환경에서 작동 가능

- 설치 명령어

claude mcp add [내가 지정한 MCP 이름] [옵션] -- [MCP 실행 명령]

 

 

 

3. 원격 MCP 사용 예시: Claude Code와 Notion MCP 연결

1) 노션 소개

https://www.notion.com/ko

나만을 위한 AI 워크스페이스 | Notion (노션)

Notion(노션)은 메모, 문서, 지식 정리, 프로젝트 관리, 데이터베이스, 공개 웹사이트 등의 기능을 활용할 수 있는 워크스페이스를 제공하는 서비스로, 많은 회사에서 애용하고 있다.

 

회원 가입시 바로 사용 가능하다.

 

 

2) 노션 MCP 서버 설치

개발자를 위한 노션 문서에서 노션 MCP를 설치하는 방법을 알려준다.

https://developers.notion.com/guides/mcp/get-started-with-mcp#claude-code

Connecting to Notion MCP - Notion Docs

 

아래 명령어로 설치하면 된다고 나와있다.

claude mcp add --transport http notion https://mcp.notion.com/mcp

 

아래와 같은 문구가 뜨면 잘 설치된 것이다.

 

클로드 코드로 들어가서 /mcp 명령을 입력하면 mcp 목록을 볼 수 있는데, notion mcp가 잘 설치된 것을 확인할 수 있다. 그런데 인증이 필요하다고 한다. 일단 notion을 선택한다.

 

인증을 진행하기 위해 Authenticate를 선택한다.

 

아래와 같은 창이 뜨면 허용을 눌러준다.

 

Notion MCP 연결을 위한 페이지가 뜨면 동의 체크박스 체크 후 진행한다.

 

연동 완료 화면

 

/mcp 명령을 입력하면 notion mcp가 연결되었다고 나온다.

※ 터미널에서 'claude mcp list' 명령을 통해서도 mcp 목록을 조회할 수 있다.

 

notion mcp에 다시 들어가서 View tools를 선택하면 

 

notion mcp가 제공하는 14개의 도구들을 확인할 수 있다.

 

 

3) 노션 MCP 사용 예시

특정 도구를 쓰라고 직접 명시하지 않아도, notion mcp를 사용해야 하는 상황이면 클로드 코드가 알맞는 도구를 선택해서 작업을 수행한다.

 

 

 

4. 로컬 MCP 사용 예시: Claude Code와 Sequential Thinking MCP 연결

1) Sequential Thinking 소개

https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking

servers/src/sequentialthinking at main · modelcontextprotocol/servers

- 엔트로픽이 제공하는 MCP 서버 중 하나로, AI가 구조화된 사고 과정을 할 수 있도록 도와주는 도구다.

- 복잡한 문제를 작은 단위로 나누어 순차적으로 추론한다.

 

 

2) Node.js 다운로드

https://nodejs.org/ko/download

Node.js — Node.js® 다운로드

본 포스팅에서는 npx를 통해 sequential thinking mcp 서버를 설치할 것이기 때문에 node.js를 다운로드 받아야 한다.

터미널에 'node -v' 명령을 입력했을 때 버전이 출력된다면 node.js가 잘 설치된 것이다.

 

 

3) Sequential Thinking MCP 서버 설치

claude mcp add sequential-thinking -s local -- npx -y @modelcontextprotocol/server-sequential-thinking

※ -s 또는 --scope: MCP의 적용 범위를 지정한다. local(개인이 현재 프로젝트에만 사용), project(팀원들이 현재 프로젝트에만 사용), user(개인이 전체 프로젝트에 사용) 등을 지정할 수 있다.

※ -- 이후에 오는 내용들은 MCP 서버 실행 명령어로 전달된다.

※ npx: Node.js 패키지를 실행한다.

※ -y: 뒤에 명시한 패키지가 로컬에 설치되어 있지 않을 때 자동 설치를 승인하도록 돕는다.

 

 

4) Sequential Thinking MCP 사용 예시