> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes MCP 설정

> 네이티브 원격 MCP 설정, 브라우저 인증, 도구 검증, 문제 해결

이 페이지는 Hermes의 네이티브 MCP를 다룹니다. 원격 서비스는 Streamable HTTP와 브라우저 OAuth를 사용하며 EvoLink CLI가 필요 없습니다. 명령과 스킬로 실행하려면 별도의 [CLI 가이드](https://evolink.ai/docs/ko/cli/hermes-agent.md)를 이용하세요.

## 원격 MCP 연결하기

네이티브 도구를 쓰려면 다음 서버 URL로 **Streamable HTTP + OAuth**를 사용하세요:

```text theme={null}
https://mcp.evolink.ai/mcp
```

CLI를 설치할 필요는 없습니다. 기존 설정을 백업하고, EvoLink 항목만 병합하고, 다른 서비스는 그대로 유지하세요. 명령으로 등록하는 방법과 수동으로 등록하는 방법 중 하나를 선택하세요.

**1. 서버 설정 병합**

OAuth를 지원하는 Hermes 버전에서 `~/.hermes/config.yaml`을 백업한 뒤 편집하세요. 최상위 키를 중복해서 쓰지 말고 기존 `mcp_servers` 매핑 안에 병합하세요. 들여쓰기에는 공백을 사용하세요:

```yaml theme={null}
mcp_servers:
  evolink:
    url: "https://mcp.evolink.ai/mcp"
    auth: oauth
    connect_timeout: 300
```

**2. 새 터미널에서 인증**

```bash theme={null}
hermes mcp login evolink
```

명령을 실행 중인 상태로 둔 채 브라우저에서 EvoLink에 로그인하고 승인하세요. 새 터미널에서 명시적으로 로그인하면, 실행 중인 세션의 설정을 편집한 뒤 자동으로 다시 로드될 때 주어지는 더 짧은 대기 시간을 피할 수 있습니다.

**3. 도구를 다시 로드하고 무료로 검증**

Hermes 대화에서 다음을 입력하세요:

```text theme={null}
/reload-mcp
```

또는 새 세션을 열고 아래 프롬프트를 보내세요. EvoLink 도구가 활성화되어 있는지 확인하세요. 도구가 목록에 보인다는 것만으로는 호출할 권한이 있다고 볼 수 없습니다.

SSH 콜백은 EvoLink CLI 옵션이 아니라 Hermes 자체의 설정을 따르세요. [Hermes 문서](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp/)를 참고하세요.

인증을 마친 뒤 에이전트 채팅에 다음을 보내세요:

```text theme={null}
EvoLink로 제 계정 잔액을 확인하고 사용할 수 있는 이미지 모델을 검색해 주세요. 아직 생성하지 마세요.
```

**성공 표시**: 실제 `check_balance`와 `search_models` 호출이 결과를 반환합니다. 이 도구들은 실제 MCP 연결에서 검증하세요.

## 업데이트, 연결 해제, 문제 해결

원격 MCP 서버는 EvoLink가 업데이트합니다. 설정을 변경한 뒤에는 실제 클라이언트 세션을 새로 고치세요. 필요하면 해당 클라이언트의 OAuth 인증 기능으로 다시 인증하세요. 연결을 해제하려면 호스트의 MCP 설정에서 EvoLink를 비활성화하거나, 로그아웃하거나, 제거하세요. 다른 서버는 그대로 두세요.

| 증상 | 조치 |
| - | - |
| URL은 추가했지만 도구가 없음 | 연결을 활성화하고, 인증을 완료하고, 새로 고친 뒤 조직 정책을 확인하세요 |
| 401 또는 인증 필요 | 이 MCP 연결을 다시 인증하고 원래 작업 ID를 보관하세요 |
| 403 또는 도구 거부 | 호스트 권한, 계정/키 상태, 네트워크 오류를 확인하세요 |
| 시간 초과 또는 응답 유실 | 다시 생성하지 말고 원래 요청을 조회해 복구하세요 |
| 링크만 표시되거나 미리보기가 회색임 | 자동으로 다시 만들지 말고 원본을 열어 전달하세요 |

[MCP 비용, 접근 권한, 문제 해결](https://evolink.ai/docs/ko/mcp/billing.md#faq)을 참고하세요. 제출하기 전에 [제작 작업 흐름](https://evolink.ai/docs/ko/mcp/overview.md#workflows)을 읽어 보세요. 호출 형식은 [MCP 도구 레퍼런스](https://evolink.ai/docs/ko/mcp/tools.md)에 있습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.