MCP Inspector
MCP 서버를 시각적으로 테스트하고 디버깅하는 공식 개발자 도구
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- MCP · 로컬 stdio
- 인증
- API 키·토큰 또는 서비스 자격증명
- 비용
- 서버는 무료 공개, 연결 서비스 비용은 별도 확인
- 제공 상태
- 공개 제공
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
초기화·도구 목록·입력 스키마·응답 오류 중 어디서 연결이 깨지는지 구분하기 어려운 업무
- 어떤 어려움인가
- MCP 서버 연결을 디버깅하는 개발팀이 자주 마주치는 문제입니다. 구체적으로는 '초기화·도구 목록·입력 스키마·응답 오류 중 어디서 연결이 깨지는지 구분하기 어려운 업무' 상황입니다.
- 이렇게 해결합니다
- MCP Inspector 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '서버 실행 명령, 전송 방식, 시험 도구와 입력'입니다. 필요한 필드만 골라 '연결 단계별 성공·오류와 원문 응답이 있는 진단표' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 MCP Inspector 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '연결 단계별 성공·오류와 원문 응답이 있는 진단표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위서버 실행 명령, 전송 방식, 시험 도구와 입력업무 조건
- 02 · 현재 자료MCP InspectorMCP 도구 호출: 입력 범위는 '서버 실행 명령, 전송 방식, 시험 도구와 입력'입니다. 필요한 필드만 골라 '연결 단계별 성공·오류와 원문 응답이 있는 진단표' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '연결 단계별 성공·오류와 원문 응답이 있는 진단표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과연결 단계별 성공·오류와 원문 응답이 있는 진단표
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
연결 단계별 성공·오류와 원문 응답이 있는 진단표을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '초기화·도구 목록·입력 스키마·응답 오류 중 어디서 연결이 깨지는지 구분하기 어려운 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- MCP Inspector 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '서버 실행 명령, 전송 방식, 시험 도구와 입력'입니다. 필요한 필드만 골라 '연결 단계별 성공·오류와 원문 응답이 있는 진단표' 형태로 정리합니다. 다음 단계인 Everything (레퍼런스 테스트 서버)에서는 '기능별 통과 여부와 표시 문제를 기록한 호환성 체크리스트' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- MCP Inspector의 결과에는 원문 식별자와 처리 시각을 붙여 Everything (레퍼런스 테스트 서버)로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '연결 단계별 성공·오류와 원문 응답이 있는 진단표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '기능별 통과 여부와 표시 문제를 기록한 호환성 체크리스트'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력서버 실행 명령, 전송 방식, 시험 도구와 입력정리된 입력
- 02 · 현재 자료MCP Inspector연결 단계별 성공·오류와 원문 응답이 있는 진단표근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
초기화·도구 목록·입력 스키마·응답 오류 중 어디서 연결이 깨지는지 구분하기 어려운 업무를 반복 운영해야 할 때
- 어떤 어려움인가
- '초기화·도구 목록·입력 스키마·응답 오류 중 어디서 연결이 깨지는지 구분하기 어려운 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- MCP Inspector 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '서버 실행 명령, 전송 방식, 시험 도구와 입력'입니다. 필요한 필드만 골라 '연결 단계별 성공·오류와 원문 응답이 있는 진단표' 형태로 정리합니다. 보강은 Everything (레퍼런스 테스트 서버), 전달과 후속 처리는 Skill: MCP Builder로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 MCP Inspector → Everything (레퍼런스 테스트 서버) → Skill: MCP Builder 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '연결 단계별 성공·오류와 원문 응답이 있는 진단표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력서버 실행 명령, 전송 방식, 시험 도구와 입력과 작업 ID작업 요청
- 자동 처리02 · 현재 자료MCP Inspector연결 단계별 성공·오류와 원문 응답이 있는 진단표1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
연결
npx @modelcontextprotocol/inspectorMCP Inspector는 MCP 서버를 테스트하고 디버깅하기 위한 개발자 도구입니다. 대화형 인터페이스를 제공하는 React 기반 웹 UI(MCPI)와, 그 UI를 여러 전송 방식으로 MCP 서버에 연결하는 Node.js 프로토콜 브리지(MCPP) 두 부분으로 구성됩니다.
주요 기능
- UI 모드: 브라우저에서 폼 형태로 파라미터를 입력하고 응답을 실시간으로 확인하며, 리소스는 계층 탐색과 JSON 시각화로 살펴봅니다
- CLI 모드: 명령줄에서 서버와 상호작용해 스크립팅과 자동화, 코딩 어시스턴트 연동에 활용합니다
- 서버 설정 내보내기: 단일 서버 항목이나 mcp.json 전체를 복사해 Cursor, Claude Code 같은 클라이언트에 그대로 사용합니다
- 보안 설정: 기본적으로 세션 토큰 인증을 적용하고 프록시와 클라이언트를 localhost에만 바인딩하며 Origin 헤더 검증으로 DNS 리바인딩을 방어합니다
준비물은 Node.js ^22.7.5이며 `npx @modelcontextprotocol/inspector`로 실행하면 UI가 localhost:6274에서 열립니다. 빌드된 서버를 검사하려면 뒤에 실행 명령을 붙이고, `-e key=value` 형태로 환경변수를 전달하거나 `--cli` 플래그로 CLI 모드를 사용합니다. Docker 이미지도 제공되며 라이선스는 MIT입니다. 인증을 비활성화하면 공개 인터넷뿐 아니라 브라우저를 통한 공격에도 노출된다는 경고가 문서에 명시돼 있습니다.
직접 만든 MCP 서버가 규격대로 동작하는지 확인해야 하는 개발자에게 필요한 도구입니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.