구성과 플래그

구성과 플래그 (Configuration and flags)

카탈로그 대 구성 파일, 각 클라이언트가 소유한 플래그, 그리고 모든 환경 변수를 다루는 문서예요. mcp-inspector 바이너리는 런처로, 자신의 플래그 두 개를 읽고 다른 모든 인수를 세 클라이언트(web, CLI, TUI) 중 하나에 전달합니다.

출처: 문서

본문

mcp-inspector 바이너리는 런처예요. 두 개의 자체 플래그를 읽고 나머지 모든 인수를 세 클라이언트(web, CLI, TUI) 중 하나로 전달합니다. 각 클라이언트는 자신의 플래그를 정의하므로, 한 클라이언트에서 동작하는 플래그가 다른 클라이언트에는 알려지지 않을 수 있어요(--method는 예를 들어 CLI 전용). 이 페이지는 플래그와 환경 변수를 소유하는 클라이언트별로 묶어 놓았습니다.

런처가 정확히 두 가지를 소유

아래의 모든 것은 클라이언트에 속합니다.

서버 선택

--catalog 대 --config

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

둘은 상호 배타적이며, 어느 것도 임시 대상과 결합되지 않아요. 둘 다 전달하면 세 클라이언트 모두 동일하게 거부합니다.

갓 시드된 카탈로그의 내용은 클라이언트에 따라 달라요. Web 백엔드는 두 개의 샘플 서버를 시드해서 첫 실행에 연결할 것이 즉시 있게 합니다.

{
  "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가 그 파일을 건드리지 않음을 보장합니다.

임시 대상 (Ad-hoc targets)

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

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

공유 서버 선택 플래그

web, CLI, TUI 각각이 개별적으로 정의하므로 세 곳 모두에서 사용 가능하며, 차이는 아래에 명시했습니다.

-- 구분자

web과 CLI 클라이언트는 맨 --에서 인수를 분리해 그 뒤의 모든 것을 대상 명령에 자체 인수로 전달해요. 이렇게 하면 Inspector가 삼켜버릴 플래그를 전달할 수 있습니다.

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

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

Web 전용 플래그

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

이 다섯 개는 CLI와 TUI만 정의해요. Web 클라이언트는 Client Settings 대화 상자를 통해 같은 설정을 얻습니다.

CLI 전용 플래그

전체 스크립팅 표면은 CLI에 속해요. 사용법은 CLI 클라이언트를 참고하세요.

환경 변수

환경 변수는 플래그와 같은 방식으로 나뉩니다. 두 개는 런처 자신이 읽고, 나머지는 CLI와 TUI 또는 web 백엔드에 속합니다.

런처가 읽음

CLI와 TUI

Web 백엔드 환경 변수

DANGEROUSLY_OMIT_AUTH와 DANGEROUSLY_BIND_ALL_INTERFACES를 절대 결합하지 마세요. web 백엔드는 프로세스를 실행하고 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(프로토콜 시대 참고)는 기본 legacy, modernLogLevel은 기본 debug입니다.

이것을 손으로 쓸 필요는 없어요. Web 클라이언트는 Claude Desktop, Cursor, Cline, VS Code 또는 레지스트리 server.json에서 기존 클라이언트 구성을 가져올 수 있습니다.

더 알아보기 (Learn more)

• MCP Inspector
• CLI 클라이언트
• TUI 클라이언트
• 프로토콜 시대