Tool overview
MCP 서버 검증기이란?
MCP 서버 검증기은(는) mcpServers JSON 클라이언트 구성 검증 위한 개발자 도구입니다.
왜 MCP 서버 검증기을(를) 사용하나요?
mcpServers JSON 클라이언트 구성 검증할 때 가독성과 작업 속도를 높이며 서버로 데이터를 보내지 않습니다.
주요 기능
클라이언트 사이드 프라이버시, 즉시 결과, 원클릭 복사. mcpServers JSON 클라이언트 구성 검증
사용 방법
위 도구에서 정확한 결과를 얻기 위한 단계입니다.
- 최상위 "mcpServers" 객체가 있는 Cursor 또는 Claude Desktop JSON 구성을 붙여넣습니다.
- 린트 보고서에서 오류(차단)와 경고(비차단)를 JSON 포인터 경로와 함께 검토합니다.
- 전송을 수정합니다: stdio는 command(+ args), 원격은 유효한 http/https url이 필요합니다.
- env는 문자열만, args는 문자열 배열만 포함하는지 확인합니다.
- 가능하면 command+url 이중 항목과 경고로 표시된 알 수 없는 키를 제거합니다.
- ok가 true가 될 때까지 재검증 — 경고만으로는 실패하지 않지만 생산 부채로 취급합니다.
- 수정된 JSON을 클라이언트 구성에 다시 붙여넣고 MCP 서버를 다시 로드합니다.
- 팀 템플릿 공유 시 보고서를 PR/CI 체크리스트에 복사하고 시크릿은 자리표시자로 유지합니다.
MCP 검증기 — 완전 가이드 및 사용 사례
권위 있는 안내: 오류와 경고, stdio와 HTTP, Cursor/Claude Desktop, env 문자열 규칙, 수정 가이드, 시크릿 위생.
MCP Validator 가이드 — 여기서 시작
이 가이드는 mcpServers JSON 구성을 로컬에서 검증하는 방법을 설명합니다. 시크릿 없이 내용을 붙여넣고 Cursor 또는 Claude Desktop 전에 문제를 수정하세요.
MCP Validator가 하는 일
MCP Validator는 브라우저에서 mcpServers 항목, 전송 방식 및 JSON 타입을 검사하여 클라이언트가 시작할 수 없는 구성을 찾습니다.
JSON 경로와 실행 가능한 문제를 포함한 로컬 보고서
- JSON 경로와 실행 가능한 문제를 포함한 로컬 보고서
- JSON 경로와 실행 가능한 문제를 포함한 로컬 보고서: mcpServers, command, args, url, env
- JSON 경로와 실행 가능한 문제를 포함한 로컬 보고서: stdio, http, https
- JSON 경로와 실행 가능한 문제를 포함한 로컬 보고서: JSON, ok
MCP 구성을 붙여넣거나 공유하기 전에 사용
- MCP 구성을 붙여넣거나 공유하기 전에 사용
- MCP 구성을 붙여넣거나 공유하기 전에 사용: Cursor mcp.json
- MCP 구성을 붙여넣거나 공유하기 전에 사용: Claude Desktop
- MCP 구성을 붙여넣거나 공유하기 전에 사용: CI / PR
스키마나 프롬프트 작성에는 관련 도구 사용
- 스키마나 프롬프트 작성에는 관련 도구 사용
- 스키마나 프롬프트 작성에는 관련 도구 사용: AI Agent Builder
- 스키마나 프롬프트 작성에는 관련 도구 사용: JSON Schema
오류와 경고 — 붙여넣기를 막는 항목
오류: 구성이 검증을 차단합니다
심각도 안내
| 심각도 안내 | ok에 미치는 영향 | 일반적인 원인 |
|---|---|---|
| 오류: 구성이 검증을 차단합니다 | ok에 미치는 영향: ok = false | 일반적인 원인 |
| 경고: 프로덕션 전에 이 세부 사항을 검토하세요 | ok에 미치는 영향: ok | 일반적인 원인 |
경고: 프로덕션 전에 이 세부 사항을 검토하세요
단계별: 붙여넣기, lint, 수정, 다시 붙여넣기
이 도구가 돕는 방법
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
- 서버마다 하나의 전송 방식만 선택합니다.
- 원격 서버에는 http:// 또는 https://를 사용합니다.
- env 값을 문자열로 바꿉니다.
- ok가 true가 될 때까지 다시 검증합니다.
- 수정한 JSON을 클라이언트에 붙여넣습니다.
사용 사례: 다시 로드하기 전 Cursor mcp.json 수정
오류: 구성이 검증을 차단합니다 Cursor mcp.json.
이 도구가 돕는 방법
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
- 서버마다 하나의 전송 방식만 선택합니다.
결과: 명확하고 검증되어 바로 사용할 수 있는 MCP 구성.
사용 사례: Claude Desktop 원격 MCP URL
오류: 구성이 검증을 차단합니다 Claude Desktop.
이 도구가 돕는 방법
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
- 서버마다 하나의 전송 방식만 선택합니다.
결과: 명확하고 검증되어 바로 사용할 수 있는 MCP 구성.
사용 사례: PR 검토에서 MCP 템플릿 lint
오류: 구성이 검증을 차단합니다 CI / PR.
이 도구가 돕는 방법
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
- 서버마다 하나의 전송 방식만 선택합니다.
결과: 명확하고 검증되어 바로 사용할 수 있는 MCP 구성.
사용 사례: 디버깅 중 시크릿 위생
오류: 구성이 검증을 차단합니다 env.
이 도구가 돕는 방법
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
- 서버마다 하나의 전송 방식만 선택합니다.
결과: 명확하고 검증되어 바로 사용할 수 있는 MCP 구성.
stdio 및 HTTP/HTTPS 전송 규칙
전송 형식
전송 형식
| 전송 형식 | 필수 필드 | 참고 |
|---|---|---|
| stdio | command; args | 참고 |
| HTTP / HTTPS | url (http:// or https://) | 참고 |
참고: env, headers, disabled.
env 값은 문자열이어야 함
env: 필수 필드
- env: 필수 필드
- 필수 필드
- JSON
- mcpServers
수정: command 또는 url 누락
오류: 구성이 검증을 차단합니다: command or url.
발생 이유
발생 이유
진단
진단
수정
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
수정: 문자열이 아닌 env 값
오류: 구성이 검증을 차단합니다: env.
발생 이유
발생 이유
진단
진단
수정
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
경고: 프로덕션 전에 이 세부 사항을 검토하세요
수정: 잘못된 루트 envelope
오류: 구성이 검증을 차단합니다: mcpServers.
발생 이유
발생 이유
진단
진단
수정
- mcpServers가 있는 JSON을 붙여넣습니다.
- 먼저 오류를 수정합니다.
- command, args, url, env를 확인합니다.
MCP 검증 모범 사례
- Cursor 또는 Claude Desktop에 붙이기 전에 검증합니다.
- command 또는 url 중 하나만 사용합니다.
- args는 문자열 배열로 유지합니다.
- env 값은 문자열로 유지합니다.
- 시크릿에는 자리표시자를 사용합니다.
- 최소 권한의 절대 경로를 사용합니다.
- 변경할 때마다 다시 검증합니다.
- 프로덕션 전에 경고를 검토합니다.
자주 묻는 질문
일반적인 문제와 데이터 프라이버시에 대한 답변입니다.
관련 도구
이 도구를 보완하는 관련 유틸리티를 살펴보세요.
공식 문서 및 참고 자료
이 유틸리티의 공식 사양 및 플랫폼 문서입니다.