
# Hermes Agent 연결 {/* #connect-hermes-agent */}

이 가이드는 개인 액세스 토큰을 사용합니다. OAuth를 사용하려면 연결 전에 클라이언트의 정확한 콜백 URI를 지원팀에 알려주세요. [클라이언트 호환성](/docs/ko/connect-ai-agents#client-compatibility)을 참고하세요.

[개인 액세스 토큰](/docs/ko/connect-ai-agents#personal-access-token)에 설명된 대로 [Reconstruct Platform 설정](https://reconstruct.dev/platform/)에서 **MCP** 범위의 토큰을 만드세요.

## 서버 설정 {/* #configure-the-server */}

로컬 `~/.hermes/.env`에 토큰을 추가하세요:

```dotenv
CR_RECONSTRUCT_MCP_TOKEN=<your MCP token>
```

`~/.hermes/config.yaml`의 `mcp_servers`에 `reconstruct`를 추가하세요. 기존 서버 항목은 유지하세요:

```yaml
mcp_servers:
  reconstruct:
    url: "https://reconstruct.dev/mcp"
    headers:
      Authorization: "Bearer ${CR_RECONSTRUCT_MCP_TOKEN}"
```

Hermes는 URL 기반 서버에서 기본적으로 Streamable HTTP를 사용합니다. 토큰은 `.env`에 보관하세요. Hermes가 헤더의 변수를 확장합니다. 이름이 있는 프로필을 사용한다면 해당 프로필의 설정과 `.env`를 수정하세요.

## 연결 확인 {/* #check-the-connection */}

Hermes를 시작하거나 기존 세션에서 `/reload-mcp`를 실행하세요. `mcp__reconstruct__list_products` 호출을 요청하세요.

공식 [Hermes MCP 가이드](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp)와 [설정 참고 문서](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference)를 참고하세요. 연결 실패 시 [문제 해결](/docs/ko/connect-ai-agents#troubleshooting)을 확인하세요. 다음으로 [프롬프트 예시](/docs/ko/prompt-examples)를 사용해 보세요.
