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

# Hermes Agent

> Hermes Agent에 vox.ai MCP를 연결해 통화 중 음성 에이전트의 질문에 답하게 할 수 있어요.

Nous Research의 Hermes Agent에 vox.ai 원격 MCP 서버를 서버용 API 키로 연결해요. 연결하면 [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md)의 음성 에이전트 준비와 전화 걸기를 Hermes에 맡길 수 있어요.

## 준비물

* **Hermes Agent**: [Hermes Agent 공식 문서](https://hermes-agent.nousresearch.com/docs)를 따라 설치하세요.
* **서버용 API 키**: **설정 > API 키**에서 만든 `sk_...` 형태의 서버용 키가 필요해요. 키를 만드는 방법은 [API 키](https://docs.tryvox.co/docs/workspace/api-keys.md)를 보세요.
* **발신번호**: 전화를 걸 워크스페이스에 발신에 쓸 번호가 있어야 해요. 번호 준비는 [전화번호](https://docs.tryvox.co/docs/operate/deploy/phone-numbers.md)를 보세요.

실제 발신에는 통화 요금이 들며, 요금과 동시 통화·운영 한도는 [요금](https://docs.tryvox.co/docs/start/pricing.md)에서 확인하세요.

## API 키로 연결하기

Hermes CLI로 vox.ai MCP 서버를 추가하고 연결 상태를 점검하세요.

**1. MCP 서버 추가하기**

터미널에서 아래 명령을 실행하세요. 차례로 나오는 질문에서 인증이 필요한지 물으면 `Y`를 입력하고, `API key / Bearer token:`에 `sk_...` 서버용 API 키를 붙여 넣으세요. 도구를 모두 켤지 물으면 `Y`를 입력하거나 `select`로 쓸 도구만 고르세요.

```bash theme={null}
hermes mcp add vox --url https://mcp.tryvox.co/mcp --auth header
```

**2. 저장된 설정 확인하기**

`~/.hermes/config.yaml`의 `mcp_servers.vox`에 서버 주소와 `Authorization: Bearer ${MCP_VOX_API_KEY}` 헤더가 저장되고, 실제 키 값은 `~/.hermes/.env`의 `MCP_VOX_API_KEY`에 들어가요.

```yaml theme={null}
mcp_servers:
  vox:
    url: https://mcp.tryvox.co/mcp
    headers:
      Authorization: Bearer ${MCP_VOX_API_KEY}
    enabled: true
```

**3. 연결 점검하기**

아래 명령으로 연결과 도구 발견 결과를 확인하세요. 출력에서 헤더 값은 `***`로 가려져 보여요. 등록된 서버 목록은 `hermes mcp list`로 볼 수 있어요.

```bash theme={null}
hermes mcp test vox
```

## 연결 확인

터미널에서 `hermes`를 실행해 대화를 열고 에이전트 목록을 요청하세요. API 키로 붙은 연결은 키를 만든 워크스페이스 하나에서만 일하고, 워크스페이스 목록을 조회하면 이름이 비어서 나와요. 그래서 에이전트 목록으로 확인해요.

```text theme={null}
vox.ai에 연결된 에이전트 목록을 보여줘.
```

목록이 보이면 [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md)의 음성 에이전트 준비하기 단계로 돌아가세요.

## 문제가 생겼을 때

> [accordion] 키를 바꿨는데 계속 예전 키로 연결돼요
>
> `~/.hermes/.env` 파일에서 `MCP_VOX_API_KEY` 값을 새 서버용 API 키로 고치세요. 같은 이름으로 `hermes mcp add`를 다시 실행해도 새 키를 묻지 않고 `~/.hermes/.env`의 예전 `MCP_VOX_API_KEY`를 그대로 써요.

> [accordion] hermes mcp test가 405 오류나 전송 방식 실패로 나와요
>
> `~/.hermes/.env`의 `MCP_VOX_API_KEY`에 올바른 `sk_...` 서버용 API 키가 들어 있는지 확인하세요. 틀린 키일 때 `hermes mcp test`는 `405 Method Not Allowed`나 두 전송 방식이 모두 실패했다는 식으로 보여 줘요.

> [accordion] 연결한 MCP 서버를 지우고 싶어요
>
> 터미널에서 `hermes mcp remove vox`를 실행하고 확인 질문에 답하세요. 설정에서 `vox` 서버 연결이 지워져요.

## 관련 문서

* [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md): 중계 서버를 띄우고 통화 중 질문에 답하게 하기
* [MCP 도구](https://docs.tryvox.co/docs/ai/mcp-reference.md): 전체 도구 목록과 입력·실행 규칙 보기
* [API 키](https://docs.tryvox.co/docs/workspace/api-keys.md): 서버용 API 키 만들고 관리하기


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