brunch

침팬지도 따라 할 수 있는 MCP_01

Claude Desktop을 곁들인

by brandpicker

MCP와 관련한 소식을 다양하게 접하면서

직접 따라 해보기 위해 이것저것 시도했다.


글을 읽기도 하고 영상을 보기도 했지만

꼭 한 번씩 중간에 뭔가 잘 안 돼서 추가로 자료를 찾아봐야만 했다.


그래서 나는 생각했다.

"침팬지도 따라 할 수 있을 만큼 쉽고 명확한 MCP 연동을 누군가 정리해 줬으면 좋겠다"라고.


침팬지도 따라 할 수 있는 MCP 1탄!


[목차]

* 기본세팅

* ai(Cluade) <-> local(바탕화면 폴더)

* 주의사항


목차를 보면 알겠지만,

이번 글에서는 claude ai에게 내 컴퓨터 바탕화면 폴더에 있는 자료에 대하여 작업을 할 수 있도록 세팅 및 명령해 볼 것이다.


기본세팅


1탄의 첫 번째 단계이므로

기본적인 세팅이 필요하다.


복잡하게 생각할 것 없다.

내가 산 노트북(데스크톱)에 전자기기를 연결하려면 어댑터가 필요하듯이

ai와 내 바탕화면 폴더를 연결하려면 어댑터가 필요할 뿐이다.


휴대폰에 연결하는 어댑터가 5pin, 8pin, c-type 등 여럿 있듯이

MCP 관련 연결 도구(세팅)들 또한 자세하게 들어갈수록 복잡해지므로

당장은 개념을 이해하기보다 있는 그대로 따라 해보고

"MCP가 이런 것들을 가능하게 해 주는구나"를 느끼는데 초점을 맞추도록 하자.


[설치할 것 01 - Claude Desktop]

https://claude.ai/download

링크를 타고 들어가 운영체제(WIndows/macOS)에 맞게 다운 및 설치해 주자.

스크린샷 2025-05-16 015834.png


[설치할 것 02 - Node.js]

https://nodejs.org/ko/download/

링크를 타고 들어가 운영체제(Windows/macOS)에 맞게 다운 및 설치해 주자.


[설치할 것 03 - Visual Studio Code]

https://code.visualstudio.com/download

링크를 타고 들어가 운영체제(Windows/macOS)에 맞게 다운 및 설치해 주자.

스크린샷 2025-05-16 020343.png


설치한 Visual Studio Code(vscode)를 실행해 보자.

스크린샷 2025-05-16 021136.png

Welcome 하면서 반겨줄 텐데,

신기하다고 이것저것 눌러보지는 말자. (시작하는 것보다 어려운 건 잘못된 걸 고치는 일입니다)


앞으로 이 vscode에서 cluade_desktop_config.json 이라는 파일을 생성/수정하면서

로컬, slack, Notion, Figma, Youtube 등 다양한 MCP 서버와 클로드를 연결할 수 있다.


Open File을 눌러보자.

스크린샷 2025-05-16 022428.png


PC -> AppData -> Roaming -> Claude

* Mac의 경우 Library > Application Support > Claude

* PC에서 AppData가 안 보이는 경우 PC의 아무 폴더를 여신 후 "보기 -> 표시 -> 숨긴 항목" 체크하면 보입니다.

스크린샷 2025-05-16 023356.png


빈 곳 우클릭하여 텍스트 파일을 하나 만들어주고

스크린샷 2025-05-16 023523.png


"claude_desktop_config" 라고 이름 지은 후 열기를 눌러주면

스크린샷 2025-05-16 024521.png


아래와 같이 "claue_desktop_config.txt" 파일이 열리게 된다.

스크린샷 2025-05-16 024638.png


이 상태에서 우측상단 File -> Save As를 눌러

스크린샷 2025-05-16 025128.png


파일 형식을 txt(텍스트)에서 json으로 바꾸고 저장을 눌러주면

스크린샷 2025-05-16 025313.png


기존 "claue_desktop_config.txt" 였던 파일이 ""claue_desktop_config.json" 으로 바뀐다.

아래 사진과 같은 모습으로 보이면 잘 세팅된 거다.

스크린샷 2025-05-16 025534.png



ai(Cluade) <-> local(바탕화면 폴더)


시작하기 전에 바탕화면에 "test_claude" 라는 폴더를 하나 생성해 두자.


vscode에 열어둔 claude_desktop_config.json 파일에 아래 코드를 그대로 넣고 저장한다.


{

"mcpServers": {

"filesystem": {

"command": "npx",

"args": [

"-y",

"@modelcontextprotocol/server-filesystem",

"C:\\Users\\/PC\\Desktop\\test_claude"

]

}

}

}


스크린샷 2025-05-16 030336.png


저장하고 나면 여기까지 따라오면 vscode에서 할 건 모두 끝이다.

이제 설치했던 Cluade Desktop을 실행한다.


아래처럼 대화창 좌측하단 버튼에 "filesystem"이 보이면 모든 세팅이 잘 된 것이다.

스크린샷 2025-05-16 030749.png


이제 바탕화면 폴더에 있는 파일들에 대하여 ai에게 작업을 요청할 수 있다.

스크린샷 2025-05-16 031115.png
스크린샷 2025-05-16 031135.png


이런 것도 가능하다.

스크린샷 2025-05-16 031911.png
스크린샷 2025-05-16 031923.png



주의사항


이것만은 조심하자 싶은 건

결국 "보안 문제"일 것이다.


본 글에서 우리는

ai에게 local(바탕화면 폴더)에서의 접근/작업을 가능토록 했다.


세팅을 어떻게 하는지에 따라 이 local이

통제안에 있는 바탕화면 폴더가 아닌

보안이 중요한 내 컴퓨터 전체가 될 수도 있다.

C 혹은 D드라이브와 같은 내장드라이브 혹은 외장 드라이브가 될지도 모른다.


예를 들어,

vscode "claude_desktop_config.json" 파일에 작성한 코드 중

"C:\\Users\\/PC\\Desktop\\test_claude"를

"C:\\Users\\/PC\\Desktop"으로 바꾼다면

바탕화면에 있는 "test_cluade" 폴더만이 아닌 바탕화면에 있는 모든 폴더 및 파일들에 ai가 접근할 수 있게 된다.


아직까지는 ai가 특정 프로그램을 실행하거나 삭제하지는 못하지만

이는 권한의 문제이지 악성/불법 프로그램에 의하여 언제든지 위험한 도구가 추가될 수 있다.


지금은 바탕화면 폴더에 대한 접근 권한,

즉 장난감 금고의 열쇠를 ai에게 넘겨주는 수준이지만

나도 모르는 새 집 열쇠와 비밀번호를 ai에게 알려주지 않도록 주의해야 한다.


침팬지도 따라 할 수 있는 MCP 2탄?


3, 4탄이 나올지는 모르겠으나

2탄은 나올 것 같다.


2탄에서 다룰 예정인 주제는

2-1) ai <-> slack

2-2) local <-> (ai) <-> slack


이렇게 크게 2개인데,

local이 아닌 사기업 서비스에 대한 작업을 ai에게 명령한다는 점과

local과 특정 서비스에 대한 연계 작업을 ai에게 명령한다는 점에서 그 의의가 있다.


많은 관심을 받고 있지만

아직 막 걸음마를 뗀 MCP,

침팬지와 같은 공학 지식으로도

경험해볼 수 있도록 내용 공유하겠습니다^^

keyword
작가의 이전글학점은행제 계산기 출시 이벤트