클라이언트 TUI
TUI는 인스펙터의 터미널 인터페이스로, 웹 클라이언트와 마찬가지로 도구, 리소스, 프롬프트를 대화형 방식으로 탐색할 수 있습니다. SSH를 통해 원격 호스트에서 사용하거나, 보안이 강화된 환경에서, 혹은 계속해서 터미널 환경을 선호할 때 이를 활용할 수 있습니다.
npx @modelcontextprotocol/inspector --tui node build/index.js # with an ad-hoc stdio server
서버 선택하기
CLI와 달리 TUI에는 특정 항목을 선택하기 위한 --server <name> 플래그가 존재하지 않습니다. 대신 TUI는 카탈로그나 설정 파일에서 서버 목록을 읽어들여 그 안에 있는 모든 서버를 로드한 후 화면에 표시된 목록에서 선택하도록 합니다:
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와 같은 옵션이 없으며 ad-hoc target 기능도 지원되지 않으므로, 기본적으로 사용되는 쓰기 가능한 카탈로그인 ~/.mcp-inspector/mcp.json가 사용됩니다. 자세한 내용은 Configuration and flags를 참조하십시오.
탭
| 탭 | 키 | 표시되는 내용 |
|---|---|---|
| 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작업 없이 자동으로 연결이 완료됩니다. - 결과로 생성된 OAuth 상태를 확인하거나 이를 삭제하려면 Auth 탭을 사용합니다.
TUI의 콜백 리스너는 기본적으로 http://127.0.0.1:6276/oauth/callback을 사용합니다. 포트는 의도적으로 고정되어 있습니다. 사전 등록된 정적 OAuth 클라이언트, 클라이언트 ID 메타데이터 문서(CIMD), 기업 관리형 IdP 모두 미리 알려진 리디렉션 URI가 필요하기 때문입니다. 이 URI를 한 번 등록하면 여러 세션에서 계속 사용할 수 있습니다. 브라우저가 다른 컴퓨터에 있는 원격 호스트에서는 리디렉션 요청이 이 리스너에 도달하도록 콜백 포트를 포워딩해야 합니다. 자세한 내용은 콜백 URL을 참고하세요.
단점은 한 번에 하나의 TUI OAuth 흐름만이 해당 포트를 사용할 수 있다는 것입니다. 동시에 두 번째 흐름을 실행하면 EADDRINUSE 오류가 발생합니다. 이 문제를 해결하려면 --callback-url를 전달하거나 MCP_OAUTH_CALLBACK_URL을 설정하여 각 인스턴스마다 다른 고정 포트를 사용하거나, 권한 부여 서버가 리디렉션 URI를 동적으로 등록할 때는 OS가 할당하는 일시적 포트인 http://127.0.0.1:0/oauth/callback를 사용해야 합니다.
카탈로그에 포함된 서버별 OAuth 설정(정적 클라이언트 ID/비밀번호, 범위, 기업 관리 플래그)은 자동으로 적용됩니다. 전체 설치에 적용되는 설정(CIMD, 기업 IdP)은 웹 클라이언트의 Client Settings 대화상자가 데이터를 저장하는 ~/.mcp-inspector/storage/client.json 파일에서 가져옵니다. --client-config 또는 MCP_CLIENT_CONFIG_PATH을 사용하여 다른 파일을 지정할 수 있습니다.
자세한 내용은 Authorization를 참조하십시오.
요구 사항
TUI는 원시 모드를 지원하는 실제 TTY가 필요합니다. 헤드리스 CI 작업 환경에서는 제대로 작동하지 않으므로, 해당 환경에서는 CLI를 사용하십시오.