Skip to main content
Nous Research의 Hermes Agent에 vox.ai 원격 MCP 서버를 서버용 API 키로 연결해요. 연결하면 AI 에이전트에게 전화기 주기의 음성 에이전트 준비와 전화 걸기를 Hermes에 맡길 수 있어요.

​
준비물

  • Hermes Agent: Hermes Agent 공식 문서를 따라 설치하세요.
  • 서버용 API 키: 설정 > API 키에서 만든 sk_... 형태의 서버용 키가 필요해요. 키를 만드는 방법은 API 키를 보세요.
  • 발신번호: 전화를 걸 워크스페이스에 발신에 쓸 번호가 있어야 해요. 번호 준비는 전화번호를 보세요.
실제 발신에는 통화 요금이 들며, 요금과 동시 통화·운영 한도는 요금에서 확인하세요.

​
API 키로 연결하기

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

MCP 서버 추가하기

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

저장된 설정 확인하기

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

연결 점검하기

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

​
연결 확인

터미널에서 hermes를 실행해 대화를 열고 에이전트 목록을 요청하세요. API 키로 붙은 연결은 키를 만든 워크스페이스 하나에서만 일하고, 워크스페이스 목록을 조회하면 이름이 비어서 나와요. 그래서 에이전트 목록으로 확인해요.
목록이 보이면 AI 에이전트에게 전화기 주기의 음성 에이전트 준비하기 단계로 돌아가세요.

​
문제가 생겼을 때

~/.hermes/.env 파일에서 MCP_VOX_API_KEY 값을 새 서버용 API 키로 고치세요. 같은 이름으로 hermes mcp add를 다시 실행해도 새 키를 묻지 않고 ~/.hermes/.env의 예전 MCP_VOX_API_KEY를 그대로 써요.
~/.hermes/.env의 MCP_VOX_API_KEY에 올바른 sk_... 서버용 API 키가 들어 있는지 확인하세요. 틀린 키일 때 hermes mcp test는 405 Method Not Allowed나 두 전송 방식이 모두 실패했다는 식으로 보여 줘요.
터미널에서 hermes mcp remove vox를 실행하고 확인 질문에 답하세요. 설정에서 vox 서버 연결이 지워져요.

​
관련 문서