HubSpot MCPサーバーによるCRM操作の自動化｜コンタクト・取引・会社をAIから直接管理する方法

「CRMにデータを入力する時間が、本来の営業活動を圧迫している」——これは多くの営業組織が抱える構造的な課題です。HubSpot CRMは強力なプラットフォームですが、日々のデータ入力・更新・レポート作成といったオペレーション業務が積み重なると、CRMの価値を十分に引き出せないまま運用コストだけが膨らんでいきます。

この課題を根本から解決するのが、HubSpot MCPサーバー（Model Context Protocol）を活用したCRM操作の自動化です。CRM特化型コンサルタントとして数多くの導入現場を見てきた中で、MCPによるCRM操作の自動化は、データ入力の負荷を劇的に下げるだけでなく、CRMの活用度そのものを引き上げる転換点になると確信しています。MCPを使えば、AIエージェントがHubSpot CRMのコンタクト・取引・会社情報を自然言語で検索・作成・更新できるようになります。APIの仕様を覚える必要も、個別のインテグレーションを構築する必要もありません。

本記事では、HubSpot MCPサーバーの仕組みから具体的なセットアップ手順、パイプライン管理やデータクレンジングの自動化設計まで、実務で使えるレベルで解説します。

この記事でわかること

• HubSpot MCPサーバーの仕組みと、従来のAPI連携との決定的な違い
• コンタクト・取引・会社の検索・作成・更新をAIから実行する具体的な手順
• パイプライン管理・レポート生成・データクレンジングの自動化設計パターン
• MCPサーバー導入時のセキュリティ設計と運用上の制限事項

\

HubSpot MCPサーバーとは何か——CRM操作の新しいインターフェース

Model Context Protocol（MCP）の基本概念

Model Context Protocol（MCP）は、Anthropic社が2024年に公開したオープンスタンダードです。LLM（大規模言語モデル）が外部システムのデータやツールに、標準化された方法で安全にアクセスするための通信プロトコルとして設計されています。

MCPがよく「AIのUSB-C」と表現されるのには明確な理由があります。USB-Cが登場する前、デバイスごとに異なる充電ケーブルが必要でした。同様に、MCPが登場する前は、AIと外部システムを接続するたびに個別のAPI連携コードを書く必要がありました。MCPはこの問題を解決し、1つの標準プロトコルであらゆるシステムとAIを接続可能にします。実際に、Replit社はMCPサーバーを活用してAI開発環境とCRMやプロジェクト管理ツールをシームレスに接続する仕組みを構築しており、開発者がコードを書きながらCRMデータにアクセスできる体験を実現しています。

HubSpot MCPサーバーの2つの種類

HubSpotは公式に2種類のMCPサーバーを提供しています。ここが結構ミソになってくるのですが、用途によって使い分ける必要があります。

リモートMCPサーバーは2025年9月にパブリックベータとして公開され、2026年1月にはセルフサービスでのMCP Auth Apps作成・管理UIも追加されました。本記事では、CRM操作の自動化に直結するリモートMCPサーバーを中心に解説します。

従来のAPI連携との根本的な違い

従来のHubSpot API連携とMCPサーバーの違いは、「誰がAPIの仕様を理解する必要があるか」にあります。

これは単なる「便利になった」というレベルの話ではありません。API連携の設計・開発・保守にかかっていたエンジニアリソースを、より価値の高いプロダクト開発やビジネスロジックの構築に振り向けられるようになるという、組織のリソース配分に関わる構造的な変化です。

HubSpot MCPサーバーのセットアップ手順

前提条件の確認

MCPサーバーを利用するためには、以下の条件を満たす必要があります。

• HubSpotアカウント（無料プラン以上）
• MCP対応のAIクライアント（Claude Desktop、Claude Code、Cursor、Windsurf など）
• HubSpotのプライベートアプリトークン（APIキー）
• Node.js実行環境（npmパッケージ利用の場合）

ステップ1：HubSpotプライベートアプリの作成

まず、HubSpotの管理画面からプライベートアプリを作成し、アクセストークンを取得します。

1. HubSpotにログインし、「設定」→「アカウント設定」→「連携」→「プライベートアプリ」に進みます
2. 「プライベートアプリを作成」をクリックします
3. アプリ名（例：MCP CRM Automation）と説明を入力します
4. 「スコープ」タブで、必要なCRMオブジェクトへのアクセス権限を設定します

ポイントになってくるのは、スコープの設定です。最小権限の原則に従い、実際に自動化するオペレーションに必要なスコープのみを付与します。

# 推奨する最小スコープ設定
crm.objects.contacts.read    # コンタクトの読み取り
crm.objects.contacts.write   # コンタクトの作成・更新
crm.objects.companies.read   # 会社の読み取り
crm.objects.companies.write  # 会社の作成・更新
crm.objects.deals.read       # 取引の読み取り
crm.objects.deals.write      # 取引の作成・更新
crm.schemas.contacts.read    # コンタクトプロパティの読み取り
crm.schemas.companies.read   # 会社プロパティの読み取り
crm.schemas.deals.read       # 取引プロパティの読み取り

ステップ2：MCPサーバーのインストールと設定

HubSpot公式のnpmパッケージを使用する方法が最もシンプルです。

# HubSpot公式MCPサーバーパッケージのインストール
npm install -g @hubspot/mcp-server

Claude Desktopを使用する場合は、設定ファイル（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@hubspot/mcp-server"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-private-app-token-here"
      }
    }
  }
}

Claude Codeを使用する場合は、プロジェクトの .mcp.json に設定を追加します。MCPとClaude Codeの連携については、「Claude Codeの使い方｜インストールから実践的な開発ワークフローまで完全ガイド」で詳しく解説しています。

ステップ3：接続テスト

設定が完了したら、AIクライアントから簡単なクエリを実行して接続を確認します。

「HubSpotのコンタクトを5件表示してください」

正常に接続されていれば、AIがMCPサーバー経由でHubSpotのコンタクト情報を取得し、一覧で表示します。エラーが発生する場合は、トークンのスコープ設定とネットワーク接続を確認してください。

コンタクト・取引・会社の検索・作成・更新をAIから実行する

MCPサーバーが提供するツール一覧

HubSpot MCPサーバーは、CRMの主要オブジェクトに対応した複数のツールを提供しています。各ツールはHubSpot APIのエンドポイントに対応していますが、AIが自然言語の指示から適切なツールを自動選択するため、ユーザーがツール名を意識する必要はありません。

コンタクトの検索と更新

自然言語でのクエリ例と、MCPサーバーが内部で実行する操作を見ていきます。

ユースケース1：特定条件のコンタクト検索

プロンプト例：
「過去30日以内に作成された、東京都のコンタクトで、
 ライフサイクルステージがMQLのものを一覧表示してください」

MCPサーバーは、この自然言語の指示を解釈し、HubSpotのSearch APIを使って該当するコンタクトをフィルタリングします。従来であれば、フィルター条件のJSON構造を手動で組み立てる必要がありましたが、MCPではこの複雑さがすべて自然言語の裏に隠蔽されます。

ユースケース2：コンタクト情報の一括更新

プロンプト例：
「会社名が"株式会社〇〇"のコンタクトのうち、
 業種プロパティが空のものに"IT・通信"を設定してください」

このような条件付き更新も、MCPサーバー経由であればワンステップで実行できます。

取引（Deal）の管理と自動化

取引オブジェクトの操作は、営業プロセスの自動化において最も効果が大きい領域です。

ユースケース3：パイプラインの状況把握

プロンプト例：
「現在の営業パイプラインの状況をサマリーしてください。
 ステージ別の取引数と合計金額、
 平均滞留日数を含めてレポートにしてください」

AIはMCPサーバー経由で全取引データを取得し、ステージ別に集計・分析した結果を即座に返します。従来であればHubSpotのレポートツールで事前にレポートを設計・保存する必要がありましたが、MCPではその場で自由なフォーマットのレポートを生成できます。

ユースケース4：取引のステージ更新

プロンプト例：
「担当者が田中太郎で、最終活動日が60日以上前の取引を
 すべて"停滞"ステージに移動してください」

会社（Company）のデータ操作

プロンプト例：
「従業員数が100名以上で、業種が"製造業"の会社の中から、
 関連するコンタクトが3名以上登録されている会社を
 リストアップしてください」

MCPサーバーの強みは、このようなオブジェクト間の関連（アソシエーション）を横断したクエリも自然言語で実行できる点にあります。

パイプライン管理の自動化設計

パイプライン管理の自動化は、MCPサーバーの活用効果が最も実感しやすい領域の一つです。

週次パイプラインレビューの自動化

従来の週次パイプラインレビューでは、営業マネージャーがHubSpotのダッシュボードを確認し、スプレッドシートに転記し、コメントを追加するという手順を踏んでいました。MCPサーバーを使えば、このプロセスを以下のように自動化できます。

プロンプト例：
「今週のパイプラインレビューレポートを作成してください。
 以下の項目を含めてください：
 1. ステージ別の取引数と合計金額（先週比）
 2. 今月クローズ予定の取引一覧（確度別）
 3. 30日以上ステージが変わっていない停滞取引
 4. 今週新規に作成された取引の一覧
 5. 担当者別の取引金額サマリー」

商談アラートの設計

MCPサーバーは、定期的にCRMデータをチェックして異常値を検出するアラートシステムとしても活用できます。

具体的なアラート設計パターンとしては、以下のようなものがあります。

• 停滞アラート: 特定のステージに一定期間以上滞留している取引を検出
• 金額異常アラート: 取引金額が通常の範囲を大きく逸脱するケースを検出
• クローズ予定超過アラート: クローズ予定日を過ぎた取引を一覧化
• 担当者負荷アラート: 特定の担当者に取引が集中しすぎている状況を検出

これらのアラートをClaude Codeのスケジュール実行やCronジョブと組み合わせることで、能動的にCRMの状態を監視し、問題を早期に発見できる体制を構築できます。

レポート生成とデータクレンジングの自動化

AIによるレポート自動生成

MCPサーバーを使ったレポート生成の最大のメリットは、「レポートの事前設計が不要」という点です。HubSpotの標準レポート機能では、表示したい指標やフィルター条件を事前に設定しておく必要がありますが、MCPサーバー経由であれば、その場の質問に合わせたアドホックなレポートを即座に生成できます。

レポート自動生成の実践例：

プロンプト例：
「今月の営業活動レポートを以下の観点で作成してください：
 - チャネル別のリード獲得数（Webフォーム/展示会/紹介）
 - MQL→SQL転換率の推移（過去3ヶ月比較）
 - 平均商談期間（初回接触からクローズまで）
 - 失注理由のTop5と件数」

データクレンジングの自動化設計

CRMデータの品質劣化は、あらゆる組織が直面する課題です。MCPサーバーを活用すれば、データクレンジングのルーティンを大幅に効率化できます。

クレンジング対象と自動化パターン：

プロンプト例：
「HubSpotのコンタクトデータのクレンジングレポートを作成してください。
 以下の観点でチェックしてください：
 1. メールアドレスが重複しているコンタクトのペア一覧
 2. 会社名が空欄のコンタクト数
 3. 電話番号のフォーマットが統一されていないケース
 4. ライフサイクルステージが設定されていないコンタクト数
 修正が必要なものはリストアップしてください」

MCPサーバーの詳しい構築手法については、「HubSpot MCP Serverの活用ガイド｜AIエージェントからCRMデータを操作する方法」も併せて参照してください。

セキュリティ設計と権限管理のベストプラクティス

MCPサーバー経由でCRM操作を自動化する場合、セキュリティ設計は最も慎重に検討すべき領域です。

認証と権限の設計原則

HubSpotのリモートMCPサーバーは、OAuth 2.1ベースの認証を採用しています。PKCE（Proof Key for Code Exchange：認可コードの傍受を防ぐセキュリティ拡張）やリフレッシュトークンのローテーションにも対応しており、企業レベルのセキュリティ要件を満たす設計になっています。

権限設計のベストプラクティスとしては、以下の3原則を守ることが重要です。

1. 最小権限の原則: 自動化に必要なスコープのみを付与し、不要な書き込み権限は外す
2. 環境分離: 本番環境とテスト環境でトークンを分離し、テスト時に本番データを変更するリスクを排除する
3. 監査ログ: MCPサーバー経由の操作履歴を記録し、「いつ・誰が・何を変更したか」を追跡可能にする

チーム利用時のガバナンス

複数のメンバーがMCPサーバーを利用する場合、以下のルールを事前に定めておくことを推奨します。

• 読み取り専用ユーザーと書き込み可能ユーザーを明確に区分する
• 一括更新操作（100件以上の同時変更）は承認フローを経由させる
• 削除操作はMCPサーバー経由では実行不可にする（HubSpot管理画面からのみ実行）
• プライベートアプリトークンは環境変数で管理し、ソースコードにハードコーディングしない

正直な制限事項——MCPサーバーが万能ではない理由

MCPサーバーは強力なツールですが、現時点での制限事項を正確に把握しておくことが重要です。

公式リモートMCPサーバーの制限

読み取り専用の範囲: HubSpot公式のリモートMCPサーバー（パブリックベータ版）は、執筆時点では主に読み取り操作に対応しています。コンタクト・会社・取引・チケット・商品・見積書・請求書・サブスクリプションなどのCRMオブジェクトとそのプロパティデータを取得できますが、書き込み操作のサポートは段階的に拡大されている状況です。

書き込み操作を実行する場合: コミュニティ製のMCPサーバー（例：peakmojo/mcp-hubspotなど）は、コンタクト・取引・会社の作成・更新を含む書き込み操作にも対応しています。ただし、コミュニティ製を利用する場合は、セキュリティリスクの評価とコードレビューを事前に行うことを強く推奨します。

その他の制限事項

• API呼び出し上限: MCPサーバーの操作は内部的にHubSpot APIを呼び出しているため、HubSpotプランごとのAPI呼び出し上限が適用されます。大量のデータ操作を行う場合は、上限に注意が必要です
• カスタムオブジェクト: 標準オブジェクト以外のカスタムオブジェクトへの対応は、MCPサーバーの実装によって異なります
• ワークフローのトリガー: MCPサーバー経由でデータを更新した場合、HubSpotのワークフローが意図通りにトリガーされるかどうかは、ワークフローのトリガー条件次第です。事前にテスト環境で検証してください
• リアルタイム性: MCPサーバーにはキャッシュ機構を持つものもあり、常に最新データが返されるとは限りません。リアルタイム性が求められる操作では、キャッシュの有無と有効期限を確認する必要があります

MCPの技術的な全体像やセキュリティ設計の詳細については、「MCPサーバーの構築ガイド｜自社データをAIに接続するための設計と実装手順」で詳しく解説しています。

導入ロードマップ——段階的に自動化を進める

MCPサーバーによるCRM自動化は、一度にすべてを実装するのではなく、段階的に導入することを推奨します。

Phase 1：読み取り・レポート自動化（1〜2週間）

• MCPサーバーのセットアップと接続テスト
• 日次・週次レポートの自動生成
• アドホックなデータ検索・集計クエリの実行

Phase 2：データクレンジング・更新（3〜4週間）

• 重複コンタクトの検出と統合候補リスト化
• 表記ゆれの検出と修正ルールの策定
• 不完全データの補完プロセスの構築

Phase 3：パイプライン管理・アラート（5〜8週間）

• 停滞取引の自動検出とアラート設計
• パイプラインレビューの定期自動レポート化
• 商談のスコアリングとAI分析の導入

Phase 4：フル自動化・他システム連携（2〜3ヶ月）

• 複数のMCPサーバーを組み合わせたマルチシステム連携（例：HubSpot + freee + Slack）
• 営業プロセス全体のAIアシスタント化
• 経営ダッシュボードのリアルタイム自動更新

実務的にここが重要なのですが、Phase 1の「読み取り・レポート自動化」だけでも十分な業務効率化効果を実感できるため、まずはここから着手し、チーム内での成功体験を積み上げてから次のフェーズに進むのが理想的です。

まとめ

• HubSpot MCPサーバーは、AIエージェントがCRMデータを自然言語で操作するための標準プロトコルであり、従来のAPI連携と比較して学習コスト・保守コストを大幅に削減できます
• コンタクト・取引・会社の検索・作成・更新を自然言語で実行でき、パイプラインのサマリーやアドホックレポートもその場で生成可能です
• データクレンジングの自動化により、CRMデータの品質を継続的に維持する仕組みを構築できます
• セキュリティ設計では「最小権限の原則」「環境分離」「監査ログ」の3原則を守り、特に一括更新や削除操作には承認フローを設けることが重要です
• 公式リモートMCPサーバーはパブリックベータ段階であり、読み取り操作が中心のため、書き込み操作にはコミュニティ製サーバーの活用やHubSpot APIの直接利用を組み合わせる柔軟な設計が現実的です

最初の一歩として: HubSpotのプライベートアプリを作成し、@hubspot/mcp-serverをインストールして、まずは「今月のパイプラインの状況をサマリーしてください」という1つのクエリを実行してみてください。CRMデータをAIが瞬時に集計・分析してくれる体験が、自動化設計のアイデアを次々と湧き出させてくれるはずです。

HubSpot CRMの基本的な機能や設定方法については、「HubSpot CRM完全ガイド」も併せてご確認ください。

よくある質問（FAQ）

Q1. HubSpot MCPサーバーを利用するのに追加費用はかかりますか？

HubSpot MCPサーバー自体は無料で利用できます。HubSpotの無料プラン以上のアカウントがあれば、プライベートアプリを作成してMCPサーバーに接続可能です。ただし、AIクライアント側（Claude Pro / Claude Teamなど）のサブスクリプション費用は別途必要です。また、HubSpotプランごとのAPI呼び出し上限が適用されるため、大量のデータ操作を行う場合はプランのアップグレードが必要になる場合があります。

Q2. MCPサーバー経由の操作で、HubSpotのワークフローは正常にトリガーされますか？

MCPサーバー経由（内部的にはHubSpot API経由）でCRMデータを更新した場合、プロパティの変更をトリガー条件としているワークフローは通常通り発動します。ただし、「HubSpot UIからの手動操作」をトリガー条件としているワークフローは発動しません。導入前にテスト環境で、自動化対象の操作がワークフローのトリガー条件と整合しているかを必ず確認してください。

Q3. 複数のチームメンバーが同時にMCPサーバーを利用できますか？

はい、チームメンバーそれぞれが個別のプライベートアプリトークンを使用することで、同時に利用できます。各メンバーのトークンに異なるスコープを設定すれば、「マネージャーは読み書き可能、メンバーは読み取りのみ」といった権限の差別化も実現できます。トークン管理の観点から、1つのトークンを複数人で共有することは推奨しません。

Q4. 既存のHubSpot APIインテグレーションとMCPサーバーは併用できますか？

問題なく併用できます。MCPサーバーは既存のAPIインテグレーションに影響を与えません。段階的に移行する場合は、まず読み取り系の操作をMCPサーバーに移行し、書き込み系の操作は既存のAPI連携を維持するというハイブリッド構成が現実的です。

Q5. MCPサーバーのセットアップにはプログラミングの知識が必要ですか？

基本的なセットアップ（npmインストール＋設定ファイルの記述）には、最低限のコマンドライン操作の知識があれば対応可能です。JSON形式の設定ファイルを正しく編集する必要がありますが、プログラミング経験がなくても、本記事のステップ通りに進めれば10分程度でセットアップを完了できます。より高度なカスタマイズ（独自のMCPサーバーの構築やツール定義の追加）には、Node.jsやTypeScriptの知識が必要になります。