MCP 처음 연결해보기 — 폴더 하나로 개념 잡기

목표

AI가 내 컴퓨터의 파일을 직접 만들고 고치는 것을 눈으로 확인하면서 MCP(AI가 다른 프로그램을 쓰게 해주는 연결 규격)가 뭔지 감을 잡습니다. 30분이면 충분해요.

준비물

• MCP를 지원하는 AI 앱 하나: Claude Code 또는 Claude Desktop, Cursor 등
• 테스트용 빈 폴더 하나 (중요한 파일이 없는 곳)
• Filesystem MCP

순서

1. 연습용 폴더 만들기 — 바탕화면에 mcp-test 같은 빈 폴더를 만듭니다. 처음에는 꼭 빈 폴더로 시작하세요. AI가 실수로 다른 파일을 건드리지 않게 하려는 거예요.
2. Filesystem MCP 연결 — AI 앱의 MCP 설정에 Filesystem MCP를 추가하고, 허용 경로에 방금 만든 폴더만 적습니다. 설정 방법은 앱마다 달라서 항목 페이지의 설치 명령과 각 앱의 MCP 안내를 함께 보세요.
3. 앱 다시 시작 후 확인 — 앱을 껐다 켜고 “지금 쓸 수 있는 도구 목록 보여줘”라고 물어봅니다. 파일 읽기·쓰기 같은 도구가 보이면 연결된 거예요.
4. 첫 요청 — 이렇게 요청해 보세요.

   mcp-test 폴더에 오늘 날짜로 된 메모 파일을 하나 만들고, 안에 “MCP 테스트”라고 적어줘

5. 폴더 열어 확인 — 실제로 파일이 생겼는지 탐색기로 엽니다. 이 순간 “AI가 내 컴퓨터의 도구를 쓴다”는 게 무슨 뜻인지 바로 와닿아요.
6. 조금 더 해보기 — “이 폴더의 파일 목록을 표로 정리해줘”, “메모 파일 내용을 세 줄로 늘려줘”처럼 읽기·수정도 시켜 봅니다.

결과

AI에게 말만 했는데 폴더에 파일이 생기고 내용이 바뀝니다. 이게 MCP의 전부예요: AI + 도구 연결 = AI가 대신 손을 움직임.

다음 단계

• GitHub MCP — 이슈 정리, 이슈 만들기를 맡겨 봅니다. 토큰 권한은 필요한 저장소만, 최소로 주세요.
• Playwright MCP — AI가 브라우저를 열고 클릭·입력하게 합니다. 내가 만든 웹페이지가 잘 동작하는지 확인시키기에 좋아요.

막히면

• 도구 목록에 안 보여요 → 설정 파일의 쉼표·따옴표 오타가 가장 흔한 원인이에요. 앱을 완전히 종료했다 다시 켰는지도 확인하세요.
• “권한이 없다”고 해요 → 허용 경로를 폴더의 전체 경로로 정확히 적었는지 확인하세요.
• 불안해요 → 그래서 빈 폴더로 시작하는 거예요. 익숙해지기 전엔 중요한 폴더를 허용하지 마세요.