Hermes 에이전트는 MCP에 연결하면 도구가 줄어들는데, 이는 많은 경우 정상이며 반드시 서버가 고장 났기 때문만은 아닙니다. Hermes는 각 MCP 서버의 tools.include, tools.exclude, resources, prompts 구성을 존중합니다; 도구 화이트리스트를 매우 좁게 설정하면 자연스럽게 인터페이스에 소수의 도구만 보일 것입니다.
증상으로 조사하세요
| 현상 | 우선 검사 |
|---|---|
| 전체 MCP가 로드되지 않습니다 | enabled: false, 명령 경로, 런타임, HTTP 주소 |
| 도구 몇 개만 빠져 있습니다 | tools.include 그리고 tools.exclude |
| 자료나 프롬프트는 보이지 않습니다 | resources: false, prompts: false, 또는 서버 자체는 지원되지 않습니다 |
| 설정을 변경해도 여전히 이전 상태입니다 | 세션 중에 /reload-mcp 수행하세요 |
왜 먼저 도구를 좁히는 것이 권장되나요?
MCP의 강력한 점은 Hermes Agent가 파일 시스템, GitHub, 문서, 내부 API 및 기타 도구와 동시에 연결될 수 있게 해준다는 점입니다. 하지만 도구가 많을수록 오해와 허가 위험이 커집니다. GitHub, 금융 시스템, 고객 시스템과 같이 쓰기 작업이 가능한 서비스의 경우, 처음에는 소수의 읽기 전용 또는 저위험 도구로 시작한 후, 프로세스가 신뢰할 수 있는지 확인한 후 점차 개봉하는 것이 권장됩니다.
초보자를 위한 가장 안정적인 구성 아이디어
먼저 파일 시스템이나 git MCP를 연결하고, 프로젝트 디렉터리는 하나만 노출하세요; 그 다음 GitHub MCP에 연결하고, list_issues나 search_code 같은 저위험 도구만 설치하세요. Hermes 에이전트를 올바르게 호출할 수 있는지 확인한 후, 문제 생성 및 상태 업데이트 같은 행동을 추가하세요. 도구가 적다는 점을 고려하면, 현재 작업에 이 도구들이 정말 필요한지 묻지 마세요.
공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 기록: https://hermes-agent.nousresearch.com/.