Model Context Protocol(MCP)은 AI 어시스턴트를 로컬 프로그램과 원격 서비스에 연결합니다. 클라이언트마다 고유한 파일과 규칙이 있습니다. Claude Desktop은 mcpServers 키가 있는 claude_desktop_config.json을 읽고 그중 로컬 stdio 서버만 실행하며, Claude Code는 type이 stdio, http 또는 sse인 .mcp.json을 읽고, Cursor는 .cursor/mcp.json을 사용하며, Visual Studio Code는 .vscode/mcp.json에서 servers 키와 선택 항목인 inputs를 기대하고, Codex CLI는 config.toml 안에서 서버를 TOML 테이블 [mcp_servers.이름]으로 기술합니다. 루트 키가 틀리거나 필드를 빠뜨려도 대개 분명한 오류가 나지 않고 서버가 그냥 사라집니다.
이 도구는 선택한 클라이언트의 버전이 매겨진 프로필(2025-10 기준 문서화된 형식)과 파일을 대조하거나 형식을 스스로 판별합니다. 각 결과에는 고정 코드, JSON Pointer, 행과 열이 표시됩니다. 빠진 command, 알 수 없는 전송 방식, mcpServers 대신 쓴 servers, 올바른 필드 이름을 제안하는 오타, 엄격한 JSON 안의 주석이나 끝 쉼표, 선언되지 않은 input 변수, 다른 클라이언트만 이해하는 자리표시자 등입니다. 또한 bash -c 같은 셸 래퍼, 인수 속 셸 특수 문자, 암호화되지 않은 http, 보이지 않거나 글자 방향을 바꾸는 문자도 경고합니다.
파일에 적힌 비밀 값, 예를 들어 GitHub 토큰, sk- 키, Slack 토큰, AWS 액세스 키, JWT, Bearer 헤더, URL 속 자격 증명은 감지되며 보고서에는 종류와 길이만 표시되고 평문으로는 절대 나타나지 않습니다. 원하면 감지된 값을 클라이언트의 자리표시자 표기(${NAME}, env 변수, 비밀번호 입력이 있는 input 변수 또는 <SET_NAME>)로 바꾼 정리된 사본을 만들 수 있습니다. 감지는 휴리스틱이므로 파일을 공유하거나 저장소에 올리기 전에 사본을 직접 확인하세요. 명령, 인수, URL은 텍스트로만 읽으므로 아무것도 실행되지 않고, 주소를 조회하지 않으며, 어떤 서버에도 접속하지 않습니다. YAML은 의도적으로 평가하지 않으며, 1 MB를 넘거나 64단계보다 깊은 입력은 읽기 전에 거부합니다.
항목 만들기 모드에서는 npx -y 패키지-이름 같은 명령줄이나 URL이 선택한 클라이언트 문법의 바로 쓸 수 있는 서버 항목이 됩니다. 따옴표는 존중되지만 아무것도 치환하거나 실행하지 않으며, 변수 이름은 평문 값 대신 자리표시자가 됩니다. 만들어진 항목은 곧바로 같은 검사를 거칩니다. 비교 모드에서는 클라이언트가 달라도 두 설정을 서버별로 나란히 놓고 비교하며, 환경 변수와 헤더의 값은 숨긴 채로 둡니다. 모든 작업은 브라우저 안에서만 이루어지고, 처음 불러온 뒤에는 오프라인에서도 동작합니다.
원하는 만큼 무료로 쓸 수 있습니다. 하루 사용 횟수 제한 없음, 계정 불필요, 유료 장벽 없음이며, 입력한 내용은 기기에 남습니다. 많은 온라인 서비스는 무료 사용을 하루 몇 번으로 제한하거나 계정을 요구합니다. 여기서는 모든 작업이 브라우저에서 로컬로 실행되므로 하루 할당량도, 가입도 없습니다.
기술 사양
기술 사양
입력 형식
텍스트 입력
출력 형식
TXT
일괄 처리
미지원
처리 방식
브라우저에서 로컬 처리 (JavaScript)
파일 업로드
없음
3단계로
모드와 클라이언트 프로필을 고릅니다.
설정, 명령줄 또는 URL을 붙여넣습니다. 비교하려면 두 번째 설정을 B 칸에 넣습니다.
위치가 표시된 보고서를 읽고 정리된 사본이나 만들어진 항목을 복사합니다.
제한: 검사를 통과해도 보안 인증이나 연결 테스트가 아닙니다. 서버를 믿을 수 있는지, 실행되는지, 응답하는지는 확인하지 않습니다. 프로필은 2025-10 기준으로 문서화된 파일 형식을 담고 있으며 각 클라이언트에서 실제로 검증하지는 않았습니다. 더 새로운 필드는 경고로 표시됩니다. 비밀 값 감지는 알려진 형식과 필드 이름에 기반하므로 값을 놓치거나 무해한 값을 표시할 수 있습니다. 정리된 사본에서는 주석과 서식이 사라집니다. TOML 위치는 행 단위까지는 정확하지만 열 단위는 아닙니다. YAML은 지원하지 않으며 입력은 1 MB로 제한됩니다. 보고서는 고정된 기술 코드와 짧은 영어 메시지를 사용하며, 그 의미는 이 페이지에서 설명합니다.
자주 묻는 질문
내 설정이 업로드되나요?
아니요. 검사, 만들기, 비교는 모두 브라우저 안에서 이루어집니다. 파일도, 그 안의 토큰도 기기를 떠나지 않으며 어떤 서버에도 접속하지 않습니다.
어떤 클라이언트와 버전을 지원하나요?
Claude Desktop, Claude Code, Cursor, Visual Studio Code, Codex CLI이며, 각각 2025-10 기준으로 문서화된 파일 형식의 프로필로 제공됩니다. 보고서는 실행할 때마다 프로필과 그 기준 시점을 알려 줍니다.
"VALID"는 서버가 안전하다는 뜻인가요?
아니요. VALID는 파일이 프로필의 형식과 맞는다는 뜻일 뿐입니다. 실행되는 프로그램을 믿을 수 있는지, 원격 서버에 연결되는지는 구문 검사로 답할 수 없습니다.
토큰과 키는 어떻게 처리되나요?
감지된 뒤 보고서에는 종류와 길이만 표시되고, 정리된 사본에서는 ${GITHUB_TOKEN} 같은 자리표시자로 바뀝니다. 아무것도 저장하지 않습니다.
VS Code가 왜 내 서버를 찾지 못하나요?
가장 흔한 원인은 .vscode/mcp.json이 servers 키를 기대하는데, 많은 안내서가 다른 클라이언트의 mcpServers를 보여 주기 때문입니다. 도구는 바로 이 경우를 위치와 함께 알려 줍니다.
YAML 설정도 검사할 수 있나요?
아니요. 지원하는 클라이언트 중 이 파일에 YAML을 쓰는 곳은 없습니다. YAML 입력은 인식하되 의도적으로 평가하지 않으므로 앵커, 별칭, 태그가 펼쳐지는 일은 없습니다.
‘MCP 설정 검사기’ 도구는 무료인가요? 제한이 있나요?
네. ‘MCP 설정 검사기’ 도구는 원하는 만큼 자주 사용할 수 있습니다. 하루 사용 횟수 제한 없음, 계정 불필요, 유료 장벽 없음. 고정 상한: 1 MB, 값 100,000개, 중첩 64단계까지의 설정.