// 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 とは何か、全モデル、ドキュメントの場所。