TUI 클라이언트

TUI 클라이언트 (TUI client)

터미널용 MCP Inspector로, 내비게이션·탭·키보드 참조를 다루는 문서예요. TUI는 Inspector의 터미널 인터페이스로, Web 클라이언트처럼 도구·리소스·프롬프트를 상호작용적으로 탐색할 수 있습니다.

출처: 문서

본문

TUI는 Inspector의 터미널 인터페이스예요. Web 클라이언트와 같은 방식으로 도구, 리소스, 프롬프트를 상호작용적으로 탐색할 수 있어요. SSH로 원격 호스트에서 사용하거나, 잠긴 환경에서, 또는 터미널에 머물고 싶을 때 쓰세요.

npx @modelcontextprotocol/inspector --tui node build/index.js   # with an ad-hoc stdio server

서버 선택하기

CLI와 달리 TUI에는 항목 하나를 고르는 --server <name> 플래그가 없어요. 카탈로그나 구성 파일에서 서버를 읽고, 파일의 모든 서버를 로드한 다음, 화면의 목록에서 고르게 합니다.

mcp-inspector --tui --catalog mcp.json   # writable catalog, seeded empty if missing (unlike the web client)
mcp-inspector --tui --config mcp.json    # read-only session, errors if absent

--catalog도 --config도, 임시 대상도 없으면 기본 쓰기 가능 카탈로그 ~/.mcp-inspector/mcp.json을 사용해요. 구성과 플래그를 참고하세요.

탭 (Tabs)

탭	키	표시 내용
Info	`i`	서버 정보, 기능, 협상된 프로토콜 세부 사항.
Auth	`a`	선택한 서버의 OAuth 상태와 Clear OAuth state 동작.
Resources	`r`	리소스 탐색 및 읽기.
Prompts	`m`	프롬프트 나열 및 인수로 렌더링.
Tools	`t`	도구 보기 및 폼 같은 입력으로 실행.
Protocol	`p`	JSON-RPC 요청/응답/알림 기록.
Network	`n`	SSE와 Streamable HTTP 서버의 HTTP 트래픽.
Console	`o`	연결된 stdio 서버 프로세스의 `stderr`.

가속 키는 항상 첫 글자를 쓰지 않고 충돌을 피해요. Protocol이 p를 가져가서 Prompts가 m을, Console이 o를 가져가는데 c는 전역 Connect 동작이기 때문이죠.

키	동작
`Left`/`Right` 화살표 또는 `Tab`	탭 전환
`Up`/`Down` 화살표	현재 목록에서 이동
`Enter`	항목 선택, 도구 실행, 또는 리소스 가져오기
`c`	선택한 서버에 연결
`d`	연결 해제
`Esc` 또는 `Ctrl+C`	종료

HTTP 서버 인증

HTTP 또는 SSE 서버를 선택하고 **c**를 눌러 연결하세요.
서버가 인증을 요구하면 TUI가 OAuth를 자동으로 시작하고 브라우저에서 인증 URL을 엽니다.
브라우저 리다이렉트가 TUI의 루프백 리스너에 도착하면, 두 번째 c 없이 연결이 저절로 완료됩니다.
Auth 탭으로 결과 OAuth 상태를 검사하거나 지우세요.

TUI의 콜백 리스너는 기본적으로 http://127.0.0.1:6276/oauth/callback입니다. 포트는 의도적으로 고정되어 있어요. 사전 등록된(정적) OAuth 클라이언트, Client ID Metadata Document(CIMD), 또는 엔터프라이즈 관리 IdP 모두 미리 알려진 리다이렉트 URI가 필요하죠. 그 URI를 한 번 등록하면 세션 전반에서 작동해요. 브라우저가 다른 머신에 있는 원격 호스트에서는 콜백 포트를 포워딩해서 리다이렉트가 이 리스너에 도달하게 하세요. 콜백 URL 참고.

트레이드오프는 한 번에 하나의 TUI OAuth 흐름만 그 포트를 잡을 수 있다는 것이에요. 동시에 도는 두 번째 흐름은 EADDRINUSE로 실패합니다. 이를 덮어쓰려면 --callback-url을 전달하거나 MCP_OAUTH_CALLBACK_URL을 설정하세요. 인스턴스당 다른 고정 포트를 사용하거나, 인증 서버가 리다이렉트 URI를 동적으로 등록할 때 OS가 할당하는 임시 포트용 http://127.0.0.1:0/oauth/callback을 사용하면 됩니다.

리다이렉트 URI는 등록한 것과 정확히 일치해야 해요. 인증 서버가 보기에 localhost와 127.0.0.1은 다른 URI입니다.

카탈로그의 서버별 OAuth 필드(정적 클라이언트 ID/시크릿, 스코프, 엔터프라이즈 관리 플래그)는 자동으로 적용돼요. 설치 전체 설정(CIMD, 엔터프라이즈 IdP)은 Web 클라이언트의 Client Settings 대화 상자도 쓰는 ~/.mcp-inspector/storage/client.json에서 와요. 다른 것을 가리키려면 --client-config나 MCP_CLIENT_CONFIG_PATH를 사용하세요.

전체 그림은 인증을 참고하세요.

요구 사항

TUI는 원시 모드를 지원하는 실제 TTY가 필요해요. 헤드리스 CI 작업에서는 유용하게 실행되지 않으니, 거기서는 CLI를 사용하세요.

TUI 클라이언트