터미널에서 실행되는 강력한 AI 에이전트 Claude Code를 사용하다 보면, 기본 탑재된 기능 외에 나만의 파일 시스템이나 로컬 도구를 쥐여주고 싶을 때가 있죠. 이럴 때 정말 요긴하게 쓸 수 있는 기술이 바로 Model Context Protocol(MCP)입니다. 로컬 MCP 서버를 연동하면 터미널 환경에 꼭 맞는 강력한 맞춤형 비서를 빌드할 수 있어요.

설정 방법은 생각보다 훨씬 간단합니다. 따로 복잡한 설정 파일을 만질 필요 없이 터미널에서 명령어 한 줄만 입력하면 로컬 파일 시스템 제어용 MCP 서버를 즉시 등록할 수 있습니다.

# 로컬 디렉터리를 탐색하는 파일 시스템 MCP 서버 추가
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem /path/to/folder

이렇게 추가한 설정은 ~/.claude/settings.json에 저장되어 사용자 수준에서 전체적으로 관리됩니다. 만약 팀 프로젝트 단위로 똑같은 MCP 서버를 공유하고 싶다면 깃 저장소 내부에 .claude/settings.json 파일을 커밋해 공유하는 것도 가능해요. 연결 상태가 불안정하거나 제대로 연동되었는지 확인하고 싶다면 Claude Code 세션 안에서 /mcp 명령어를 입력해 보거나, 실행할 때 claude --mcp-debug 옵션을 붙여서 쉽게 디버깅할 수 있습니다 ㅎㅎ

한 가지 팁으로, 최근 보안이 강화되면서 출처가 불분명한 저장소에서 받아온 프로젝트 레벨의 MCP 서버는 신뢰 질문(Workspace Trust)을 거치기 전까지 일시 정지 상태로 대기하게 됩니다. 터미널 환경은 시스템 권한을 직접 다룰 수 있는 만큼 실행 전에 믿을 만한 서버 구성인지 가볍게 확인하는 습관을 지니는 것을 추천드립니다!