클로드 MCP 셋팅했는데도, 망치 아이콘 안뜰때 확인해야할 check list

클로드 MCP 시키는데로 다 했는데도 망치 아이콘 안떠서, 

무료버전은 안되는건가 좌절하고 있었는데,

우연히 유튜브 보다가 아래 챗봇에서 물어보고 해결함. ㅎ

 

내가 챗GPT한테 계속 단계별로 물어보고 할떄는 문제없는줄 알았는데. 아니였음.

 

https://chatgpt.com/share/6833244b-fb64-8000-9fd1-49178bd6b840

ChatGPT - 클로드 무료사용자 MCP 사용

 

✅ 1. 설정 파일에 MCP가 정확히 추가되었는지 확인

• claude_desktop_config.json 파일의 mcpServers 항목에 다음과 같은 형식으로 MCP가 들어가 있어야 합니다:

json

복사편집

"terminal": { "command": "npx", "args": ["-y", "@dillip285/mcp-terminal"] }

여러 MCP를 추가할 때 쉼표(,) 누락이나 중괄호 오류가 있으면 전체 설정이 무시될 수 있습니다.

---

✅ 2. 경로가 정확한지 확인 (특히 직접 작성한 경우)

• "args" 내부에 경로를 적었다면 역슬래시(\) 대신 이중 역슬래시(\\) 또는 슬래시(/)를 사용해야 합니다.
• 예: "C:\\xampp\\htdocs\\mysite" 또는 "C:/xampp/htdocs/mysite"

---

✅ 3. 실행 명령 확인 (직접 실행 테스트)

MCP가 실제 실행 가능한 상태인지 직접 명령 프롬프트에서 확인해 보세요. 예:

bash

복사편집

npx -y @dillip285/mcp-terminal

이때 에러가 발생하면, 설치가 덜 됐거나 의존성이 누락된 상태일 수 있습니다.

---

✅ 4. 클로드 데스크탑 재시작

• 설정 파일 수정 후 클로드 데스크탑을 반드시 재시작해야 MCP가 적용됩니다.
• "파일 > 설정 > 개발자 > 설정 편집"에서 설정한 경우, 저장 후 완전히 종료 후 재시작해야 합니다.

---

✅ 5. Node.js, Git, Python 경로 환경변수 확인

• node, npx, git, python 명령이 명령 프롬프트에서 인식되는지 확인하세요.

bash

복사편집

node -v npx -v python --version git --version

 

• 클로드 데스크탑 설치 – 클로드 데스크탑은 무료 사용자도 설치할 수 있으며, 여기에 MCP 서버를 연결하여 사용할 수 있습니다.
• Node.js 및 Python 설치 – 대부분의 MCP는 Node.js나 Python 환경에서 실행되므로, 이들이 사전에 설치되어 있어야 합니다.
• 설정 파일에 MCP가 정확히 추가되었는지 확인 ( claude_desktop_config.json 파일 )

 

다른 챗봇에 다 물어보면서 확인해도 내 설정 틀린거 없다고 하더니,

여기 챗봇엔 물어보니, 내 json 파일이 잘못됐다고 알려줌. 

아, 잘못된건 아니지만, 그렇게 설정하면 망치아이콘이 안나올수 있다고 알려줌. ^_^

 

내 json 파일, filesystem 만 추가함. 문법은 다 맞고, 틀린게 없었음.

{   "mcpServers": {     "filesystem": {       "command": "npx",       "args": [         "-y",         "@modelcontextprotocol/server-filesystem",         "D:\\mcp_test"       ]     }   } }

 

✅ 1. MCP가 1개만 등록된 상태

현재 등록된 MCP는 "filesystem" 하나뿐입니다.

👉 공구(망치) 아이콘이 보이려면 최소 하나 이상의 실행 가능한 MCP가 등록되어 있어야 하고, 그 MCP가 정상 작동해야 합니다.

filesystem MCP는 자체적으로는 명령을 처리하지 않기 때문에 Terminal MCP나 GoogleSearch MCP, Playwright MCP 등의 기능성 MCP가 추가되어야 MCP 서버 목록이 표시됩니다.

---

✅ 2. 해결 방법 – Terminal MCP 추가해보세요

filesystem MCP 외에 다음과 같이 "terminal" MCP를 추가해보세요:

{   "mcpServers": {     "filesystem": {       "command": "npx",       "args": [         "-y",         "@modelcontextprotocol/server-filesystem",         "D:\\mcp_test"       ]     },     "terminal": {       "command": "npx",       "args": [         "-y",         "@dillip285/mcp-terminal"       ],       "config": {         "allowedCommands": ["npm", "npx", "node", "python", "pip", "dir"],         "defaultTimeout": 30000       }     }   } }

 

 

✅ 수정 후, 클로드 데스크탑 완전히 종료하고 다시 실행하세요.

---

📌 추가 팁

• MCP가 제대로 작동하면 Claude 화면 하단에 **"망치 + MCP 서버 개수"**가 표시됩니다.

 

꺄~ 신난다. 이제 이것저것 해봐야지!!