~/tools / MCP Config Checker
MCP Config Checker — MCP 설정 파일의 실수를 검사합니다
MCP 서버 설정 파일(.mcp.json 또는 claude_desktop_config.json)에서 type 누락, 잘못된 최상위 키, 예약되었거나 올바르지 않은 이름, 상대 경로, 설정되지 않은 변수, 파일에 직접 적힌 비밀 값 같은 실수를 찾아 줍니다. 입력한 내용은 브라우저 밖으로 나가지 않습니다.
2026-10-23에 문서를 기준으로 규칙을 확인했습니다.
문서: Claude Code / Model Context Protocol / VS Code
확인하지 않는 것: 명령이 존재하는지, 패키지가 설치되는지, 원격 서버가 응답하는지, 그리고 다른 애플리케이션이 다르게 읽는 설정.
모든 처리는 브라우저 안에서 이루어집니다. 설정은 업로드되지 않습니다.
MCP 서버는 JSON 파일로 설정하는데, 작은 실수 하나로 서버가 아무 알림 없이 목록에 나타나지 않을 수 있습니다. url은 있지만 type이 없는 서버 항목은 건너뛰어지고, VS Code의 servers 키를 쓴 파일은 Claude Code와 Claude Desktop이 읽지 않으며, 설정되지 않은 환경 변수는 그대로 문자열로 전달됩니다. 이 도구는 붙여넣은 설정을 읽고, 문서상 동작하지 않는 것, 확인해 볼 만한 것, 참고용 정보를 나누어 보여 줍니다. 또 토큰이 파일에 직접 적힌 것처럼 보이면 경고합니다. 그런 파일은 버전 관리에 올라갈 수 있기 때문입니다. 규칙은 Claude Code, Model Context Protocol, VS Code의 문서에서 가져왔으며, 확인한 날짜는 도구 아래에 표시됩니다.
이럴 때 사용
- .mcp.json이나 claude_desktop_config.json을 고친 뒤에도 MCP 서버가 나타나지 않는 이유 찾기
- README에서 복사한 설정을 공유 프로젝트에 추가하기 전에 점검하기
- 설정 파일을 커밋하기 전에 파일에 적힌 토큰과 비밀번호 찾아내기
사용법
- MCP 설정 파일의 내용을 붙여넣거나 예시를 불러옵니다.
- 찾은 서버와 각 서버의 종류를 확인한 다음, 검사 결과 목록을 읽습니다. 수정은 문서상 해당 항목이 동작하지 않는다는 뜻이고, 확인은 살펴볼 만하다는 뜻이며, 참고는 정보 안내입니다.
- 파일을 고친 뒤 다시 붙여넣어 검사하고, 그 파일을 읽는 애플리케이션을 다시 시작합니다.
FAQ
어떤 파일과 애플리케이션을 대상으로 하나요?
Claude Code의 프로젝트 파일 .mcp.json과 Claude Desktop의 claude_desktop_config.json이 쓰는 mcpServers 형식입니다. 다른 애플리케이션은 다른 필드나 다른 최상위 키를 읽을 수 있으므로 해당 문서를 확인하세요. 예를 들어 VS Code는 servers라는 최상위 키를 씁니다.
url은 있는데 type이 없습니다. 왜 문제인가요?
Claude Code는 type이 없는 항목을 stdio 서버로 읽습니다. 그래서 url은 있고 type이 없는 항목은 설정 오류이며 그 서버는 건너뛰어집니다. type으로 http, sse 또는 ws를 추가하세요.
${API_KEY} 같은 변수가 설정되어 있지 않으면 어떻게 되나요?
Claude Code는 command, args, env, url, headers에서 ${VAR}와 ${VAR:-default}를 확장합니다. 변수가 설정되어 있지 않고 기본값도 없으면 설정은 그대로 불러와지고, Claude Code가 경고를 표시하며 ${VAR}라는 텍스트를 적힌 그대로 사용합니다. 안전한 경우에는 ${VAR:-default}로 기본값을 지정하세요.
파일에 토큰이 있다고 왜 경고하나요?
설정 파일에 직접 적힌 토큰은 파일을 커밋하거나 다른 사람에게 보낼 때 함께 공유될 수 있습니다. 이 검사는 알려진 토큰 형식과 api-key, token, password 같은 이름에 기반한 추정이라서, 비밀 값을 놓치거나 문제없는 값을 잘못 표시할 수 있습니다. ${VAR}를 쓰면 값이 파일에 남지 않습니다.
서버를 실행하거나 연결을 시험해 보나요?
아니요. 텍스트만 읽습니다. 명령이 존재하는지, 패키지를 설치할 수 있는지, 원격 서버에 접속할 수 있는지는 알 수 없으므로, 이 검사를 통과한 뒤에는 애플리케이션에서 서버를 직접 시험해 보세요.
내 설정이 서버로 전송되나요?
아니요. 검사는 브라우저 안에서 실행됩니다.