🔒 개인/회사 프로젝트 구분하는 사람들 주목! -- 하위 폴더에서 MCP 안 잡힐 때, 바로가기로 해결하기 (2탄)

📌 이 글은 2탄이에요!
1탄 ".env가 뭔데? 환경변수 완전 쉽게 이해하기"를 먼저 읽으면 더 이해가 쉬워요.

📖 배경

1탄에서 _work/와 _personal/ 폴더에 각각 .mcp.json을 만들어서 회사/개인 MCP 설정을 분리하는 방법을 알려드렸어요.

그런데 저도 직접 써보니까 "어? 안 되는데?" 하는 상황이 생기더라고요.

왜 그런지 원인을 찾았고, 해결 방법까지 알려드릴게요.

🎯 이런 분이 읽으면 좋아요

1탄 보고 _work/ 폴더에 .mcp.json 잘 만들어뒀는데...

다음 날 _work/회사-프로젝트-A/ 폴더에서 Linear MCP를 쓰려고 하니까 "Linear MCP를 찾을 수 없습니다"?

분명히 설정해뒀는데 왜 안 되는 거죠? 😭

😱 "분명히 1탄대로 했는데요?"

1탄 읽고 열심히 설정했어요.

📁 _work/
├── .mcp.json     ← 회사 Linear 키 ✅
└── .env          ← 회사 Airtable 키 ✅

📁 _personal/
├── .mcp.json     ← 개인 Linear 키 ✅
└── .env          ← 개인 Airtable 키 ✅

"좋아, 이제 회사 폴더에서 작업하면 회사 MCP가 로드되겠지!"

뿌듯하게 저장하고 퇴근했어요. 😊

📁 그런데 실제 작업 폴더는 이렇게 생겼어요

다음 날 출근해서 _work/회사-프로젝트-A/ 폴더에서 작업하다가 Linear MCP를 쓰려고 했더니 없다고 하더라고요.

잠깐, 회사 폴더 구조가 어떻게 생겼더라?

📁 _work/
├── .mcp.json              ← 회사 Linear 키 (여기 설정함!)
├── .env                   ← 회사 Airtable 키
│
├── 📁 회사-프로젝트-A/
├── 📁 회사-프로젝트-B/
├── 📁 회사-프로젝트-C/
└── 📁 회사-프로젝트-D/

실제로 작업하는 건 _work 폴더가 아니라, 그 안에 있는 각각의 프로젝트 폴더예요!

😱 근데 프로젝트 폴더에서 Claude Code를 열면...

회사-프로젝트-A 폴더에서 Claude Code를 열었어요.

📁 _work/
├── .mcp.json              ← 여기 설정해뒀는데...
│
└── 📁 회사-프로젝트-A/     ← ⭐ 여기서 Claude Code 열었어요!
    └── (❌ .mcp.json 없음!)

나: "Linear에서 이슈 가져와줘"
Claude Code: "Linear MCP를 찾을 수 없습니다"

회사-프로젝트-B 폴더에서도 열어봤어요.

📁 _work/
├── .mcp.json              ← 여기 설정해뒀는데...
│
└── 📁 회사-프로젝트-B/     ← ⭐ 여기서 Claude Code 열었어요!
    └── (❌ .mcp.json 없음!)

나: "Linear 이슈 보여줘"
Claude Code: "Linear MCP를 찾을 수 없습니다"

😭 어느 프로젝트 폴더에서 열어도 MCP가 안 잡혀요!

🔍 원인을 찾았어요: Claude Code는 "내 폴더"만 봐요

한참 삽질하다가 깨달았어요.

Claude Code는 "내가 시작한 폴더"의 .mcp.json만 찾아요.

부모 폴더까지 올라가서 찾아보지 않아요!

📁 _work/
├── .mcp.json                    ← 여기에 있는데...
│
├── 📁 회사-프로젝트-A/          ← Claude Code는 여기서 시작됨
│   └── (비어있음)               ← .mcp.json이 없네? → MCP 없음!
│
├── 📁 회사-프로젝트-B/          ← 여기서 시작하면?
│   └── (비어있음)               ← 여기도 없음 → MCP 없음!
│
└── 📁 회사-프로젝트-C/               ← 여기서 시작하면?
    └── (비어있음)               ← 마찬가지 → MCP 없음!

Claude Code 입장에서는:

"나는 '회사-프로젝트-A' 폴더에서 시작했어"
"이 폴더에 .mcp.json 있어? → 없네"
"그럼 MCP 없는 거야"
(부모 폴더인 _work는 안 봄)

1탄의 구조가 틀린 게 아니에요. 다만 Claude Code가 하위 프로젝트 폴더에서 상위 폴더 설정을 자동으로 안 읽어주는 거예요.

🤔 그럼 어떻게 해야 하죠?

두 가지 선택지가 있어요:

방법

설명

문제점

❌ 프로젝트마다 복사

모든 프로젝트에 .mcp.json 복사

노가다, 키 바뀌면 다 수정해야 함

✅ 바로가기 사용

상위 폴더를 가리키는 바로가기 생성

이게 정답!

"바로가기"가 뭐냐고요? 지금부터 설명할게요!

🤯 첫 번째 시도: "그냥 복사하면 되지 않나?"

📁 _work/
├── .mcp.json
├── 회사-프로젝트-A/
│   └── .mcp.json     ← 복사!
├── 회사-프로젝트-B/
│   └── .mcp.json     ← 또 복사!
├── 회사-프로젝트-C/
│   └── .mcp.json     ← 또또 복사!
└── 회사-프로젝트-D/
    └── .mcp.json     ← 또또또 복사!

문제점:

상황

결과

프로젝트 10개면?

10번 복사

API 키 바뀌면?

10개 파일 다 수정

새 프로젝트 만들면?

복사하는 거 까먹음 → MCP 안 됨

노가다에요. 그리고 언젠가 반드시 까먹어요.

💡 바로가기를 쓰면 되잖아!

윈도우에서 "바로가기" 써보셨죠? 맥에서는 "별칭(Alias)"이라고도 해요.

진짜 파일은 하나인데, 여러 곳에서 그 파일을 가리키는 것.

🖥️ 바탕화면
├── 🔗 Chrome 바로가기    → 진짜 Chrome은 Applications 폴더에
├── 🔗 VS Code 바로가기   → 진짜 VS Code도 Applications에
└── 🔗 Slack 바로가기     → 마찬가지

바로가기를 더블클릭하면? 진짜 프로그램이 실행되잖아요.

이걸 .mcp.json에 써먹으면 돼요!

🔗 "심볼릭 링크" = 개발자들의 바로가기

개발자들은 이 바로가기를 심볼릭 링크(Symbolic Link)라고 불러요.

이름이 어려워 보이지만, 그냥 바로가기예요.

📁 _work/
├── .mcp.json                      ← 🏠 진짜 파일 (원본)
│
├── 회사-프로젝트-A/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기!
├── 회사-프로젝트-B/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기!
└── 회사-프로젝트-C/
    └── .mcp.json → ../.mcp.json   ← 🔗 바로가기!

→ ../.mcp.json가 뭐냐고요?

.. = "한 칸 위 폴더" (부모 폴더 = _work)
/.mcp.json = "그 폴더의 .mcp.json 파일"

그러니까 "부모 폴더에 있는 .mcp.json을 봐!"라는 뜻이에요.

✨ 바로가기의 마법

이제 어떻게 되는지 볼까요?

📁 _work/
├── .mcp.json                           ← 회사 Linear 키 (원본)
└── 회사-프로젝트-A/
    └── .mcp.json → ../.mcp.json        ← 바로가기

하위 폴더에서 클로드코드를 열어서..!

나: cd ~/Documents/DEV/_work/회사-프로젝트-A
나: claude (Claude Code 시작)

Claude Code: ".mcp.json 어딨지... 있네!"
Claude Code: "어? 이거 바로가기네. 따라가볼까..."
Claude Code: "_work/.mcp.json을 읽었어!"
Claude Code: "회사 Linear 키로 설정 완료!"

나: "Linear에서 이번 스프린트 이슈 가져와줘"
Claude Code: "네! 3개의 이슈를 찾았습니다..." ✅

드디어 됐다! 🎉

프로젝트 폴더에 진짜 파일이 없어도, 바로가기를 따라가서 원본을 읽어요!

🎉 바로가기의 장점

장점

설명

✅ 파일 하나만 관리

_work/.mcp.json 하나만 수정하면 끝

✅ 키 바꿔도 OK

원본만 바꾸면 모든 프로젝트에 반영

✅ 용량 0

바로가기는 용량을 거의 안 먹어요

✅ Git에 안 올라감

.gitignore에 추가하면 안전

🤔 근데 바로가기도 매번 만들어야 해?

여기서 의문이 생겨요:

"바로가기 좋은 건 알겠는데... 새 프로젝트 만들 때마다 직접 만들어야 하는 거야?"

아니요! 자동화하면 돼요.

폴더에 들어가기만 하면 바로가기가 자동으로 생기게 할 수 있어요.

상황

자동화 전

자동화 후

새 프로젝트 폴더 만들고 들어감

바로가기 직접 만들어야 함

자동으로 생김!

기존 프로젝트 폴더로 이동

바로가기 있는지 확인해야 함

없으면 자동 생성!

한 번 자동화 설정하면 영원히 자동이에요.

설정 방법은 아래에서 설명할게요!

🛠️ Claude Code에게 설정 부탁하기

개발자가 아니라면 직접 명령어를 칠 필요 없어요. Claude Code에게 시키면 돼요!

📝 Claude Code에게 이렇게 말하세요

_work 폴더와 _personal 폴더의 모든 하위 프로젝트에 상위 폴더의 .mcp.json을 가리키는 심볼릭 링크를 만들어줘

Claude Code가 알아서 해줄 거예요:

_work/회사-프로젝트-A/.mcp.json → _work/.mcp.json 바로가기 생성
_work/회사-프로젝트-B/.mcp.json → _work/.mcp.json 바로가기 생성
_work/회사-프로젝트-C/.mcp.json → _work/.mcp.json 바로가기 생성
_personal/개인-프로젝트-A/.mcp.json → _personal/.mcp.json 바로가기 생성
... (모든 프로젝트에 자동으로!)

🚪 자동화 스크립트란?

뭔가요?

"폴더 들어갈 때마다 자동으로 뭔가 해주는 기능"이에요.

마트 자동문처럼요. 내가 뭔가 누르거나 할 필요 없이, 들어가기만 하면 문이 열리는 것처럼요.

어디에 저장돼요?

~/.zshrc 파일에 저장돼요.

이게 뭐냐면, 터미널이 시작할 때 자동으로 읽는 설정 파일이에요.

📁 내 컴퓨터
└── 📁 Users/
    └── 📁 나/
        └── .zshrc     ← 🔧 터미널 설정 파일 (여기에 저장!)

💡 .zshrc는 "숨김 파일"이라서 Finder에서 안 보여요. 하지만 Claude Code는 읽고 쓸 수 있어요!

언제 실행돼요?

터미널에서 폴더를 이동할 때마다 실행돼요.

나: (터미널에서 폴더 이동)
   ↓
터미널: ".zshrc에 뭔가 있나? 실행해볼게"
   ↓
자동화 스크립트: "_work 밑이네! 바로가기 만들어줄게"
   ↓
터미널: "🔗 MCP 설정 연결됨!"

어떻게 만들어요?

Claude Code에게 시키면 돼요!

"앞으로 _work나 _personal 하위 폴더로 이동할 때 자동으로 상위 .mcp.json 바로가기가 생기도록 .zshrc에 자동화 스크립트 추가해줘"

Claude Code가 .zshrc 파일을 열어서 자동화 코드를 넣어줄 거예요.

자동화가 되면 이렇게 작동해요

📁 _work/
├── .mcp.json
│
└── 📁 새-프로젝트/     ← 새로 만든 폴더 (아직 바로가기 없음)

터미널에서 이 폴더로 이동하면: (혹은 해당 폴더에서 클로드코드를 실행하면)

나: (터미널에서) cd ~/Documents/DEV/_work/새-프로젝트
   ↓
자동 스크립트: "어? _work 밑이네. 바로가기 있어?"
   ↓
자동 스크립트: "없네! 만들어줄게."
   ↓
터미널: "🔗 MCP 설정 연결됨!"

📁 _work/
├── .mcp.json
│
└── 📁 새-프로젝트/
    └── .mcp.json → ../.mcp.json   ← 🔗 자동으로 생김!

새 프로젝트 폴더에 들어가기만 하면, 자동으로 바로가기가 생겨요!

🗂️ 최종 구조

📁 _work/
├── .mcp.json                      ← 🏠 원본 (회사 Linear 키)
├── .env                           ← 🔐 회사 환경변수
│
├── 회사-프로젝트-A/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기
├── 회사-프로젝트-B/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기
├── 회사-프로젝트-C/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기
└── (새 프로젝트)/
    └── .mcp.json → ../.mcp.json   ← 🔗 자동 생성!

📁 _personal/
├── .mcp.json                      ← 🏠 원본 (개인 Linear 키)
├── .env                           ← 🔐 개인 환경변수
│
├── 개인-프로젝트-A/
│   └── .mcp.json → ../.mcp.json   ← 🔗 바로가기
└── (새 프로젝트)/
    └── .mcp.json → ../.mcp.json   ← 🔗 자동 생성!

🎬 설정 후에는 이렇게 돼요

✅ 회사-프로젝트-A 폴더에서 Claude Code 열면

📁 _work/
├── .mcp.json                      ← 원본
│
└── 📁 회사-프로젝트-A/             ← ⭐ 여기서 Claude Code 열면
    └── .mcp.json → ../.mcp.json   ← 바로가기가 원본을 가리킴!

나: "Linear에서 이슈 가져와줘"
Claude Code: "네! 5개의 이슈가 있어요..." ✅

✅ 개인 프로젝트 폴더에서는 개인 키로!

📁 _personal/
├── .mcp.json                      ← 개인 Linear 키 (원본)
│
└── 📁 개인-프로젝트-A/             ← ⭐ 여기서 Claude Code 열면
    └── .mcp.json → ../.mcp.json   ← 개인 키를 가리킴!

나: "내 이슈 보여줘"
Claude Code: "2개의 이슈가 있어요..." ✅

✅ 새 프로젝트 만들어도 자동으로!

📁 _work/
├── .mcp.json
│
└── 📁 회사-프로젝트-E/             ← 새로 만든 폴더
    └── .mcp.json → ../.mcp.json   ← 🔗 자동으로 생김!

새 프로젝트 만들고 들어가기만 하면 끝! 설정 파일 복사? 필요 없어요.

🆚 비교: 전 vs 후

상황

예전 (노가다)

지금 (자동화)

새 프로젝트 시작

.mcp.json 복사해야 함

폴더 들어가면 자동 생성

API 키 변경

모든 프로젝트 파일 수정

원본 1개만 수정

설정 까먹음

MCP 안 됨 → 삽질

자동이라 까먹을 일 없음

프로젝트 10개

파일 10개 관리

원본 1개 + 바로가기

📌 정리

개념

쉬운 말

심볼릭 링크

바로가기

원본 .mcp.json

_work/나 _personal/에 있는 진짜 설정 파일

바로가기 .mcp.json

하위 프로젝트에서 원본을 가리키는 것

자동화 스크립트

폴더 들어갈 때 바로가기 자동 생성

✅ Claude Code에게 시킬 체크리스트

Claude Code에게 순서대로 말하세요:

"_work/.mcp.json에 회사 Linear 키 설정해줘"
- 회사 Linear API 토큰 필요
"_personal/.mcp.json에 개인 Linear 키 설정해줘"
- 개인 Linear API 토큰 필요
"_work랑 _personal 하위 폴더 전부에 MCP 심볼릭 링크 만들어줘"
- 기존 프로젝트에 바로가기 생성
".zshrc에 MCP 자동 링크 스크립트 추가해줘"
- 앞으로 새 프로젝트에 자동 적용
"제대로 됐는지 확인해줘"
- 아무 프로젝트 폴더의 .mcp.json이 심볼릭 링크인지 확인

더 이상 설정 파일 걱정 없이, 코딩에만 집중하세요! 🚀

📮 4만 5천 명이 받는 AI 뉴스레터 구독하기