에르메스 원격 MCP 설정

에르메스 원격 MCP 설정은(는) 무엇을 하나요?

사용 시기

에르메스에서 원격 OAuth MCP 서버를 추가, 승인, 문제 해결 또는 확인할 때 이 스킬을 사용합니다.

절차

1. 요청된 서버 ID와 엔드포인트를 유지합니다. 사용자가 제공한 정확한 URL을 먼저 사용합니다. MCP 응답이 아닌 경우, 추측된 URL을 자동으로 대체하지 말고 공급업체의 공식 문서나 엔드포인트 메타데이터를 참조하여 대체 엔드포인트를 시도하기 전에 확인합니다.
2. 네이티브 CLI로 OAuth 가능 서버를 추가합니다. 다음 명령어를 사용합니다:

   hermes mcp add <이름> --url <엔드포인트> --auth oauth
   

   인증 또는 도구 검색이 느린 경우 --connect-timeout 120을 추가합니다.
3. PTY를 통해 대화형 설정을 실행합니다. 초기 OAuth 흐름은 브라우저를 열고 승인을 위해 일시 중지될 수 있습니다. 프로세스를 활성 상태로 유지하고, 사용자에게 브라우저에서 승인을 완료하도록 알리며, 채팅에서 OAuth 코드를 요청하거나 수락하지 마십시오.
4. 도구를 명시적으로 활성화합니다. 에르메스가 검색된 도구를 나열할 때, 사용자가 서버를 일반적으로 설치하도록 요청한 경우에만 모두 선택하고, 그렇지 않으면 요청된 하위 집합을 선택합니다. PTY 흐름에서 일반 제출 후 선택 프롬프트가 열려 있으면 y 원시 입력이 필요할 수 있습니다.
5. 성공을 보고하기 전에 확인합니다. 다음 명령어를 실행합니다:

   hermes mcp list
   hermes mcp test <이름>
   hermes config get mcp_servers.<이름>
   

   엔드포인트, 인증 방법, 연결 상태, 정확히 검색되어 활성화된 도구 개수를 보고합니다.
6. 활성화 범위를 명시합니다. 네이티브 MCP 검색은 시작/세션 범위로 제한됩니다. 사용자에게 새로 추가된 도구를 이미 열려 있는 대화에서 사용하기 전에 /reload-mcp를 실행하거나 새 세션을 시작하도록 알립니다.

주의 사항

• 실패한 엔드포인트 탐색 후, 사용자가 명시적으로 지연된 확인되지 않은 구성을 원하지 않는 한 서버를 저장하지 마십시오. 403 HTML 페이지 또는 SSE 콘텐츠 유형 불일치는 URL이 사용 가능한 MCP 엔드포인트가 아님을 나타냅니다.
• 에르메스가 구성을 작성했다고 해서 OAuth 설정이 성공했다고 주장하지 마십시오. 성공적으로 인증된 hermes mcp test가 필요합니다.
• 자격 증명, 인증 코드, 베어러 토큰 및 전체 OAuth URL을 메모리, 스킬 및 채팅에 보관하지 마십시오. 이들은 비밀 또는 단기 세션 데이터입니다.
• 공급업체 엔드포인트 리디렉션은 사용자 URL을 자동으로 정규화하는 이유가 아닌 검색 문제로 취급하십시오. 보고서에 원래 URL을 유지하고 확인된 대체 엔드포인트의 이름을 지정하십시오.