MCP(Model Context Protocol)란? 설치 방법부터 사용 예제 및 관리 방법 안내

MCP란 무엇인가?

MCP(Model Context Protocol)는 AI 모델과 외부 애플리케이션, 시스템 또는 파일과의 상호작용을 표준화하는 프로토콜입니다. 기존의 API 호출 방식과 달리, MCP는 AI가 로컬 환경과 보다 유기적으로 연결될 수 있도록 설계되었습니다. 이를 통해 AI는 파일 시스템, 데이터베이스, 네트워크 리소스 등에 접근하여 보다 풍부한 기능을 수행할 수 있습니다.

쉽게 말해 ChatGPT, Claude, Perplexity 등의 AI를 구분하지 않고 AI가 활용할 수 있도록 도구를 제공해주는 것입니다.

기존에도 ChatGPT의 이미지 만드는 도구나 표와 그래프 등을 그려주는 도구가 있었습니다. 하지만 이 도구들은 모두 ChatGPT가 쓸 수 있도록 맞춤형으로 만들어진 도구라서 Claude나 Perplexity에서는 사용할 수 없었습니다. 바로 이런 문제점을 해결해주기 위해 AI의 구분 없이 프로토콜로 정의하여 표준화된 형식을 만들어 모든 AI에 사용할 수 있게 해주는 것입니다. 

바로 이 기능을 엔트로픽의 Claude 데스크톱 앱에서 사용할 수 있습니다. 오픈AI에서도 사용할 수 있게 조만간 업데이트한다고 Sam Altman이 공개했습니다. 

MCP의 주요 특징

• 모델과 로컬 리소스 간 직접 연결: AI 모델이 운영 체제의 특정 디렉터리나 애플리케이션과 직접 통신 가능
• 보안 및 접근 제어: 사용자가 AI가 접근할 수 있는 리소스를 직접 지정 가능
• 확장성 및 유연성: 다양한 애플리케이션 및 시스템과 쉽게 통합 가능

MCP의 사용 예제

1. 파일 시스템 액세스: AI가 로컬 파일을 읽고 수정하며, 사용자의 요청에 따라 특정 문서를 분석할 수 있음
2. 코드 실행 환경과 연동: AI가 코드 편집기와 상호작용하여 코드 수정 및 테스트 수행 가능
3. 데이터베이스 조회 및 조작: AI가 로컬 또는 원격 데이터베이스와 연결되어 특정 데이터를 검색하거나 업데이트 가능
4. 업무 자동화: AI가 특정 스크립트나 프로그램을 실행하여 반복적인 업무 자동화 가능

무엇이든지 바로 사용해보고 느껴야 더 잘 이해되고 흡수됩니다.

MCP 설치 방법

MAC 사용자들은 무리 없이 설치 할 수 있을거라 생각하여 Windows 사용자를 위해 설명드리겠습니다.

1. Claude 데스크톱 앱 설치

Claude 공식 웹사이트에서 운영 체제에 맞는 데스크톱 애플리케이션을 다운로드하여 설치하세요.

2. Claude MCP 서버 구성

Claude 앱 왼쪽 상단의 메뉴 버튼 클릭 > 파일 > 설정을 클릭합니다.

다음 설정 화면에서 왼쪽 카테고리의 "개발자" > "설정 편집"을 클릭합니다.

그럼 MCP 프로그램의 목록을 담게될 jon 파일을 확인하실 수 있습니다.

위 파일을 마우스 오른쪽 버튼을 클릭하여 "메모장에서 편집"을 누르면 메모장으로 내용을 확인하실 수 있습니다.

처음에는 아래와 같이 {} 만 확인하실 수 있습니다.

이제 아래와 같이 내용을 수정합니다.

프로그램목록 부분에 사용하고자 하는 MCP를 하나씩 추가하여 설치할 수 있습니다.

먼저 테스트를 위한 "텍스트 메모리"라는 MCP를 추가해보도록 하겠습니다.

다음 사이트로 이동합니다.

https://www.npmjs.com/package/text-memory

다음과 같이 MCP 프로그램들은 설치 방법을 안내하는 부분에 설치를 위한 코드를 제공해줍니다.

해당 부분을 복사하여 위 claude_desktop_config.json 메모장에 "프로그램목록" 부분에 붙여넣어줍니다.

해당 구문의 뜻은 "command": "npx"는 npx 프로그램을 실행해서 텍스트 메모리 MCP 서버 프로그램을 다운로드 받아서 구동을 한다는 의미입니다.

자 다음으로 blender-mcp를 추가해보도록 하겠습니다. 

아래 사이트로 이동합니다.

https://github.com/ahujasid/blender-mcp

마찬가지로 스크롤을 내려 코드 부분을 복사합니다.

기존 text-memory 설정 마지막에 ,를 입력하고 붙여넣기 합니다.

위와 마찬가지로 "nvx 프로그램 실행한다" 입니다.

메모장을 저장하여 설정 작업을 마무리합니다.

이제 npx 프로그램과 uvx 프로그램을 MCP가 실행할 수 있도록 PC에 설치를 해줘야 합니다.

일반적으로 MCP 프로그램들은 자바스크립트나 파이썬으로 많이 만들어집니다.

자바스크립트로 만들어진 MCP 프로그램은 npx을 실행하여 다운로드 하게 되고,

파이썬으로 만들어진 MCP 프로그램은 uvx를 실행하여 다운로드 하게 됩니다.

3. Node.js 설치

먼저 npx라면 Node.js 공식 웹사이트에서 Node.js를 설치합니다.

4. uv 설치

다음 명령어를 powershell에 붙여넣기 합니다.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

5. Claude 재시작 및 확인

• 설정을 저장한 후 Claude 데스크톱 앱을 재시작합니다.
• 좌측 상단에 메뉴 버튼을 클릭하고 파일 > 종료 버튼을 클릭합니다.
• 채팅 입력창의 우측 하단에 망치 아이콘이 나타나면 MCP 서버가 정상적으로 연결된 것입니다.

다음과 같이 망치 아이콘이 표시되면 정상적으로 설정된 것입니다.

만약 망치 모양의 아이콘이 보이지 않는다면, Claude 앱이 정상적으로 재시작 하지 않은 것입니다.

일반적으로 Claude 앱의 우측 상단에 있는 X 표시를 눌러서 종료하게 되면 프로그램이 완전히 종료되지 않습니다.

그렇기 때문에 위에서 설명드린바와 같이 메뉴를 통해 완전히 종료해주셔야 합니다.

추가한 MCP 도구 설명

망치 아이콘을 클릭하게 되면 추가한 MCP 도구의 이름과 주요 기능을 확인하실 수 있습니다.

아래 표는 위에서 추가한 두 도구의 기능 설명을 작성해 놓은 것입니다.

도구 이름	서버	주요 기능
create_object	blender	Blender 장면에 새 객체(큐브, 구, 실린더 등)를 생성
delete_object	blender	Blender 장면에서 객체 삭제
delete_text_data	text-memory	텍스트 데이터 파일 삭제 (대화 기록 관리용)
download_polyhaven_asset	blender	Polyhaven에서 에셋(HDRI, 텍스처, 모델)을 다운로드하고 Blender로 가져오기
execute_blender_code	blender	Blender에서 임의의 Python 코드 실행
generate_hyper3d_model_via_images	blender	이미지를 기반으로 Hyper3D를 사용하여 3D 모델 생성
generate_hyper3d_model_via_text	blender	텍스트 설명을 기반으로 Hyper3D를 사용하여 3D 모델 생성
get_hyper3d_status	blender	Hyper3D Rodin 통합 기능이 Blender에서 활성화되어 있는지 확인
get_object_info	blender	Blender 장면의 특정 객체에 대한 상세 정보 제공
get_polyhaven_categories	blender	Polyhaven의 특정 에셋 유형에 대한 카테고리 목록 제공
get_polyhaven_status	blender	PolyHaven 통합 기능이 Blender에서 활성화되어 있는지 확인
get_scene_info	blender	현재 Blender 장면에 대한 상세 정보 제공
import_generated_asset	blender	Hyper3D Rodin으로 생성된 에셋을 Blender로 가져오기
list_text_data	text-memory	현재 디렉토리의 모든 텍스트 데이터 파일 목록 표시
modify_object	blender	Blender 장면의 기존 객체 수정 (위치, 회전, 크기, 가시성)
poll_rodin_job_status	blender	Hyper3D Rodin 생성 작업 완료 여부 확인
read_text_data	text-memory	파일에서 텍스트 데이터 읽기 (이전 대화 기록 검색용)
search_polyhaven_assets	blender	Polyhaven에서 에셋 검색 및 필터링
set_material	blender	객체에 재질 설정 또는 생성
set_texture	blender	이전에 다운로드한 Polyhaven 텍스처를 객체에 적용
write_text_data	text-memory	텍스트 데이터를 파일에 저장 (대화 기록 보존용)

지금은 두 도구만 설정을 해서 위 기능 밖에 사용을 못하지만 도구를 추가하여 기능을 늘려주면 다양한 기능을 AI가 수행할 수 있습니다.

예시로 설명할 때 가장 많이 사용하는 도구를 추가해 보도록 하겠습니다.

Filesystem이라고 하는 이름의 MCP 서버 프로그램입니다.

이 Filesystem은 파일 이름을 바꾸거나 지우거나 생성하거나 목록을 보거나 등의 기능을 수행할 수 있습니다.

다음 사이트로 이동합니다.

https://github.com/modelcontextprotocol/servers/tree/HEAD/src/filesystem

설정 부분을 복사하여 MCP 설정 json 파일에 넣어줍니다.

"filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }

붙여넣기 이후 다음과 같이 filesystem 도구 부분을 수정해주어야 합니다. 매게변수 설정 args 부분에 filesystem이 수행할 수 있는 폴더 권한을 제한하는 것입니다. filesystem 도구는 파일의 수정, 삭제, 생성 등의 일을 수행하기 때문에 모든 권한 보다는 적절한 권을 부여하는 것이 보안에 안전하기 때문입니다.

여기서는 바탕화면에 MCP 폴더를 만들어 해당 경로만 컨트롤할 수 있게 설정하겠습니다.

아래와 같은 모양입니다.

		"filesystem": {
      			"command": "npx",
      			"args": [
        			"-y",
        			"@modelcontextprotocol/server-filesystem",
        			"C:/Users/user/Desktop/MCP"
      			]
    		}
	}

전체 json 설정 파일의 코드입니다.

{
	"mcpServers": {
		"text-memory": {
            		"command": "npx",
            		"args": [
                		"-y",
                		"text-memory"
            		]
		},
		"blender": {
			"command": "uvx",
			"args": [
                		"blender-mcp"
			]
		},
		"filesystem": {
      			"command": "npx",
      			"args": [
        			"-y",
        			"@modelcontextprotocol/server-filesystem",
        			"C:/Users/user/Desktop/MCP"
      			]
    		}
	} 
}

자 이제 Claude 앱을 완전히 종료하고 다시 시작합니다.

위에 망치 아이콘 옆에 숫자 갯수가 기존 21개에서 32개로 늘어난 것을 확인할 수 있습니다.

만약 Claude 앱을 실행할 때 아래와 같이 우측 상단에 오류가 뜬다면, MCP 설정 json 파일이 문제가 있는 것이니 다시 한번 확인하시면 됩니다.

MCP 실행 예제

위에서 추가한 filesystem을 활용하여 C:\Users\user\Desktop\MCP 경로에 텍스트 파일을 생성해보겠습니다.

클로드 데스크탑 앱에 다음과 같이 AI에 요청합니다.

"C:\Users\user\Desktop\MCP" 폴더 경로에 텍스트 파일 5개만 생성해줘, 이름은 1부터 5까지로 해줘

클로드 데스크톱 앱은 MCP 도구들 중에  해당 경로에 텍스트 파일을 생성할 수 있는 도구를 찾고 허용 요청을 보내게 됩니다. "이 채팅 허용" 버튼을 클릭하여 사용 권한을 부여하면 생성을 시작합니다.

아래와 같이 전부 수행하는 것을 확인하실 수 있습니다.

실제로 해당 경로로 이동하여 텍스트 파일이 생성되었는지 확인합니다.

정상적으로 생성된 것을 확인할 수 있습니다.

이제 1~5로 생성된 텍스트 파일의 이름을 변경해보도록 하겠습니다.

생성 완료 후 경로로 이동하여 텍스트 파일의 이름을 확인합니다.

모두 완벽하게 변환되었습니다. 이뿐만 아니라 가 텍스트 파일의 내용을 추가해도록 하겠습니다.

가 텍스트 파일의 내용을 확인해보겠습니다.

위와 같이 완벽하게 수행해냈습니다.

MCP 운영 및 관리 방법

1. 접근 권한 설정
   • config.json 파일을 수정하여 AI가 접근할 수 있는 디렉터리 및 애플리케이션을 제한
2. 로그 및 모니터링
   • AI와 MCP 간의 데이터 흐름을 모니터링하여 보안 및 성능 관리
3. 업데이트 및 유지보수
   • 최신 버전의 MCP를 유지하여 보안 취약점을 방지하고 새로운 기능 활용

결론

MCP(Model Context Protocol)는 AI 모델과 로컬 리소스를 보다 강력하게 연결하는 혁신적인 프로토콜입니다. 이를 통해 AI는 단순한 질문/응답을 넘어, 실제 시스템과 상호작용하여 더욱 강력한 생산성 도구로 활용될 수 있습니다.