HubSpotとClaude Codeの連携

はじめに：Claude CodeとHubSpotが変えるCRM運用

Anthropicが提供するCLIツール「Claude Code」は、ターミナル上で動作するAIアシスタントです。コードの読み書きやファイル操作だけでなく、MCP（Model Context Protocol）を通じて外部サービスと連携し、CRMのデータ操作までをAIに任せることができます。

HubSpotはCRMとして初めてClaude向けの公式コネクターを提供したプラットフォームであり、MCPサーバーも公式に公開されています。これにより、Claude Codeから直接HubSpotのデータを読み取り・書き込み・分析・可視化することが可能になりました。

本記事では、この連携の具体的な活用方法を3つのテーマに分けて解説します。

セットアップ：Claude CodeとHubSpotを接続する

Claude CodeとHubSpotを連携するには、HubSpotが公式に提供するリモートMCPサーバーを使用します。

接続手順

1. Claude Codeをインストール：npm install -g @anthropic-ai/claude-codeで導入
2. MCPサーバーを追加：以下のコマンドを実行
   claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic
3. OAuth認証：Claude Code内で/mcpコマンドを実行し、HubSpotのOAuth認証フローを完了

これだけでセットアップは完了です。認証が完了すると、Claude CodeはHubSpotのMCPツール群を通じてHubSpotにアクセスできるようになります（正式公開後は16種類に拡張。以下は中心となる7つ）。

利用可能なMCPツール一覧

• get_user_details：ユーザー情報と権限の確認
• search_crm_objects：CRMレコードの検索・フィルタリング
• get_crm_objects：IDを指定してレコードを一括取得
• search_properties：プロパティ定義のキーワード検索
• get_properties：プロパティの詳細定義の取得
• manage_crm_objects：レコードの作成・更新・関連付け
• search_owners：オーナー（担当者）の検索

活用1：Claude CodeからHubSpotにデータを書き込む

従来、HubSpotへのデータ入力はUIからの手動操作やAPI開発が必要でした。Claude Codeを使えば、自然言語で指示するだけでCRMレコードの作成・更新が可能です。

コンタクトの作成

例えば、以下のように指示するだけで新しいコンタクトが作成されます：

「田中太郎さん（tanaka@example.co.jp）を新しいコンタクトとして登録して。会社はABC株式会社、電話番号は03-1234-5678」

Claude Codeは内部でmanage_crm_objectsツールを呼び出し、以下のような確認テーブルを表示します：

確認プロセス（安全機構）：

• 書き込み前に必ず変更内容がテーブル形式で表示される
• ユーザーが明示的に承認するまで実行されない
• セッション中の確認をスキップするオプションも提供
• 全ての操作はHubSpotの監査ログに記録される

取引（Deal）の更新

「取引ID 12345のステージを『提案中』に変更して、金額を500万円に更新して」

Claude Codeは現在の値と変更後の値を比較表で提示し、承認後に更新を実行します。

関連付け（Association）の作成

「さっき作ったコンタクトを会社ID 67890に関連付けて」

オブジェクト間の関連付けも、作成・更新と同時に行えます。1リクエストで最大10レコードまでの一括操作に対応しています。

実務での活用シーン

• 展示会後のリード一括登録：名刺情報をまとめてClaude Codeに渡し、一括でコンタクト作成
• パイプラインの更新：週次ミーティング後に複数の取引ステージを自然言語でまとめて更新
• データクレンジング：「電話番号のフォーマットを統一して」といった指示でデータ品質を向上

活用2：HubSpotのデータをチャット形式で呼び出す

Claude Codeの最大の強みは、自然言語でCRMデータにアクセスできることです。SQLやAPIの知識は一切不要。普段話すような言葉で質問するだけで、必要なデータが返ってきます。

基本的なデータ検索

以下のような質問がそのまま使えます：

• 「今月クローズ予定の取引を全部見せて」
• 「ABC株式会社に関連するコンタクトを一覧で出して」
• 「先週作成されたチケットで未解決のものは？」
• 「金額1000万円以上の取引を金額順に並べて」

Claude Codeは内部でsearch_crm_objectsを使い、適切なフィルター条件を自動構築します。最大5つのフィルターグループ（OR条件）と、各グループ内6つのフィルター（AND条件）を組み合わせた高度な検索が可能です。

「自分の」データへのアクセス

「自分の取引を見せて」「私が担当しているコンタクトは？」といった一人称の質問にも対応します。Claude Codeは自動的にユーザーのオーナーIDを取得し、hubspot_owner_idでフィルタリングします。

関連オブジェクトの横断検索

HubSpotの強みであるオブジェクト間の関連付けを活かした検索も可能です：

• 「取引が2件以上あるコンタクトを教えて」→ num_associated_dealsでフィルタリング
• 「A社に紐づくすべての取引とチケットを見せて」→ Association filteringを使用
• 「担当者ごとの取引数を集計して」→ search_ownersとsearch_crm_objectsを組み合わせ

プロパティの探索

「どんなプロパティがあるか分からない」という場合も大丈夫です。search_propertiesツールで、キーワードからプロパティ定義を検索できます：

「取引に『緊急度』みたいなプロパティはある？」

Claude Codeが候補となるプロパティ名を提示し、適切なフィルター条件を提案してくれます。

活用3：データをビジュアライズし、BIツールのように使う

Claude Codeの真価は、データの取得だけでなく分析・可視化までを一気通貫で行えることです。従来はBIツール（Tableau、Power BIなど）が必要だった作業を、自然言語の指示だけで完結できます。

パイプライン分析の可視化

「現在のパイプラインをステージ別に集計して、棒グラフで可視化して」

Claude Codeは以下の手順を自動で実行します：

1. search_crm_objectsで全取引データを取得
2. ステージ別に金額・件数を集計
3. Chart.jsやD3.jsを使ったインタラクティブなHTMLファイルを生成
4. ブラウザで開いて確認可能

売上トレンドの時系列分析

「過去12ヶ月の受注金額を月別にグラフ化して、前年比も出して」

Closed-Won取引をclosedate基準で集計し、月別の推移グラフと前年同月比を自動生成します。折れ線グラフ、エリアチャート、比較バーチャートなど、データに適した可視化形式をClaude Codeが判断します。

営業チームのパフォーマンス分析

「営業担当者ごとの受注率と平均取引金額を比較するダッシュボードを作って」

担当者別のKPIを自動集計し、以下のような複合ダッシュボードを生成します：

• 担当者別の受注率（円グラフ）
• 平均取引金額の比較（横棒グラフ）
• 商談ステージ別の滞留期間（ヒートマップ）
• 月次トレンドの重ね合わせ（折れ線グラフ）

BIツールとの違い

Claude Code + HubSpotの組み合わせは、従来のBIツールと比べて以下の点で優れています：

• セットアップ不要：ダッシュボードの設計・構築が不要。質問するだけで可視化が完成
• 柔軟性：「この数値おかしくない？もっと細かく分解して」と追加の深掘りが即座に可能
• アドホック分析：定型レポートではなく、その場の疑問にリアルタイムで回答
• コスト：高額なBIツールのライセンスが不要

一方で、定期的に同じレポートを自動配信するような定型レポーティングには、HubSpot標準のレポート機能やBIツールの方が適しています。Claude Codeは「知りたいことを今すぐ知る」アドホック分析に最適です。

セキュリティと制限事項

業務データを扱う以上、セキュリティは最重要事項です。Claude Code + HubSpot連携では、以下のセキュリティモデルが適用されます。

セキュリティモデル

• ユーザー権限の継承：HubSpotで設定されたユーザー権限がそのまま適用される。閲覧権限のないデータにはアクセスできない
• OAuth 2.0認証：業界標準の認証プロトコルを使用
• 書き込みの承認制：データの作成・更新は必ずユーザーの明示的な承認が必要
• 監査ログ：全ての操作がHubSpotの監査ログに記録され、トレーサビリティを確保
• モデル学習への不使用：AnthropicはHubSpotから共有されたデータをAIモデルのトレーニングに使用しない

主な制限事項（ベータ公開時点。正式公開後は一部緩和）

• 一括操作は1リクエストあたり最大10レコード
• 検索結果は1ページあたり最大200件
• 削除操作は非対応（作成・更新のみ）
• 対応オブジェクトはコンタクト・会社・取引・チケット・明細項目・商品。カスタムオブジェクトは対象外
• センシティブデータ機能をオンにしているアカウントでは、アクティビティ（通話・メール・ミーティング・メモ・タスク）と会話データがMCP経由でのアクセスからブロックされる

まとめ：CRM運用の新しいかたち

Claude CodeとHubSpotの連携は、CRM運用のパラダイムを変えます。

• データ入力：UIを開かずに、自然言語でレコードを作成・更新
• データ検索：SQLやフィルター設定を覚えずに、チャットで即座にデータを取得
• データ分析：BIツールなしで、質問するだけでグラフやダッシュボードを生成

これは「AIがCRMの使い方を変える」具体例です。CRMは「入力するもの」から「話しかけるもの」へ。データは「溜めるもの」から「活用するもの」へ。

まずはClaude CodeにHubSpotのMCPサーバーを接続し、「今月の取引を見せて」から始めてみてください。その一言から、CRM運用の新しい世界が広がります。

UniteXでは、HubSpotの導入・構築支援に加え、AI活用によるCRM運用の最適化もサポートしています。Claude CodeやChatGPTとHubSpotの連携についてのご相談も、お気軽にお問い合わせください。