설정과 플래그

설정과 플래그 (Configuration and flags)

출처: MCP 공식 문서 — Configuration and flags

mcp-inspector 바이너리는 실행기(launcher)예요. 자기 플래그 두 개를 읽고 나머지 인자는 전부 세 클라이언트(웹, CLI, TUI) 중 하나로 전달해요. 각 클라이언트는 자기 플래그를 정의하므로, 한 곳에서 되던 플래그가 다른 곳에선 알려지지 않을 수 있어요. --method, 예를 들면 CLI 전용이죠. 이 페이지는 플래그와 환경 변수를 소유한 클라이언트별로 묶어 설명해요.

실행기는 딱 두 가지만 소유

아래는 전부 클라이언트에 속해요.

서버 고르기

--catalog vs --config

세 클라이언트 모두 --catalog와 --config를 같은 공용 코드로 해석해서, 각 플래그는 웹 앱·CLI·TUI에서 동일하게 동작해요. 둘이 서로 다른 점은 아래 표와 같아요.

둘은 상호 배타적이고, 임시 대상과도 결합하지 않아요. 둘 다 넘기면 세 클라이언트 모두 동일하게 거부해요.

갓 시드된 카탈로그에 뭐가 들어 있는지는 클라이언트에 따라 달라요. 웹 백엔드는 샘플 서버 두 개를 시드해서, 첫 실행에 바로 연결할 게 있게 해요.

{
  "mcpServers": {
    "filesystem-server-default": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "everything-server-default": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

CLI와 TUI는 대신 빈 { "mcpServers": {} }를 시드해요. 비대화형이거나 목록 기반이라 샘플 항목이 출발점이 아니라 잡음이 되니까요.

어느 쪽이든 시드는 파일이 아직 없을 때만 일어나고, 읽기 전용 --config는 절대 시드되지 않아요.

--config는 여러분이 쓰지 않은 설정 파일—동료의, 클라이언트 앱의, 아니면 저장소에 커밋된—을 Inspector에 가리킬 때 원하는 선택이에요. Inspector가 그 파일을 건드리지 않음을 보장해요.

임시 대상

파일 대신 서버 하나를 직접 이름 지을 수 있어요. 위치 인자 명령(stdio) 또는 URL로요.

mcp-inspector node build/index.js                              # stdio, 위치 인자
mcp-inspector --server-url https://api.example.com/mcp --transport http

공용 서버 선택 플래그

웹, CLI, TUI 각각이 별도로 정의해서 세 곳 모두에서 쓸 수 있고, 차이가 있으면 표기해요.

-- 구분자

웹과 CLI 클라이언트는 인자를 맨 --에서 나누고 그 뒤는 전부 대상 명령의 자기 인자로 넘겨요. Inspector가 삼킬 플래그를 넘기는 방법이죠.

mcp-inspector node build/index.js -- --config /etc/myserver.conf --verbose

구분자가 없으면 --config는 Inspector 자신의 읽기 전용 세션 플래그로 읽힐 거예요.

웹 전용 플래그

CLI와 TUI: OAuth 클라이언트 플래그

이 다섯 개는 CLI와 TUI만 정의해요. 웹 클라이언트는 Client Settings 대화상자에서 같은 설정을 얻어요.

CLI 전용 플래그

스크립팅 표면 전체가 CLI에 속해요. 사용법은 CLI client에서 볼 수 있어요.

환경 변수

환경 변수도 플래그처럼 나뉘는데, 두 개는 실행기가 읽고 나머지는 CLI·TUI 또는 웹 백엔드에 속해요.

실행기가 읽는 것

CLI와 TUI

웹 백엔드 환경 변수

DANGEROUSLY_OMIT_AUTH와 DANGEROUSLY_BIND_ALL_INTERFACES를 함께 쓰지 마세요. 웹 백엔드는 프로세스를 띄우고 OAuth 토큰을 쥐고 있으므로, 도달할 수 있는 누구든 그것을 조종할 수 있어요.

카탈로그 파일 형식

카탈로그나 설정 파일은 익숙한 MCP 클라이언트 설정 모양(mcpServers 객체)에 서버별 Inspector 설정이 곁들여진 형태예요.

{
  "mcpServers": {
    "my-stdio-server": {
      "command": "node",
      "args": ["build/index.js"],
      "env": { "API_KEY": "..." }
    },
    "my-modern-server": {
      "type": "http",
      "url": "https://api.example.com/mcp",
      "protocolEra": "modern",
      "modernLogLevel": "info",
      "headers": { "X-Tenant": "acme" },
      "roots": [{ "uri": "file:///Users/me/project", "name": "project" }]
    }
  }
}

기본값과 같은 필드는 Inspector가 파일을 다시 쓸 때 생략해서 diff를 최소화해요. protocolEra(Protocol eras 참고)는 기본 legacy, modernLogLevel은 기본 debug예요.

직접 손으로 쓸 필요는 없어요. 웹 클라이언트는 기존 클라이언트 설정 불러오기로 Claude Desktop, Cursor, Cline, VS Code 또는 레지스트리 server.json에서 가져올 수 있어요.

더 알아보기 (Learn more)

• MCP 공식 문서 — Configuration and flags
• MCP 공식 문서 — CLI client
• MCP 공식 문서 — Protocol eras