Hermes Agent for Freshdesk：安全に接続する方法（2026年版）

なぜ Freshdesk で Hermes を調べたのか

eesel での私の本業は連携の開発で、Freshdesk の API は、レート制限について意見が言えるほど深く触ってきたものの1つです。eesel は何年も前から実際のサポートキューで AI を動かしており、毎回同じ教訓に行き着きます。モデルは簡単な部分です。難しいのは、AI に何を触らせてよいかを決めることと、顧客が最初にそうでないと気づく前に準備ができていると確かめることです。

Hermes Agent は Nous Research のオープンソースでセルフホスト型のエージェントで、MIT ライセンスのもと GitHub のスターは251,479 です。一般的な問いについては Hermes Agent for customer support で検討済みです。今回はその Freshdesk 版で、先月 Freshdesk が答えを変えたため、独立した記事が必要になりました。

最初に断っておくと、Hermes には Freshdesk 専用のものは同梱されていません。厳選された68個の MCP サーバーのカタログに Freshdesk の項目はなく、Hacker News、Reddit、X を検索しても、Hermes と Freshdesk の構成を紹介している人は見つかりませんでした。そのため以下は、両ベンダーのドキュメントから組み立てたものです。いずれにせよ、自分で構築するならそうするしかありません。

何が変わったか：Freshdesk が独自の MCP サーバーを提供

少し前まで、外部エージェントを Freshdesk につなぐには、コミュニティ製コードか、Freshdesk API v2 を自前でラップするしかありませんでした。今では Freshdesk が自社でサーバーを運用しています。その MCP の記事には、"Starting September 10, 2026, the Freshworks MCP integration is generally available." とあります。

要点は次のとおりで、すべて Freshdesk の MCP FAQ と同じ記事に基づいています。

• プラン： Growth、Pro、Enterprise のうち、2021 Standalone または Omni 2026 バージョンのみ。レガシーアカウントは対象外です。
• エンドポイント： https://<subdomain>.freshdesk.com/mcp。カスタムドメインは使えません。
• 認証： API キーのみで、呼び出しはそのユーザーのロール権限に従います。
• ツール： 37個。チケット、会話、連絡先、エージェント、グループ、会社、ヘルプセンター記事を扱えます。削除や統合のツールはありません。
• デフォルトで有効。 管理者は Admin Settings > Apps & Integrations > MCP で無効にできます。

従量課金でもあり、これは Freshdesk にとって新しい点です。各プランのカードにその項目が表示されています。

Freshdesk は Claude Code、Claude Desktop、Cursor、Copilot Studio、VS Code をクライアントとして記載し、"any AI tool that provides MCP support" でも動くと補足しています。Hermes は HTTP 上で MCP を話すので、これに当てはまります。私の記事 Claude for Freshdesk を読んだ方にとっては、同じサーバーが早期アクセスを終え、より安いプランでも使えるようになった、ということです。

Hermes を Freshdesk につなぐ4つの方法

見つけられたすべてのルートと、最終的にあなたの API キーを保持するコードを誰がレビューしているかを以下にまとめます。

今なら1つ目を選びます。データを扱うベンダー自身が保守しており、ヘルプデスクの認証情報がサードパーティを経由しません。ヘルプセンターの記事にも対応していますが、effytech のサーバーには対応していません（ソリューション記事用のツールがないため）。Webhook ルートは4つ目の代替というより、トリガーに近いものです。チケットが届いたことを Hermes に知らせるだけで、実際に読み書きするには、結局ほかの3つのいずれかが必要です。

安全にセットアップする方法

私ならこの順で進めます。以下の手順の大半は、Freshdesk の FAQ にある次の一文のためにあります。"tool-level access management is not available. All supported MCP tools are available by default to any user who connects using a valid API key."

1. Hermes に専用のエージェントシートを与える

MCP サーバーは、API キーの持ち主であるエージェントとして動作します。自分のキーを貼り付ければ、Hermes はあなたにできることを何でもでき、書いたメモもすべてあなたが書いたように見えます。

私なら、ボット専用のエージェントを作り、限定的なロールを与え、「Hermes (draft only)」のような名前を付けます。Freshdesk では有料シートになり、Growth の年払いで月額 $19/エージェントからです。この構成の中で最も安上がりな安全機能です。Freshdesk がサーバー側で強制する制限は、ロール権限だけだからです。

2. サーバーを追加してツールを絞り込む

Hermes は MCP サーバーを ~/.hermes/config.yaml の mcp_servers に保持し、${VAR} のプレースホルダーを ~/.hermes/.env から解決します。サーバーごとにツールのホワイトリストも設定できます（Hermes MCP ドキュメント）。これと Freshdesk のエンドポイントおよび認証ヘッダーを組み合わせたのが下の設定で、2つのドキュメントから私が組み立てたものであり、公式の例ではありません。

mcp_servers:
  freshdesk:
    url: "https://yourcompany.freshdesk.com/mcp"
    headers:
      Authorization: "${FRESHDESK_API_KEY}"
    tools:
      include:
        - fetchTicket
        - fetchTicketConversations
        - fetchSearchTickets
        - fetchSolutionArticle
        - createTicketNote

include を設定すると、Hermes のドキュメントにあるとおり "Only those MCP server tools are registered." となります。つまり、この短いリストが、Freshdesk の権限ではできない役割を果たしてくれます。

Hermes にはサーバーごとの trust 設定もあります。untrusted のサーバーでは、"every write-capable tool call... requires user approval through the standard approval surface before it runs" となります（MCP 設定リファレンス）。デフォルトは full です。人が見ている Slack や Telegram のチャットから Hermes を動かすなら、untrusted に切り替えることで、メモごとに二重チェックが入ります。

3. 書くのは非公開メモだけ、返信は書かない

Freshdesk は API レベルでこの2つを分けています。/notes で追加したメモはデフォルトで非公開で、"Private notes are for collaboration between agents and are not visible to the customer." とあります。一方、更新エンドポイントには "Only public & private notes can be edited" とあります（Freshdesk API）。返信は一度送ったら、送信済みのままです。

流れはこうです。Hermes が非公開メモに下書きし、エージェントが目を通し、そのエージェントが自分の名前で返信を送ります。Freshdesk 自身の AI 下書き返信も同じ形ですし、あらゆるエージェントアシストツールもそうです。私のルールは、ミスが退屈に感じられるほど減るまで、この形にとどめることです。

4. トリガーを選ぶ：チャット、cron、Webhook

Hermes はチケットをいつ見るべきかを知る必要があり、選択肢は3つあります。

• リクエスト時。 エージェントが Slack にチケット番号を貼り、Hermes に下書きを頼みます。最も単純で、常に人が関与します。
• cron によるポーリング。 Hermes のスケジューラは60秒ごとに動き、事前チェック用スクリプトが {"wakeAgent": false} を出力すれば、変化がないとき "cron skips the agent run entirely" となります（cron ドキュメント）。「5分ごとに、このグループの新規チケットにメモを下書きする」という用途に向いています。
• Webhook。 チケット作成時の Freshdesk の自動化ルールが、http://your-server:8644/webhooks/freshdesk のような Hermes のルートに "Trigger webhook" を送ります。

3つのうち、Webhook は最もリアルタイムですが、最も手間がかかります。Hermes はすべてのルートにシークレットを求め、"a recognized signature header" のないリクエストは拒否します（Webhook ドキュメント）。Freshdesk のルールはカスタムヘッダーを追加できますが、本文に署名するオプションは見つかりませんでした。頼る前に、Hermes が受け付ける方式のうちどれをあなたのルールが実際に満たせるかをテストしてください。失敗すると Freshdesk は30分ごとに48回再試行し、Webhook は1時間あたり1,000回に制限されています（Freshdesk ヘルプ）。

Webhook については、さらにいくつか知っておくべき点があります。Webhook の実行は限られたデフォルトのツールセットで始まるため、チケットに触れる前に、ルートに手動で toolsets: ["mcp-freshdesk"] を付与する必要があります。ドキュメントはこうも警告しています。"HMAC validation authenticates the sender, not the content." チケット本文は顧客が書くので、信頼できないテキストとして扱ってください。唯一の書き込みツールを非公開メモにしておく、もう1つの理由です。

5. 信頼する前に過去のチケットでテストする

最も時間をかけるべきなのがここで、Hermes が最も助けにならない部分でもあります。先月のチケットを流して、下書きをチームが実際に送った内容と照らして採点するリプレイモードがありません。

自分で作ることはできます。解決済みのチケットを取得し、サンドボックスのプロファイル内で Hermes に処理させ、比較します。Freshdesk には注意点が2つあります。List Tickets は、updated_since を渡さない限り "by default" で "created within the past 30 days" のチケットしか返さず、検索エンドポイントは約300件で打ち切られます（Freshdesk API）。さらに、評価中の読み取りはすべて MCP の枠を消費するので、評価は REST API で行うほうが理にかなっています。「十分な品質」の目安については、ナレッジベースでの AI のトレーニングのガイドで詳しく説明しています。

Freshdesk で Hermes を動かす実際のコスト

ライセンスは無料です。請求書に載る残りの4項目は有料です。

MCP アクション。 "Any call to an MCP server counts as one action, regardless of whether it reads or writes data"（MCP FAQ）。枠はアカウントごと、年ごとに設定され、繰り越されません。

それを超える分は、料金ページによると1,000件あたり $15 です。REST の制限は API ドキュメントによるもので、運用している他のすべての連携とアカウント全体で共有されます。

役に立つ下書きには、1回の呼び出しでは足りません。Hermes はチケットを読み、次にスレッドを読み、類似チケットを検索し、ヘルプ記事を取得してから、メモを書きます。

1チケットあたり5アクションなら、Growth で年間約240件の下書き、月に約20件をカバーできます。それを超えると、アクション代はチケット1件あたり7.5セントになり、1件ごとには安く見えても、合計では見くびりやすい金額です。エージェントは再試行や探索もするので、5は平均ではなく下限と考えてください。ここに自分の数字を入れて試せます。

モデルのトークン。 Nous Portal の Plus は月額 $20 で $22 分のクレジット、Super は $100、Ultra は $200 です。対象の ChatGPT プランを接続して推論に使う方法もあります。

ボットのシート。 契約しているプランによって、月額 $19 から $89 です。

構築の手間。 見落とされがちな項目です。eesel の営業通話で出会った Freshdesk の購入担当者は、年間2万件のチケットを目指すメールセキュリティ企業で、1回のテスト日に200件のやり取りをこなし、最初に尋ねたのは、月9,000件になったらどうなるか、ということでした。従量課金の AI では、ボリュームがサポートリーダーの最初の疑問になります。Hermes では、トークンと MCP アクションの2つに加えて、エンジニアの工数という3つを同時に計測することになります。最後の工数については、私の build vs buy の内訳で数字を示しています。

Freshdesk 上の Hermes が行き詰まるところ

ここまでの話は、下書きという形を前提としています。Hermes を Freshdesk の顧客に直接向けた途端、一般的なサポートレビューで私が突き当たったのと同じ壁にぶつかります。

• メモリは依頼者ごとではなく、プロファイルごと。 内蔵メモリは MEMORY.md（2,200文字）と USER.md（1,375文字）で、プロファイルが実行するすべてのセッションに読み込まれます（メモリのドキュメント）。ある顧客のチケットから保存した内容は、次の顧客のプロンプトにも残ることになります。
• Freshdesk への配信先がない。 Webhook 実行の deliver オプションは、チャットプラットフォーム、メール、ログのいずれかです。回答をチケットに戻すには、必ずツール呼び出しを経由します。
• リハーサルがない。 上で触れたとおりで、私が最も重く見ている欠点です。
• ネイティブのボットがすでにある。 Freshdesk の Freddy AI Agent は全プランに付属し、500件の1回限りのセッション、その後は100件あたり $49 です。Freshdesk 内の顧客向けボットが欲しいなら、Hermes はヘルプデスクがすでに販売しているものを作り直すことになります。

Hermes ベースのヘルプデスクを実際に運用している Hacker News のユーザーが1人いて、そのスレッドはトレードオフをよく表しています。

"We replaced our helpdesk with Hermes. It has long term memory about our business. When a customer messages us, Hermes gets all the relevant details about the customer and creates a Pi session using Gemma 4 running locally and customer talks to that agent."

theturtletalks, Hacker News

最初の返信は、それが "one customer's data leaking to another" のリスクにならないかと尋ねていました（dezgeg, Hacker News）。ただ、設計を見てください。顧客が話す相手は Hermes ではなく、顧客ごとに別のローカルセッションを立ち上げています。理にかなったアーキテクチャですが、かなり大掛かりでもあります。

Freshdesk での Hermes、Freddy AI、eesel の比較

より広い比較については、私のまとめ best AI for Freshdesk と Freshdesk AI alternatives のリストがさらに詳しく、Hermes Agent alternatives は汎用エージェント側を扱っています。

Freshdesk のキューで Hermes を動かすべきか

両方のドキュメントを読んだうえで、私が行き着いた結論はこうです。

向いているのは、 この種の作業を楽しめるエンジニアがいて、仕事がエージェントがレビューするメモの下書きであり、ボリュームがアクションの枠に収まる場合です。公式 MCP サーバーに5つのツールの include リストを組み合わせた構成は、筋の通った説明のつく設計で、その上で Hermes の cron と Webhook 機能が本物の自動化をもたらします。Freshdesk の履歴から自分たちのチームの質問に答える社内サポートチャットボットとしても相性が良いです。

向いていないのは、 AI に顧客へ回答させたい場合や、SSH なしでサポートマネージャーが読める、AI の全アクションの記録が必要な場合です。YAML ファイルと評価の仕組みを保守する人を割けない場合も同じです。そして、どのベンダーにも行う Freshdesk のセキュリティレビューは、自分のサーバーで行うものに変わります。

正直に言えば、Freshdesk は配線を簡単な部分にしました。残るのは AI のハルシネーションの問題と、その周りのリハーサルやガードレールで、それこそがキューに AI を載せる本当の仕事です。

Freshdesk 向けの eesel

Hermes を調べた理由が、AI に Freshdesk のチケットをさばいてほしいからなら、eesel はまさにその仕事のために作られたチームメイトです。Freshdesk のサブドメインと API キーで接続でき、インストールするアプリはなく、解決済みチケットに加えて、ヘルプセンターと定型返信からも学習します（eesel ドキュメント）。

上記の課題にどう対応するかは次のとおりです。

• まずリハーサル。 顧客に1通も返信する前に、過去の Freshdesk チケットでシミュレーションします。
• 書き込みレベルを選べる。 社内メモを残す、返信の下書きを承認待ちにする、送信する、のいずれも可能です。タグ付けと割り当て、ステータスの設定とフィールドの更新も含まれ、Freshdesk の自動トリアージもカバーします。
• 呼び出しごとの課金なし。 返信が何往復しても、チケット1件は1クレジットです。プランは500クレジットで $299から、無料プランには100クレジットが付きます。
• Freshchat も含む。 同じ接続で Freshdesk のチャットもカバーされ、2回目のセットアップは不要です。

Hermes の魅力の半分がターミナルだったなら、eesel にもあります。eesel CLI は同じチームメイトを操作します。eesel integrations connect freshdesk でアカウントを連携し、eesel integrations download start でチケット履歴を取り込み、eesel automations で各トリガー時の動作を設定します。コマンドは JSON を出力するので、スクリプトや Claude Code のようなコーディングエージェントが Freshdesk のセットアップを最初から最後まで実行できます。詳しくは私の記事 CLI for customer support をご覧ください。

Hermes は、得意な仕事のために取っておきましょう。ただ、Freshdesk のキューについては、まず実際のチケットで eesel を試してください。