// MCP 및 Skill
Hermes AI API를 AI 에이전트에 연결하기
프롬프트 하나를 Claude Code, Codex, Cursor 등 에이전트에 붙여 넣으세요. MCP 서버와 Agent Skill을 설치하고, 브라우저에서 한 번만 로그인하면 됩니다.
// 01
이 프롬프트를 에이전트에 붙여 넣기
Claude Code, Codex, Cursor처럼 명령을 실행할 수 있는 에이전트에서 동작합니다. 설정은 에이전트가 합니다.
설정 프롬프트
Hermes AI API(https://api.hermes-ai.net)를 설정해서 이미지, 동영상, 음악을 생성할 수 있게 해 줘. 1. Hermes AI API MCP 서버를 hermes-ai-api 이름으로 https://api.hermes-ai.net/mcp에 추가해 줘(Streamable HTTP, OAuth 로그인). - Claude Code: claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcp - Codex: codex mcp add hermes-ai-api --url https://api.hermes-ai.net/mcp - 기타 클라이언트: MCP 설정에 추가해 줘. 2. Hermes AI API Agent Skill을 설치해 줘: https://api.hermes-ai.net/skills/hermes-ai-api.zip을 다운로드해 skills 폴더에 압축을 풀어(Claude Code는 ~/.claude/skills). 3. 브라우저에서 Hermes AI API에 로그인하는 방법을 알려 주고(Claude Code: /mcp 실행 후 hermes-ai-api 선택, Codex: codex mcp login hermes-ai-api), 도구를 사용할 수 있는지 확인해 줘. 참고: https://api.hermes-ai.net/llms.txt
// 02
한 번만 로그인
에이전트가 처음 Hermes AI API를 사용하면 브라우저가 열립니다. Google 또는 GitHub로 로그인하고 요청을 허용하세요.
앱이 할 수 있는 일
모델을 실행해 선불 크레딧을 사용하고 작업, 결과, 잔액을 읽습니다.
앱이 할 수 없는 일
API 키, 결제 또는 지불 관리, 관리자 기능 사용.
언제든지 연결 해제
계정 보안에 연결된 모든 앱이 표시됩니다. 연결을 해제하면 즉시 접근이 중단됩니다.
// 03
원하는 것을 요청하세요
평소 말로 에이전트에게 요청하세요. 모델을 고르고 가격을 보여 준 뒤 작업을 실행합니다.
- “Hermes AI API로 해 뜰 무렵 등대의 16:9 이미지를 만들어 줘.”
- “Hermes AI API로 이 이미지를 10초짜리 동영상으로 만들어 줘.”
- “Hermes AI API로 월요일 아침에 관한 경쾌한 짧은 노래를 만들어 줘.”
- “Hermes AI API 크레딧이 얼마나 남았어?”
// 레퍼런스
수동 설정
직접 설정하고 싶다면 프롬프트가 하는 모든 단계가 아래에 있습니다.
서버 URL: https://api.hermes-ai.net/mcp
terminal
claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcp이 Skill은 에이전트에게 API 키로 REST API를 사용하는 Hermes AI API 작업 흐름을 알려 줍니다. ~/.claude/skills(모든 프로젝트) 또는 프로젝트의 .claude/skills에 압축을 풀고 HERMES_API_KEY를 설정하세요.
terminal
mkdir -p ~/.claude/skills
curl -L https://api.hermes-ai.net/skills/hermes-ai-api.zip -o /tmp/hermes-ai-api.zip
unzip -o /tmp/hermes-ai-api.zip -d ~/.claude/skills| 도구 | 기능 |
|---|---|
search_models | 출력 유형이나 키워드로 모델을 찾고 가격을 보여 줍니다. |
get_model | 모델의 입력 필드, 허용 값, 현재 가격을 읽습니다. |
create_task | 모델을 실행합니다. 작업이 성공할 때만 크레딧이 차감됩니다. |
wait_for_task | 작업이 끝날 때까지 기다린 뒤 결과를 반환합니다. |
get_task | 작업을 확인합니다. 완성된 이미지는 바로 반환됩니다. |
list_tasks | 최근 작업을 나열합니다. |
get_balance | 사용 가능, 예약, 사용한 크레딧을 보여 줍니다. |
에이전트와 AI 검색을 위한 기계 판독용 요약: Hermes AI API 소개, 전체 모델, 문서 위치.