MCP 설정 파일 관리 완전 가이드

--mcp-config 프로파일 분리·팀 공유·자동화 기동 스크립트

--mcp-config를 활용하여 MCP 서버를 설정 파일 기반으로 일괄 관리하는 방법을 이해하고, 효율적인 셋업을 실현합니다. ~/mcp-workspace에 설정 파일을 도입하여 관리합니다.

배경 지식

설정 파일 기반 관리란

2장·3장에서도 --mcp-config는 등장했지만, 이번 회차에서는 그것을 본격적으로 활용합니다.

claude mcp add로 등록한 서버는 .mcp.json에 저장되어 claude 기동 시에 자동으로 읽어 들여집니다. 간편하지만 프로젝트에서 사용하는 서버가 늘어나면 유연성이 부족해집니다.

반면 --mcp-config로 설정 파일을 지정하는 방법은, 기동 시에 매번 파일을 지정하는 수고가 있지만,

용도별로 설정 파일을 나누어 사용할 MCP 서버를 기동 시에 전환할 수 있습니다. 예를 들어 "기본 툴만" "기본+GitHub 연계" "전부 포함"처럼, 장면에 따른 서버 구성을 구분하여 사용할 수 있습니다.

수동 관리 vs 설정 파일 관리

MCP 설정의 배치 위치

MCP 설정은 스코프에 따라 다른 위치에 배치됩니다.

사용자 설정 (user):
~/.claude/settings.json

프로젝트 설정 (project):
<project-root>/.mcp.json

로컬 설정 (local):
로컬 설정 파일 (버전 관리 밖)

� 한국 팀 운용 팁
.mcp.json(프로젝트 스코프)은 1장에서 Skill을 Git 관리한 것처럼 리포지토리에 포함하여 팀 공유합니다. 인증 정보가 없는 서버는 .mcp.json에, 개인 토큰이 필요한 서버는 --mcp-config로 별도 관리하는 분리 전략이 효과적입니다.

따라하기

1단계: --mcp-config에 의한 설정 파일 읽기

--mcp-config 옵션으로, JSON 파일에서 MCP 설정을 읽어 들일 수 있습니다.

cat > ~/mcp-workspace/config/mcp-plugin-config.json << 'EOF'
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/mcp-workspace"]
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
EOF

claude --mcp-config ~/mcp-workspace/config/mcp-plugin-config.json

중요: /Users/yourname/ 부분은 자신의 홈 디렉토리로 교체하세요. macOS: /Users/사용자명/, Linux: /home/사용자명/

2단계: 복수의 설정 파일을 조합한다

--mcp-config는 복수로 지정할 수 있습니다. 용도별로 설정 파일을 분할하여, 필요한 것만 조합하여 사용할 수 있습니다.

# 기본 툴용 설정 (인증 불필요 — Git 관리 OK)
cat > ~/mcp-workspace/config/mcp-base.json << 'EOF'
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/mcp-workspace"]
}
}
}
EOF

# 개발 툴용 설정 (인증 불필요 — Git 관리 OK)
cat > ~/mcp-workspace/config/mcp-dev.json << 'EOF'
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
EOF

# GitHub 연계용 설정 (인증 정보를 포함 — .gitignore 필수)
cat > ~/mcp-workspace/config/mcp-github.json << 'EOF'
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
}
}
}
}
EOF

조합하여 기동합니다.

# 기본 툴만 (filesystem)
claude --mcp-config ~/mcp-workspace/config/mcp-base.json

# 기본 툴 + 개발 툴 (filesystem + memory)
claude --mcp-config ~/mcp-workspace/config/mcp-base.json \
--mcp-config ~/mcp-workspace/config/mcp-dev.json

# 전부 포함 (filesystem + memory + github)
claude --mcp-config ~/mcp-workspace/config/mcp-base.json \
--mcp-config ~/mcp-workspace/config/mcp-dev.json \
--mcp-config ~/mcp-workspace/config/mcp-github.json

설정 파일 분류 전략: