MCP 서버 관리 완전 가이드

add·list·get·remove 4가지 커맨드와 스코프 운용법

1장, 2장에서도 add / get / list / remove는 사용했지만, 어디까지나 "filesystem 서버를 동작시킨다" "stdio와 HTTP의 차이를 체감한다"를 위한 수단이었습니다. 이번 회차에서는 이러한 커맨드 자체에 초점을 맞춥니다.

환경 변수의 전달 방법 (-e 옵션, JSON 설정 파일의 env 필드)

스코프의 우선순위와 의도하지 않은 덮어쓰기 회피

설정 변경 시의 삭제 → 재등록 패턴

자주 있는 실수와 그 대처법

즉, 1장·2장에서 "MCP 서버를 사용해본다"였다면, 3장은 "MCP 서버를 올바르게 관리한다" 를 위한 장입니다.

전제 조건

1장·2장를 완료했을 것

~/mcp-workspace 프로젝트가 존재할 것

filesystem, memory MCP 서버가 등록되어 있을 것 (2장에서 등록)

GitHub CLI 툴(gh)이 설치되어 있으면 바람직함

이번 장의 목표

MCP 서버의 4가지 관리 커맨드(add / list / get / remove)를 체계적으로 이해하여 여러 MCP 서버를 효율적으로 관리할 수 있게 됩니다. GitHub MCP 서버를 "외부 서비스 통합 워크스페이스"에 추가합니다.

배경 지식

MCP 서버 관리의 전체 구조

Claude Code에서는 MCP 서버의 라이프사이클을 4가지 커맨드로 관리합니다.

각 커맨드의 개요

중요: 이러한 커맨드는 모두 터미널에서 실행합니다. Claude Code의 대화 모드(채팅) 내에서는 MCP 서버의 추가·삭제는 할 수 없습니다. 대화 모드 내에서 MCP 서버의 상태를 확인하려면 /mcp 슬래시 커맨드를 사용합니다.

스코프의 개념 (복습과 심화)

MCP 서버의 등록에는 스코프가 있으며, 설정의 적용 범위를 제어합니다.

스코프의 우선순위는 local > project > user입니다. 동명의 서버가 여러 스코프에 존재하는 경우, 더 한정적인 스코프가 우선됩니다. 스코프를 생략한 경우의 기본값은 local 입니다.

� 한국 팀 개발 환경에서의 스코프 운용 가이드

따라하기

1단계: claude mcp add의 상세

claude mcp add의 완전한 구문을 확인합니다.

stdio 서버의 추가:

claude mcp add --transport stdio --scope <scope> <n> -- <command> [args...]

HTTP 서버의 추가:

claude mcp add --transport http --scope <scope> <n> <url>

각 파라미터의 의미:

※ <command>는 stdio의 경우에 필수, <url>은 HTTP의 경우에 필수입니다.

2단계: 환경 변수를 포함하여 서버를 추가한다

MCP 서버에 환경 변수를 전달해야 하는 경우(GitHub PAT, Slack 토큰 등)의 두 가지 방법을 확인합니다.

방법 1: -e 플래그로 직접 전달