「CRMにデータを入力する時間が、本来の営業活動を圧迫している」——これは多くの営業組織が抱える構造的な課題です。HubSpot CRMは強力なプラットフォームですが、日々のデータ入力・更新・レポート作成といったオペレーション業務が積み重なると、CRMの価値を十分に引き出せないまま運用コストだけが膨らんでいきます。
この課題を根本から解決するのが、HubSpot MCPサーバー(Model Context Protocol)を活用したCRM操作の自動化です。CRM特化型コンサルタントとして数多くの導入現場を見てきた中で、MCPによるCRM操作の自動化は、データ入力の負荷を劇的に下げるだけでなく、CRMの活用度そのものを引き上げる転換点になると確信しています。MCPを使えば、AIエージェントがHubSpot CRMのコンタクト・取引・会社情報を自然言語で検索・作成・更新できるようになります。APIの仕様を覚える必要も、個別のインテグレーションを構築する必要もありません。
本記事では、HubSpot 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は公式に2種類のMCPサーバーを提供しています。ここが結構ミソになってくるのですが、用途によって使い分ける必要があります。
| 種類 | 接続方式 | 主な用途 | 対象ユーザー |
|---|---|---|---|
| リモートMCPサーバー | OAuth 2.1認証経由のクラウド接続 | CRMデータの検索・取得・操作 | 営業・マーケティング・CS担当者 |
| 開発者向けMCPサーバー | CLI経由のローカル接続 | HubSpotアプリのスキャフォールド・プロジェクト管理 | 開発者・テクニカルチーム |
リモートMCPサーバーは2025年9月にパブリックベータとして公開され、2026年1月にはセルフサービスでのMCP Auth Apps作成・管理UIも追加されました。本記事では、CRM操作の自動化に直結するリモートMCPサーバーを中心に解説します。
従来のHubSpot API連携とMCPサーバーの違いは、「誰がAPIの仕様を理解する必要があるか」にあります。
| 比較項目 | 従来のAPI連携 | MCPサーバー経由 |
|---|---|---|
| APIエンドポイントの知識 | 開発者が全エンドポイントを把握する必要あり | AIが適切なツールを自動選択 |
| リクエスト構造 | JSON構造を手動で組み立て | 自然言語で指示するだけ |
| エラーハンドリング | 開発者がコードで対応 | AIが文脈に応じて再試行・代替処理 |
| 保守コスト | API仕様変更時にコード修正が必要 | MCPサーバー側で吸収 |
| 学習コスト | 数週間〜数ヶ月 | 数時間 |
| 柔軟性 | 事前定義した操作のみ実行可能 | 自然言語で新しいクエリを即座に実行 |
これは単なる「便利になった」というレベルの話ではありません。API連携の設計・開発・保守にかかっていたエンジニアリソースを、より価値の高いプロダクト開発やビジネスロジックの構築に振り向けられるようになるという、組織のリソース配分に関わる構造的な変化です。
MCPサーバーを利用するためには、以下の条件を満たす必要があります。
まず、HubSpotの管理画面からプライベートアプリを作成し、アクセストークンを取得します。
MCP CRM Automation)と説明を入力しますポイントになってくるのは、スコープの設定です。最小権限の原則に従い、実際に自動化するオペレーションに必要なスコープのみを付与します。
# 推奨する最小スコープ設定
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 # 取引プロパティの読み取り
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の使い方|インストールから実践的な開発ワークフローまで完全ガイド」で詳しく解説しています。
設定が完了したら、AIクライアントから簡単なクエリを実行して接続を確認します。
「HubSpotのコンタクトを5件表示してください」
正常に接続されていれば、AIがMCPサーバー経由でHubSpotのコンタクト情報を取得し、一覧で表示します。エラーが発生する場合は、トークンのスコープ設定とネットワーク接続を確認してください。
HubSpot MCPサーバーは、CRMの主要オブジェクトに対応した複数のツールを提供しています。各ツールはHubSpot APIのエンドポイントに対応していますが、AIが自然言語の指示から適切なツールを自動選択するため、ユーザーがツール名を意識する必要はありません。
| ツールカテゴリ | 対応オブジェクト | 主な操作 |
|---|---|---|
| コンタクト管理 | Contacts | 検索・作成・更新・プロパティ取得 |
| 会社管理 | Companies | 検索・作成・更新・関連コンタクト取得 |
| 取引管理 | Deals | 検索・作成・更新・ステージ変更 |
| チケット管理 | Tickets | 検索・作成・更新・ステータス変更 |
| 商品管理 | Products, Line Items | 検索・見積もり連携 |
| その他 | Orders, Invoices, Quotes, Subscriptions, Carts | 読み取り |
自然言語でのクエリ例と、MCPサーバーが内部で実行する操作を見ていきます。
ユースケース1:特定条件のコンタクト検索
プロンプト例:
「過去30日以内に作成された、東京都のコンタクトで、
ライフサイクルステージがMQLのものを一覧表示してください」
MCPサーバーは、この自然言語の指示を解釈し、HubSpotのSearch APIを使って該当するコンタクトをフィルタリングします。従来であれば、フィルター条件のJSON構造を手動で組み立てる必要がありましたが、MCPではこの複雑さがすべて自然言語の裏に隠蔽されます。
ユースケース2:コンタクト情報の一括更新
プロンプト例:
「会社名が"株式会社〇〇"のコンタクトのうち、
業種プロパティが空のものに"IT・通信"を設定してください」
このような条件付き更新も、MCPサーバー経由であればワンステップで実行できます。
取引オブジェクトの操作は、営業プロセスの自動化において最も効果が大きい領域です。
ユースケース3:パイプラインの状況把握
プロンプト例:
「現在の営業パイプラインの状況をサマリーしてください。
ステージ別の取引数と合計金額、
平均滞留日数を含めてレポートにしてください」
AIはMCPサーバー経由で全取引データを取得し、ステージ別に集計・分析した結果を即座に返します。従来であればHubSpotのレポートツールで事前にレポートを設計・保存する必要がありましたが、MCPではその場で自由なフォーマットのレポートを生成できます。
ユースケース4:取引のステージ更新
プロンプト例:
「担当者が田中太郎で、最終活動日が60日以上前の取引を
すべて"停滞"ステージに移動してください」
プロンプト例:
「従業員数が100名以上で、業種が"製造業"の会社の中から、
関連するコンタクトが3名以上登録されている会社を
リストアップしてください」
MCPサーバーの強みは、このようなオブジェクト間の関連(アソシエーション)を横断したクエリも自然言語で実行できる点にあります。
パイプライン管理の自動化は、MCPサーバーの活用効果が最も実感しやすい領域の一つです。
従来の週次パイプラインレビューでは、営業マネージャーがHubSpotのダッシュボードを確認し、スプレッドシートに転記し、コメントを追加するという手順を踏んでいました。MCPサーバーを使えば、このプロセスを以下のように自動化できます。
プロンプト例:
「今週のパイプラインレビューレポートを作成してください。
以下の項目を含めてください:
1. ステージ別の取引数と合計金額(先週比)
2. 今月クローズ予定の取引一覧(確度別)
3. 30日以上ステージが変わっていない停滞取引
4. 今週新規に作成された取引の一覧
5. 担当者別の取引金額サマリー」
MCPサーバーは、定期的にCRMデータをチェックして異常値を検出するアラートシステムとしても活用できます。
具体的なアラート設計パターンとしては、以下のようなものがあります。
これらのアラートをClaude Codeのスケジュール実行やCronジョブと組み合わせることで、能動的にCRMの状態を監視し、問題を早期に発見できる体制を構築できます。
MCPサーバーを使ったレポート生成の最大のメリットは、「レポートの事前設計が不要」という点です。HubSpotの標準レポート機能では、表示したい指標やフィルター条件を事前に設定しておく必要がありますが、MCPサーバー経由であれば、その場の質問に合わせたアドホックなレポートを即座に生成できます。
レポート自動生成の実践例:
プロンプト例:
「今月の営業活動レポートを以下の観点で作成してください:
- チャネル別のリード獲得数(Webフォーム/展示会/紹介)
- MQL→SQL転換率の推移(過去3ヶ月比較)
- 平均商談期間(初回接触からクローズまで)
- 失注理由のTop5と件数」
CRMデータの品質劣化は、あらゆる組織が直面する課題です。MCPサーバーを活用すれば、データクレンジングのルーティンを大幅に効率化できます。
クレンジング対象と自動化パターン:
| クレンジング項目 | 検出方法 | 自動修正アクション |
|---|---|---|
| 重複コンタクト | メールアドレスの完全一致・類似度検出 | マージ候補のリスト化 |
| 不完全データ | 必須プロパティ(会社名・電話番号等)の空欄チェック | 欠損項目のリスト化・補完候補の提示 |
| 表記ゆれ | 会社名の正規化((株)→ 株式会社、全角半角統一) | 統一ルールに基づく自動修正 |
| 古いデータ | 最終活動日が1年以上前のコンタクト | アーカイブ候補のリスト化 |
| 不正なメールアドレス | 形式チェック(@マーク・ドメイン存在確認) | 無効フラグの付与 |
プロンプト例:
「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原則を守ることが重要です。
複数のメンバーがMCPサーバーを利用する場合、以下のルールを事前に定めておくことを推奨します。
MCPサーバーは強力なツールですが、現時点での制限事項を正確に把握しておくことが重要です。
読み取り専用の範囲: HubSpot公式のリモートMCPサーバー(パブリックベータ版)は、執筆時点では主に読み取り操作に対応しています。コンタクト・会社・取引・チケット・商品・見積書・請求書・サブスクリプションなどのCRMオブジェクトとそのプロパティデータを取得できますが、書き込み操作のサポートは段階的に拡大されている状況です。
書き込み操作を実行する場合: コミュニティ製のMCPサーバー(例:peakmojo/mcp-hubspotなど)は、コンタクト・取引・会社の作成・更新を含む書き込み操作にも対応しています。ただし、コミュニティ製を利用する場合は、セキュリティリスクの評価とコードレビューを事前に行うことを強く推奨します。
MCPの技術的な全体像やセキュリティ設計の詳細については、「MCPサーバーの構築ガイド|自社データをAIに接続するための設計と実装手順」で詳しく解説しています。
MCPサーバーによるCRM自動化は、一度にすべてを実装するのではなく、段階的に導入することを推奨します。
実務的にここが重要なのですが、Phase 1の「読み取り・レポート自動化」だけでも十分な業務効率化効果を実感できるため、まずはここから着手し、チーム内での成功体験を積み上げてから次のフェーズに進むのが理想的です。
最初の一歩として: HubSpotのプライベートアプリを作成し、@hubspot/mcp-serverをインストールして、まずは「今月のパイプラインの状況をサマリーしてください」という1つのクエリを実行してみてください。CRMデータをAIが瞬時に集計・分析してくれる体験が、自動化設計のアイデアを次々と湧き出させてくれるはずです。
HubSpot CRMの基本的な機能や設定方法については、「HubSpot CRM完全ガイド」も併せてご確認ください。
HubSpot MCPサーバー自体は無料で利用できます。HubSpotの無料プラン以上のアカウントがあれば、プライベートアプリを作成してMCPサーバーに接続可能です。ただし、AIクライアント側(Claude Pro / Claude Teamなど)のサブスクリプション費用は別途必要です。また、HubSpotプランごとのAPI呼び出し上限が適用されるため、大量のデータ操作を行う場合はプランのアップグレードが必要になる場合があります。
MCPサーバー経由(内部的にはHubSpot API経由)でCRMデータを更新した場合、プロパティの変更をトリガー条件としているワークフローは通常通り発動します。ただし、「HubSpot UIからの手動操作」をトリガー条件としているワークフローは発動しません。導入前にテスト環境で、自動化対象の操作がワークフローのトリガー条件と整合しているかを必ず確認してください。
はい、チームメンバーそれぞれが個別のプライベートアプリトークンを使用することで、同時に利用できます。各メンバーのトークンに異なるスコープを設定すれば、「マネージャーは読み書き可能、メンバーは読み取りのみ」といった権限の差別化も実現できます。トークン管理の観点から、1つのトークンを複数人で共有することは推奨しません。
問題なく併用できます。MCPサーバーは既存のAPIインテグレーションに影響を与えません。段階的に移行する場合は、まず読み取り系の操作をMCPサーバーに移行し、書き込み系の操作は既存のAPI連携を維持するというハイブリッド構成が現実的です。
基本的なセットアップ(npmインストール+設定ファイルの記述)には、最低限のコマンドライン操作の知識があれば対応可能です。JSON形式の設定ファイルを正しく編集する必要がありますが、プログラミング経験がなくても、本記事のステップ通りに進めれば10分程度でセットアップを完了できます。より高度なカスタマイズ(独自のMCPサーバーの構築やツール定義の追加)には、Node.jsやTypeScriptの知識が必要になります。