Claude for HubSpot：2026年にあらゆる方法で接続する

Claudeはすでに Service Hub の内部にいる、ただし探すべき場所とは違う

私は仕事として連携を構築しているので、こうした問いに対して最初にすることは、マーケティングページではなくモデルカードを読むことです。HubSpotはtrust.hubspot.com/aiに優れたモデルカードを公開しており、製品内のすべてのAI機能について機能ごとのデータフロー図を掲載しています。これはほとんどのベンダーが提供するより多くの開示であり、「これはどのモデルか」という問いに、どんなブログ記事も反論できない形で答えています。私たち自身のHubSpotが使っているAIの記事も同様です。

そこに書かれている内容はこうです。プラットフォーム全体を通して、HubSpotが名指しするサードパーティのモデルベンダーはちょうど2社だけです。すべてに使われているOpenAIと、3つの機能面のうち2つで使われているAnthropicです。そして、その配分は誰もが予想するものとは違います。

この表をもう一度読んでください。これこそが本稿が存在する理由のすべてだからです。HubSpotがチケット解決の自動化と説明するカスタマーエージェントは、完全にOpenAIによって提供されていると文書化されています。Claude Opus 4.5は確かにAgents製品の中にあるのですが、プロスペクティングエージェントにルーティングされます。一方で、Service Hub内の組み込みAI機能は、その出力にヘルプデスクの返信や通話要約が含まれると明記されているにもかかわらず、Claude Sonnet 4を確かにリストしています。

つまりClaudeは返信を下書きする側の経路にあり、OpenAIは自律的に回答する側の経路にあるということで、これはこのテーマを検索するほとんどの人が想定するものとほぼ正反対です。Sonnet 4が2025年世代のモデルであり、現行の最先端モデルではないこと、そしてそれを進化させる手段があなたにはないことも指摘しておく価値があります。各図には小さな「Model Protection Layer」というステップがあり、Llamaを基盤にしており、生成するモデルが何であれその周囲で安全フィルターとして機能しています。

取り繕うより指摘しておきたい正直な食い違いが一つあります。Anthropicは、2026年4月改訂時点のHubSpotのサブプロセッサー一覧のどこにも登場せず、そこにはAIサービスプロバイダーという目的のもとでAWS、Google、OpenAIが名指しされています。モデルカードはClaudeと言い、サブプロセッサーのページはそう言っていません。AWS Bedrockが明白な整合の説明ですが、HubSpotはそう言っていないので、私も彼らの代わりに言うつもりはありません。

まず、どのルートもできないこと

4つのルートに入る前に上限の話をします。これを知っておけば午後をまるまる一つ節約できます。

HubSpotのリモートMCPサーバーは、公式であれ自作であれ、すべてのClaude接続の基盤となる配管です。そのアクセステーブルは特定の形で非対称です。チケットは読み取り、作成、更新が可能です。連絡先、会社、取引、カスタムオブジェクト、製品、明細行、そして5種類すべてのエンゲージメントタイプも読み取り、作成、更新が可能です。しかし会話、つまりライブチャット、チームメール、WhatsApp、SMS、Facebook Messengerからの実際のメッセージとスレッドは、読み取りリストにしか登場しません。

実際には、コネクタでもMCPサーバーでも、Claudeは40件のメッセージからなるスレッドを喜んで読み、顧客が何を必要としているかを解き明かし、疲れ切った金曜午後のあなたよりも良い返信を書き、チケットのプロパティを更新し、その全てをメモとして記録します。そしてそこで止まります。人間がそのテキストを返信欄にコピーして送信を押すのです。

削除も、どのオブジェクトに対してもできません。これは制限というより理にかなったデフォルト設定です。そしてアカウントでSensitive Dataが有効になっている場合、アクティビティと会話データは標準のCRM APIには適用されない形でMCP経由に限って特にブロックされ、規制業種のチームにとってはサポート用途の有用な半分が消えてしまいます。

送信の制限はHubSpotのプラットフォームの特性ではなく、MCPの特性です。以下のルート4はこれを解除しますが、代わりに何かを構築する必要があります。それが本稿の残りが扱うトレードオフです。

ルート1：Claude向けのHubSpot公式コネクタ

これが始めるべきルートであり、正直に言えばほとんどのサポートチームにとって、ここで止まっても構わないルートでもあります。

HubSpotは2025年7月にコネクタをローンチし、Claude向けにコネクタを提供した最初のCRMだと謳っています。HubSpotが構築・保守し、Anthropicのディレクトリclaude.com/connectorsに掲載されており、ウェブ、デスクトップ、モバイルのClaude、さらにClaude CodeやAPI経由でも動作します。

これがどれほど珍しいかの参考として、他のヘルプデスク向けに同等のページがないか探してみましたが、何も見つかりませんでした。Zendesk、Freshdesk、Salesforce、Front、Gorgiasには同じパスのディレクトリ掲載がありません。すでにService Hubを使っているなら、カテゴリの大半が持っていないネイティブな橋渡しを手にしていることになり、それは他の何より先にこれを試す本物の理由です。スタックを比較しているなら、Claude for Zendeskで近いケースを扱っています。Claude for Freshdeskの記事はさらに近い並びで、Freshdeskにはディレクトリ掲載自体がありません。

費用と誰が有効化できるか

コネクタは無料です。要件のほうが興味深い部分です。

• 有料のClaudeプラン。 Pro、Max、Team、Enterpriseのいずれか。ナレッジベース記事によると無料のClaudeでは利用できません。Proは年間契約で月17ドル、月契約で20ドル、Teamは年間契約でシートあたり20ドルです。
• どのHubSpotプランでも可。 ナレッジベース記事はすべての製品・プランに対応と明記されています。ネイティブのカスタマーエージェントを制限するプランであるService Hub Professionalは必要ありません。
• Super Admin、またはApp Marketplaceの権限。 一人の管理者が接続し、その後ユーザーにアクセス権を付与します。他の誰かが先に設定することはできません。

本当に4分で終わるセットアップ

Claude側では、プロフィールアイコン、Settings、Connectors、Browse connectors、Webタブ、HubSpotの順に進み、Add to your teamを選びます。connectors画面に戻ってHubSpotの隣のConnectをクリックし、HubSpotアカウントにログインし、権限を選び、Connect appします。次にHubSpot側では、Settings、Integrations、Connected Apps、HubSpot connector for Claude、Give users accessの順です。チャットで使うには、Search and toolsを開いてHubSpotを有効にします。

そこにいる間に、当たり前ではないことを一つやっておきましょう。Write tools を Needs Approval に設定することです。 HubSpotはこれを明示的に推奨しており、Always allow の場合は事前の確認なしに編集が行われる可能性があると警告しています。Claude自身の管理コントロールでは、Ownerが各ツールをAlways allow、Needs approval、Blockedのいずれかに、読み取りと書き込みでグループ分けして設定でき、TeamまたはEnterpriseではこの設定は組織全体に適用され、メンバーが上書きすることはできません。「Claudeにヘルプデスクを読ませてもいいが、絶対に触らせたくはない」という姿勢が欲しいなら、これがそのためのレバーであり、良いものです。

実際に何が得意か

HubSpotは独自のサポート向けサンプルプロンプトを公開しており、それはこのルートがどこで輝くかの妥当な指針です。今月の受信箱やヘルプデスクのチャネル全体でよくある質問を要約し、トレンドの問題を見つける。優先度順に並べ替えた、担当者別のすべての未解決チケットを一覧する。チケットに解決メモを記録する。まるであなたのキューの隣に座る、とても優秀なアナリストです。

これは決して小さなことではありません。トレンドの問題を検知するのは本物の仕事であり、手作業でやるとなればCSVをエクスポートして目を凝らすことになります。チケット分類に本気で取り組もうと考えていたなら、このルートは一回の会話で使える答えをくれます。またHubSpotが他の場所で課金している要約作業もそこそこうまくこなし、それは私たちの会話の要約の記事で扱っています。

すべての書き込みはあなたとコネクタの両方に紐づけられてHubSpotの監査ログに記録され、Super Adminは誰がいつ接続したかを確認できます。リクエストはあなたのデータセンターの所在地を尊重してHubSpotのサーバー経由でルーティングされるため、EUアカウントはHubSpotのEUデータセンターを経由し、その後Anthropicの利用規約が適用されます。Anthropicはコネクタ経由で共有されたデータをモデルの学習には使用しません。

契約前に知っておくべき落とし穴

いくつかは小さく、二つはそうではありません。

• 一括書き込みは10件までに制限されています。 チケット向けには十分ですが、クリーンアップには手間がかかります。
• カスタム検証ルールは書き込み時にバイパスされます。 パイプラインステージの検証や関連付けラベルの検証を含みます。あなたが慎重に構築したガードレールはコネクタの編集には適用されません。
• 一度に1つのClaudeアカウントにつき1つのHubSpotアカウント。 代理店はそれを踏まえて計画してください。
• 権限の付与はほぼ一方通行です。 Super Adminがユーザーにアクセス権を付与すると、その操作は取り消せません。アカウントレベルでのアンインストールはユーザーレベルのアクセスを除去せず、後で権限を絞りたい場合は管理者とすべてのユーザーによるアンインストールと再インストールが必要です。
• ディレクトリのバッジは実力を過小評価しています。 Anthropicの掲載には「Read only」という機能バッジが付いていますが、HubSpot自身のオブジェクトマトリクスはチケットの作成と更新を明記しています。この点はHubSpotのドキュメントを信じてください。
• 接続はあなたのマシンではなくAnthropicのクラウドから発生します。 そのため、ファイアウォールで保護された、あるいはVPN限定のMCPサーバーは、許可リストへの追加なしには動作しません。

最後の項目は十分に多くの人を引っかけるため、r/hubspotには元投稿者がコネクタを読み取り専用だと思い込んで訂正されたスレッド全体があります。

"You'll be happy to know they updated the connector a whole back and it now has write access. With Breze it's capabilities and access to tools are strictly inside hubspot ecosystem. With claude the sky's the limit."

u/BrianGibsonSells, Reddit

ルート2：同じMCPサーバーを自分で配線する

チャットウィンドウからではなく自分のコード内からClaudeにHubSpotを読ませたいなら、同じサーバーに直接向けることになります。

エンドポイントはStreamable HTTP経由のhttps://mcp.hubspot.comで、2026年4月13日以降、追加オプション不要ですべてのハブ・全プランで一般提供されています。認証はOAuth 2.1とPKCEで、これは必須です。クライアントが自分でPKCEを処理しない場合、43〜128文字のcode_verifierを生成し、S256でチャレンジを導出し、code_challenge_method=S256を渡します。

Development、MCP Auth Apps、Create MCP auth appの順にHubSpot内で「MCP auth app」を作成すると、HubSpotがOAuth認証情報を生成します。プライベートアプリのトークンを使う経路はもう終わっている点に注意してください。2025年5月のベータ版はnpmパッケージとして提供され、Claude Desktopの設定にプライベートアプリのアクセストークンを貼り付ける方式でしたが、リモートサーバーがそれを置き換えました。

スコープは予想とは逆の動き方をします。自分で宣言することはありません。インストール時点で利用可能なツールとユーザーが許可したものから導出されるため、HubSpotが新しいツールをリリースすると、すでにインストール済みのユーザーは再インストールが必要になります。障害のサインは新しいオブジェクトタイプに対するREQUIRES_REAUTHORIZATIONステータスで、切断してから再接続すれば解決します。セッション開始時にget_user_detailsを呼び出すことは、実際に何を持っているかを確認するためのHubSpot自身の提案です。

16個のツール、サポート用途で重要な2つ

サーバーは16個のツールを公開しています。ヘルプデスク用途では、4つが仕事をこなします。

計画しておくべきことが2つあります。search_conversationsを使うには、まずget_conversation_channel_metadataを呼び出して受信箱を把握する必要があります。そしてベクトル検索は存在しません。サーバーはCRM検索APIの上に構築されているため、これはキーワードとフィルタによる取得であり、意味的な検索ではありません。Claudeが意味的にこのチケットに最も似た3件を見つけてくれると想像していたなら、それはその上に自分で構築するものです。

可視性は2つの受信箱製品の間で、人を驚かせる形で分かれます。ヘルプデスクの会話はすべてのユーザーに見えますが、会話受信箱については、アクセスが特定のユーザーやチームに制限されている場合、その対象ユーザーだけがMCP経由でそれらを照会できます。

アプリではなくAPIから

Messages APIはリモートMCPサーバーを直接呼び出すことができ、これが自分の製品内でClaudeにHubSpotを読ませる方法です。この経路の料金はシートあたりではなくトークンあたりで、私たちのSonnet 5の料金の記事に現在のレートがあります。これはベータヘッダーmcp-client-2025-11-20の背後にあり、mcp_serversとtools内のmcp_toolsetエントリを介して設定し、Claude API、AWS、Microsoft Foundryで利用できます。ツール呼び出しのみで、MCPのリソースやプロンプトはなく、HTTPSのみでローカルstdioはなく、OAuthのやり取りは自分で処理します。私たちのClaude AI連携の記事はクライアント側についてさらに深く扱っています。CLI版の相当品についてはClaude Code MCPツールをご覧ください。

レート制限は、このルートが本気になる場所です。MCP固有の公開された制限はないため、プラットフォームの上限が適用されます。マーケットプレイス配布のOAuthアプリは、インストールしたアカウントごとに10秒あたり110リクエストを得られ、API制限引き上げアドオンはこれを引き上げてくれません。その下では、CRM Search APIはアカウントごとに秒あたり5リクエスト、1ページあたり200オブジェクト、クエリごとに合計10,000件の結果に制限されています。

秒あたり5件が設計の基準にすべき数字です。忙しいキューでチケットごとに検索を発火させるエージェントはこれに到達します。100件のレコード取得上限も、思っているより早く効いてきます。

"Yep — we tested it with an internal assistant and the permission model is the part that matters most. What worked: - Separate private app for MCP (don't reuse your main integration) - Read scopes only to start"

Anyone using HubSpot MCP?, Reddit

そのスレッドの投稿者自身も、もともとはユーザーを読み取り専用に保つ方法を尋ねていたのに、ほぼ即座にその上限にぶつかりました。呼び出しごとのレコード上限は「例えば現在のパイプライン総額を要約するような質問を試みることを即座に問題化させる」と述べています。

ルート3：HubSpot自身のAI、Claudeに向けることはできない

数週間おきに、誰かがHubSpotのどこにモデルのドロップダウンがあるのかと私に尋ねます。存在しませんし、それがどれほど徹底して存在しないかについて正確に述べたいと思います。というのも、その不在は機能の欠落ではなく設計上の判断だからです。

Agent Builderが提供するのは4つだけです。Instructions、Actions、Knowledge、Inputs。「model」「LLM」「API key」という言葉はドキュメントのどこにも登場しません。AIの設定は6つのオン・オフスイッチです。プロバイダー選択もなく、自前のキーを持ち込む欄もなく、カスタマーエージェントのOpenAIモデルをClaudeのモデルに交換する方法もありません。HubSpotが選んだものが動くものすべてです。

HubSpotが実際に持っているもの、そしてこの領域の混乱の大半を引き起こしているものは、逆方向を向いた2つ目のMCP製品です。

MCPサーバーはアウトバウンドです。あなたのAIがHubSpotを読みます。MCPクライアントはインバウンドです。HubSpotのエージェントがあなたの他のシステムを読みます。このクライアントは実在し、HubSpotの評判が示唆するよりも優れており、ネイティブコネクタ経由でNotion、Atlassian、Asana、Zapier、G2、Linear、Gong、Amplitudeに届き、Starterプランから利用可能です。

一つ落とし穴があり、それこそが重要な落とし穴です。これらのコネクタへの文書化されたすべての経路はAgent Builderを通り、カスタマーエージェントにはConnectorsタブがありません。つまり「HubSpot AIはConfluenceを読める」というのは、あなたが自分で構築するバックオフィスのエージェントについては真ですが、あなたの顧客に返信するエージェントについては偽です。もし誰かがHubSpotは壁に囲まれた庭だと言うなら、それは間違っており、もし誰かがあなたのサポートボットがConfluenceのスペースを読めると言うなら、それも間違っています。この命名は誰の役にも立っていません。私たちの解説記事HubSpot Breeze AIとは何かが残りの用語を整理し、Breezeは価値があるかがその結論を出しています。そして、そう、「Breeze」は静かに引退しつつあります。HubSpot自身の製品ページは今やその総称を「かつてのBreeze Agents」であるAgent Hubと呼んでいます。

ルート4：チケットと会話のAPI上に自分で構築する

これが実際に送信を押せるルートであり、そもそもルートとして存在する理由です。

読み取りは単純です。ticketsスコープを持つGET /crm/v3/objects/tickets/{id}がレコードを取得し、conversations.readを持つGET /conversations/v3/conversations/threads/{threadId}/messagesがスレッドを取得します。両者の紐づけは明示的で、?associatedTicketId=または?association=TICKETを渡します。ここまでは、ごく普通です。

送信はMCPルートにはできない部分です。conversations.writeを持つ同じメッセージエンドポイントへのPOSTで、typeフィールドがすべてを決定します。"MESSAGE"は顧客に届き、"COMMENT"は社内メモです。送信専用のスコープは存在しないため、この一つのフィールドが、下書きと顧客の受信箱に届くメールとの間にあるあなたの安全境界線のすべてです。senderActorIdは実在するHubSpotユーザーにマッピングされなければならないため、ボット用のシートを予算に組み込んでください。WhatsAppはAPIによる送信から明示的に除外されています。

これを構築するなら、4つのことがあなたを痛い目に遭わせます。それらはデモと本番の違いです。

1. 切り詰められたメール本文。 メッセージにはtruncationStatusが付いており、切り詰められた本文には元のコンテンツを取得する別の呼び出しが必要です。これを無視するエージェントは、スレッドの半分について自信満々に推論してしまい、それは失敗よりも悪いことです。
2. Webhookのタイムアウト。 conversation.newMessageとticket.*のイベントがトリガーをカバーしますが、HubSpotは5秒後に再試行し、24時間で最大10回、最大100件のイベントを10並列のバッチで送ります。5秒はLLM呼び出しには収まりません。即座に確認応答し、非同期で処理し、冪等にしないと、誰かに二重に返信することになります。
3. 1日あたりのレート制限は共有です。 プライベートアプリはFreeとStarterで10秒あたり100リクエスト、ProfessionalとEnterpriseで190リクエストを得られ、1日あたりの上限はそれぞれ25万、62.5万、100万です。バーストの制限はアプリごとですが、1日あたりの上限はアカウント内のすべてのアプリで共有されるため、別の連携があなたのエージェントを飢えさせる可能性があります。
4. オフボーディングがあなたを機能不全にしうる。 プライベートアプリの作成にはSuper Adminが必要で、アカウントあたり20個までに制限されており、作成したユーザーを削除するとトークンがUSER_DOES_NOT_HAVE_PERMISSIONSで壊れます。

一つ嬉しい驚きがあります。これらのどの部分も、有料プランでロックされているわけではないということです。チケットとConversations Inboxはどちらも、HubSpotの無料プランで利用できます。有料プランが買うのはレート制限であって、アクセスではありません。移行も計画に入れてください。HubSpotは新規連携の推奨バージョンとして2026-09-betaを挙げていますが、完全に文書化されている唯一のエンドポイント群はレガシーとラベル付けされています。

それが、このルートについて私が本当に言いたいことにつながります。

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

Karel, GENERAL BYTES

顧客がまさにこれを構築するために去っていくのを見てきました。そのうちの2社、AR建設テック企業とD2Cビューティーブランドは、Claude APIの上に直接構築するために離れていきました。「自分たちでLLMのAPIの上に構築すればいい」というのは、技術系チームで私たちが最もよく出くわす競合の代替案です。私はそれが決してうまくいかないふりをするつもりはありません、時にはうまくいくからです。ただ言えるのは、トークンの請求額は安い部分だということです。高くつくのは、切り詰め処理、冪等性、リトライキュー、送信者用のシート、そして18か月後にそれを所有する人です。

AIの1返信が実際にいくらかかるか

3つのルートはまったく異なる測り方をするため、自分自身の数字を当てはめるまではほとんど比較不可能です。HubSpotは解決件数ごとにクレジットを課金します。Claudeはトークンを課金します。eeselはチケットごとに課金します。同じ仕事に対して3つの異なる単位があり、私たちのチケット自動化のレビューがそれぞれが何を買うのかを解説しています。

クレジットが実際にどこで尽きるか

上記のウィジェットは、本文でも書いておく価値のある一つの計算をしています。この記事全体で最も役立つ数字だからです。

HubSpotの法的カタログは、テキストベースのチャネルで1件の会話を解決するのにカスタマーエージェントが50クレジットかかると設定しており、クレジットは1,000クレジット分の容量パックあたり10ドル、または従量課金では1件あたり0.010ドルです。料金ページ自身の見積もりでは、年間契約で1,000あたり9.00ドルと述べています。いずれにせよ、解決した会話1件あたりおよそ45〜50セントに落ち着き、この解決あたりの数字がそもそも料金ページには一切載っていないことに注意してください。それは法的カタログの中にあります。

これを含まれるクレジットに当てはめてみましょう。

Service Hub Professionalは月3,000クレジットを含んでおり、これは60回の解決、1日あたり約2回です。Enterpriseは5,000クレジットを含むので100回です。Starterの500クレジットは、Starterにはそもそもカスタマーエージェントがないため関係ありません。これらのクレジットはアカウント全体に対するもので、シート数に応じてスケールせず、繰り越しもされません。さらにAgent Hubが行う他のすべてとも共有されており、データエージェントの実行1回は10、コンテンツエージェントの1本は1,000を消費します。

契約する前に知っておきたい、この課金の仕組みについてさらに2点あります。

「解決」の定義には鋭い刃があります。 会話は、エージェントがコンテンツソースを引用して回答するか、何らかのアクションを実行し、かつ最後の訪問者応答から72時間以内に適格なハンドオフが発生しない場合に、解決済みとしてカウントされます。HubSpotは明確に述べており、ワークフロー経由のものを含む手動での担当者割り当ては適格なハンドオフに当たりません。つまり、担当者が静かに悪いAI回答を引き継いでも、それでも解決として課金されます。ステータスは72時間で確定し、その後の引き継ぎやネガティブなフィードバックはそれを覆しません。もしメールスレッドがその期間の後に再開されれば、時計はリセットされ、再び課金されうる可能性があります。

この注意点は、HubSpotの見出しの数字を読むときに重要になります。料金ページは70%以上を自動解決と謳い、カスタマーエージェントのページはそれを70%、トップチームは90%に達すると位置づけています。どちらも方法論を公開しておらず、上記の解決の定義がその一部の説明になっています。低いほうの数字でモデル化し、私たちのService Hubのチケットデフレクションの記事とより広いService Hub AIのレビューにある実際の数字と照らし合わせてください。

尽きるのは完全な停止であり、回復はラチェットです。 クレジットがなくなると、エージェントはリセットまたは追加購入まですべてのチャネルで新しい会話の割り当てを受けなくなります。そして一度パックを購入すると、デフォルトの挙動は契約期間の残り全体でより大きなパックへ自動的にアップグレードされることであり、従量課金に切り替えない限り、更新のタイミングでしかキャンセルできません。

このメカニズムはr/hubspotでHubSpot AIについて最も議論されているもので、体験談は具体的です。

"when you go over that limit, the limit automatically raises. In the case of the AI credits, we went from 3K credits to 362K, without even asking for it. Then we could not set a lower limit (the system prevents it)...and then the real billing started. Pretty messed up approach..."

u/Practical-Pepper4564, Reddit

HubSpotに公平を期すなら、これらのスレッドの大半はカスタマーエージェントより一括エンリッチメントについてのものであり、それはずっとゆっくりと課金されます。ただしメカニズムは同じであり、私が実際に心配するのは二次的な効果です。

"I don't know how many credits I'll need, so I'm less likely to test things, not more."

u/HelixButHuman, Reddit

それがクレジット制の本当のコストであり、合計額とは何の関係もありません。それは人々に実験することを怖がらせます。私たちのHubSpotクレジットの解説には完全な段階が、HubSpot AIのコスト内訳にはそれをシート費用と並べたものがあります。

ほとんどの人が見逃している無料のレバーが一つあります。ヘルプデスク内の返信レコメンデーションはクレジットを消費せず、エージェントをデプロイする必要すらありません。アクションのテストと設定も無料で、初回セットアップは14日間の無料アクセスを選べます。自律的なボットではなく担当者向けのコパイロットが欲しいなら、それは何もかかりません。

ネイティブエージェントがすでにできること、そしてやらない一つのこと

このセクションをHubSpotの欠点のリストとして書くのは簡単でしょう。それはまた不公平でもあります。というのも、カスタマーエージェントは十分に良い製品であり、セットアップの流れはこのカテゴリの中でも特によく考えられたものの一つだからです。

名前を付け、性格を選び、それからコンテンツを与えます。ナレッジ面では、HubSpotはその評判が示唆するよりもオープンです。ドメインごとに最大5,000件の公開URLをクロールし、HTMLは25MB、他のファイルは500MBまでで約22種類のファイルタイプを受け付け、ナレッジベース記事、ウェブサイトのページ、ランディングページ、ブログを同期します。

ナレッジ面をきちんとセットアップするなら、私たちのHubSpot AIナレッジベースのガイドとナレッジベースソフトウェアの概要が最初に読むべき2本です。

壁が実際にどこにあるか、それぞれ推測ではなくHubSpot自身が明記しているものです。

• クローラーは認証されていません。 ログインで保護されたページは401か403を返し、HubSpot自身が文書化している回避策は、エラードキュメントによればコンテンツをPDFかDOCXとしてアップロードすることです。noindexタグ、制限の厳しいrobots.txt、そして重いJavaScriptもそれをブロックします。そのユーザーエージェントはIPレンジ54.174.58.224/27からの「HubSpot Crawler」です。
• ナレッジベース記事だけがリアルタイムで同期されます。 それ以外はすべて毎週更新です。
• ヘルプセンターのインポートは一度きりのコピーで、Freshdesk、Help Scout、Zendeskから1回のインポートにつき400記事に制限されており、テーブルはサポートされず、ソースへの継続的な同期もありません。
• CRMへの書き込みは連絡先プロパティのみで、合計最大10プロパティまでです。チケット、取引、会社、カスタムオブジェクトのプロパティはなく、これはチケットルーティングのためにできることも制限します。
• 削除はできず、一時停止のみで、オフスイッチはエージェントのUIではなくAccount and Billing、Usage and Limitsの下にあります。

本物のテスト用コンソールも備えており、このギャップを誇張するのは間違いなので正確に述べたいと思います。EmailやLive Chatでプレビューでき、実在のCRM連絡先として、あるいはセグメント全体としてテストしてプロパティアクセスを実際に検証でき、10MBまでのファイルを添付でき、どのトリガーが発火し、どのソースが引用されたかを示すTesting Insightsパネルを読むことができます。すべて無料です。

持っていないのは、過去のチケットの束をエージェントに通して、公開前にその結果を採点する文書化された方法です。フローの中のすべての入力は、あなたが入力する質問か、あらかじめ用意されたテスト用の質問です。HubSpot自身のリスク低減の道筋は、ライブトラフィックのランプアップです。1つのチャネルにデプロイするか、エージェントを会話の一部の割合に制限してから分析し、拡大する。デプロイ時のConversation coverageフィールドは文字どおりパーセンテージのダイヤルです。

これが私が最も気にする違いであり、小さなものではありません。カバレッジのランプアップは、実際の顧客をテストセットとして使いながら信頼を築きます。バックテストは、誰も影響を受ける前にそれを築きます。自信満々に聞こえるボットが本番で間違った答えを出すのを見てきた身としては、それを今朝のチケットに対してではなく、前四半期のチケットに対して見つけたいと思います。

とはいえ、正当に評価すべき点もあります。Knowledge Gapsというレポートは良い工夫で、人々が繰り返し尋ねているのにナレッジベースがカバーしていないトピックを表面化させ、不足している記事を書くことを提案してくれます。

最後に知っておく価値のあることが一つ、機能ではなくデータの側に分類されるものです。HubSpotのAIモードのトレーニング設定はデフォルトで有効になっており、過去のトレーニングデータを遡って削除することはできません。サードパーティのプロバイダーにあなたのデータで学習させないこと、そして「可能な限り」ゼロリテンションであることを約束していますが、それは保証ではなく目標です。アカウントがオーストラリアやカナダのデータセンターにある場合でも、AI処理はそれでもアメリカ合衆国で行われます。

実際に運用者が直面していること

ドキュメントは何が可能かを教えてくれます。スレッドは火曜日に何が起きるかを教えてくれます。私が見つけた最も明快な構造的まとめは、3つの機能面すべてを運用してきた管理者からのものでした。

"The in-app connector is fine for basic end user stuff like querying HubSpot. However it has tons of limitations and gotchas, for example you can't access campaigns. The MCP client calls the API and is much more robust but requires some basic dev skills to work with."

u/Asleep_Start_912, Reddit

これは私が上で示したのと同じ三分割であり、独立してたどり着いたものです。なお、この特定の管理者はClaudeではなくGeminiコネクタを運用しているため、これはClaudeそのものについてではなく、コネクタ対MCP対ネイティブについての指摘として読んでください。

この集合の中で最も役立つ体験談は、MCPサーバーの代わりにClaude Code CLIから3週間HubSpotを運用した人によるもので、切り替えには2つの具体的な理由がありました。

"The MCP, from all my experience, has always been problematic because it overloads context on your initial tasks. Also causes rate limits because of the amount of tokens you have to pull in just from the server. The private app with CLI is like the new move."

u/Shawntenam, Reddit

その2つ目の指摘こそ、私が強調したいものです。16個のツールを持つサーバーの定義は、毎ターンコンテキストに乗ってきて、その下で秒あたり5リクエストという制限があるため、トークンのオーバーヘッドとレートの上限は積み重なっていきます。同じ実践者は、私自身も経験した障害モードを指摘しています。MCPツールは設定が指す先のポータルに対して認証を行い、それが間違ったポータルだった場合、症状はエラーではなく空の応答になります。「結果がゼロ」をデバッグするのは、403をデバッグするよりもずっと難しいのです。

Claudeの経路についての正直な評決は、レガシーの多いポータルを運用している非エンジニアから、3つの言葉で寄せられています。

"Claude connector or mcp helps drive changes and is good at looking at your portal - but there can be drift. Side quests. Loss of context."

u/CFP-ForAllMyBrothers, Reddit

そしてHubSpotのネイティブエージェントについて私が言える最も公平なことは、人々がそれに助走をつけてやれば機能するということです。これはこの資料全体で最も数値化された報告です。

"Customer agent handled 40% of our support inbounds last month and took our overall average first response time to hardly anything. We average over 15k inbounds per month."

u/Large_Customer_548, Reddit

月15,000件の問い合わせに対して40%のデフレクションは本物の成果であり、この運用者自身が挙げている2つの前提条件に注目してください。課金が重要になるまで4か月間エージェントを運用していたこと、そしてすでにAIが読むために調整されたナレッジベースがあったことです。この両方が本当の仕事であり、どちらも買える機能ではありません。

私なら実際にどう決めるか

4つのルートがあり、その選択は能力の問題というより、あなたがどの仕事のために雇っているかの問題です。

正直な結論は、今日の午後、公式コネクタから始めることです。無料で、4分かかり、Claudeに「今月のヘルプデスクでよくある質問トップ10は何?」と尋ねるだけで、ダッシュボードを1週間眺めるより多くのことをキューについて教えてくれます。書き込みツールをNeeds Approvalに設定し、そのままにしておいてください。

その後は、自分が何を持っているかについて明確になってください。あなたは読むことができる優秀なアシスタントを持っています。解決するエージェントは持っていません。それが欲しいなら、解決1件につき50クレジットを課金し過去の履歴に対してリハーサルできないHubSpotのカスタマーエージェントと、目的特化型の何かとの間で選ぶことになります。私たちはService Hub AIの代替案でその全体像を並べています。

ルート4は、私が最も強く反対したいルートであり、これを構築するのが楽しいだろうと思う立場から言っています。APIは実際に完全な自律ループをサポートしており、トークンのコストは驚くほど低いです。しかし上記の4つの落とし穴のそれぞれが、静かな週を待ち構えている本番障害であり、メンテナンスは決して終わりません。この理屈をきちんと整理したものが欲しければ、私たちのAIカスタマーサービスのコストの解説が構築対購入の計算を行い、AIエージェント対ルールベースのチャットボットがゼロから行うことになる設計上の判断を扱っています。すぐにショートリストに進みたいなら、最良のAIエージェントのまとめから始めてください。

HubSpot Service Hub向けeesel AI

Service Hubで本当に送信ボタンを押せるAIが欲しいですか？eeselは、コネクタではなく本物のエージェントとしてあなたのHubSpotヘルプデスクに接続します。チケットを読み、返信を下書きして送信し、チケットのプロパティを更新し、パイプラインを動かし、そのすべてをライブのCRM連絡先データを使いながら行います。10プロパティの上限もなく、クレジットの崖もなく、朝の2時に間違えかねないtype: "MESSAGE"フィールドもありません。私たちのHubSpotにAIを追加するガイドに手順があります。

これまでのすべてを踏まえて最も重要な違いは、リハーサルです。eeselが実際の顧客に一件でも返信する前に、あなた自身のクローズ済みチケットに対してそれを実行し、実際に何を答えていたか、どのチケットを処理していたか、どれには手をつけなかったかを正確に確認できます。それこそがHubSpotのカバレッジのパーセンテージダイヤルでは得られないものであり、だからこそチームは期待値ではなく本物のTier 1デフレクションの数字にたどり着けます。GridwiseのKim Simpson氏は公開レビューでこれを率直に述べています。最初の月で、eeselはTier 1リクエストの73%を解決しており、その結果は7日間のトライアルの間に確認できました。

課金は対応したチケットまたはチャット1件につき40セントで、シート料金もプラットフォームの最低料金もなく、望むなら厳格な支出上限を設定できます。上記の計算機での月1,200チケットの場合、これは480ドルになり、それに対してHubSpotの請求は2日目にはすでに3,000クレジットを使い果たしています。まず50ドル分の無料利用枠があり、クレジットカードも不要なので、何かを決める前に自分自身のチケットを通してみることができます。eeselを試す、そして自分自身の1週間分のチケットをそこに通してみてください。