유용한 MCP Servers 설치 단락 부분에서 .mcp.json 설정 문제

Question

이슈 레포 : https://github.com/anthropics/claude-code/issues/15215 (#15215번은 닫쳐 있지만 밑 댓글에 #5037 번과 연계되어 있음) 증상 project 레벨에서 설정되는 .mcp.json 부분이 현재 버그가 있어 동작하지 않는 거 같습니다. claude git 레포에도 이슈로 열려있는 거 같은데 local 레벨로 내려서 실행해야 동작하는 거 같습니다. project level(.mcp.json) 에서 mcp 서버 설정을 못찾음 After claude mcp add --transport http context7 https://mcp.context7.com/mcp --scope [user or local 로 해야함] 설치 스코프를 local or user 로 하면 정상동작

짐코딩 · Answer

안녕하세요! 🙂 직접 이슈까지 찾아서 정리해 주셨네요, 정말 감사합니다! 말씀하신 대로 현재 .mcp.json (project 스코프)이 Claude Code 런타임에서 제대로 로드되지 않는 버그가 있는 상태로 확인했습니다. 임시 해결책은 말씀하신 것처럼 --scope user 또는 --scope local 로 등록하시면 정상 동작합니다. claude mcp add --transport http context7 https://mcp.context7.com/mcp --scope user 공식 이슈로 열려 있는 만큼 추후 버전에서 수정될 것으로 보여요. 그 전까지는 user 또는 local 스코프로 사용해야 하겠네요. 관련 내용은 강의에서 공유하도록 할게요. 감사합니다 🙂

인프런 AI 인턴 · Answer

안녕하세요, 인프런 AI 인턴입니다. 정재호우님. 올려주신 MCP 서버 설정 문제는 새 버전의 Claude Code에서는 프로젝트 레벨의 .mcp.json 설정이 오류로 인해 제대로 작동하지 않는 상황으로 보입니다. 이와 관련해 몇 가지 유용한 정보를 제공해 드릴 수 있습니다. 문제의 원인과 해결 방법: 프로젝트 레벨 설정 문제 : .mcp.json 파일에서 프로젝트 레벨의 설정이 제대로 반영되지 않는 문제가 발생하고 있습니다. 이는 관련 이슈 레포가 열려 있는 상태이며, 해결을 위해서는 local 이나 user 스코프로 설정해야 합니다. 해결 방법 : 명령어에서 --scope 옵션을 user 혹은 local 로 지정해보세요. 예를 들어, 다음과 같은 형태의 명령어를 사용할 수 있습니다: claude mcp add --transport http context7 https://mcp.context7.com/mcp --scope local 이슈 해결 진행 상황 : 해당 문제는 깃허브 이슈 #15215 및 #5037 에서도 보고되었으며, 프로젝트 문서와 커뮤니티를 통해 최신 업데이트가 있을 수 있으므로 지속적인 확인이 필요합니다. 추가 설명 및 참고: 이미지 이해 : 두 번째 이미지에서, .claude.json 파일과 터미널에서의 MCP 서버 설정이 효율적으로 작동하는 것을 확인할 수 있습니다. 이는 명령 수행 후 서버가 제대로 설정된 경우의 예시 화면입니다. 관련 문서 활용하기 : Claude의 공식 문서를 참고하여 최신 업데이트 및 설정 방법에 대한 정보를 확인해주세요. 문제가 지속되는 경우 Claude 커뮤니티나 이슈 트래커를 통해 추가적인 도움을 받을 수도 있습니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.