最初の一歩として: HubSpotのプライベートアプリを作成し、@hubspot/mcp-serverをインストールして、まずは「今月のパイプラインの状況をサマリーしてください」という1つのクエリを実
最初の一歩として: HubSpotのプライベートアプリを作成し、@hubspot/mcp-serverをインストールして、まずは「今月のパイプラインの状況をサマリーしてください」という1つのクエリを実
ブログ目次
HubSpot導入、AI活用、CRM整備、業務効率化までをまとめて支援しています。記事で気になったテーマを、そのまま相談ベースで整理できます。
「CRMにデータを入力する時間が、本来の営業活動を圧迫している」——これは多くの営業組織が抱える構造的な課題です。HubSpot CRMは強力なプラットフォームですが、日々のデータ入力・更新・レポート作成といったオペレーション業務が積み重なると、CRMの価値を十分に引き出せないまま運用コストだけが膨らんでいきます。
この課題を根本から解決するのが、HubSpot MCPサーバー(Model Context Protocol)を活用したCRM操作の自動化です。CRM特化型コンサルタントとして数多くの導入現場を見てきた中で、MCPによるCRM操作の自動化は、データ入力の負荷を劇的に下げるだけでなく、CRMの活用度そのものを引き上げる転換点になると確信しています。MCPを使えば、AIエージェントがHubSpot CRMのコンタクト・取引・会社情報を自然言語で検索・作成・更新できるようになります。APIの仕様を覚える必要も、個別のインテグレーションを構築する必要もありません。
本記事では、HubSpot MCPサーバーの仕組みから具体的なセットアップ手順、パイプライン管理やデータクレンジングの自動化設計まで、実務で使えるレベルで解説します。
HubSpot CRMの操作をAIエージェントで自動化し、営業・マーケティングの生産性を向上させたい担当者に向けた記事です。
\
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年にChatGPT(6月)、Claude(7月)、Gemini(9月)と段階的にコネクタがリリースされ、CRM業界で初めて主要3大LLMすべてに対応した公式MCPコネクタとなりました。2026年1月にはセルフサービスでのMCP Auth Apps作成・管理UIも追加されています。INBOUND 2025の時点で、20,000以上の顧客が2,300万件のCRMレコードをAIエージェント経由で活用しており、MCPによるCRM操作は急速に実用段階へと進んでいます。
2026年現在では、Claude Desktop・ChatGPT・Cursorに加え、Visual Studio Code、Windsurf、Microsoft Copilotなど、MCPプロトコルに対応するすべてのクライアントから接続可能です。本記事では、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の使い方|インストールから実践的な開発ワークフローまで完全ガイド」で詳しく解説しています。
Cursorを使用する場合は、プロジェクト設定のMCPセクションからHubSpot MCPサーバーを追加します。開発ワークフローの中でCRMデータを参照しながらコーディングできるため、HubSpotのカスタム統合を開発するエンジニアにとって特に有用です。
設定が完了したら、AIクライアントから簡単なクエリを実行して接続を確認します。
「HubSpotのコンタクトを5件表示してください」
正常に接続されていれば、AIがMCPサーバー経由でHubSpotのコンタクト情報を取得し、一覧で表示します。エラーが発生する場合は、トークンのスコープ設定とネットワーク接続を確認してください。
HubSpot MCPサーバーは、ローンチ時点で9つのツールを提供し、マーケティング・営業・カスタマーサービスチームが日常的に操作するCRMオブジェクトをカバーしています。各ツールはHubSpot APIのエンドポイントに対応していますが、AIが自然言語の指示から適切なツールを自動選択するため、ユーザーがツール名を意識する必要はありません。
| ツール名 | 対応オブジェクト | 操作内容 |
|---|---|---|
| search_contacts | コンタクト | 条件指定によるコンタクト検索 |
| get_contact | コンタクト | 個別コンタクトの詳細取得 |
| search_companies | 会社 | 会社情報の条件検索 |
| get_company | 会社 | 個別会社の詳細取得 |
| search_deals | 取引 | パイプラインの取引検索 |
| get_deal | 取引 | 個別取引の詳細取得 |
| search_tickets | チケット | サポートチケットの検索 |
| get_ticket | チケット | 個別チケットの詳細取得 |
| get_crm_schema | 全オブジェクト | カスタムプロパティ定義の取得 |
このほか、商品(Products)、見積書(Quotes)、請求書(Invoices)、サブスクリプション(Subscriptions)などのオブジェクトも読み取り操作に対応しています。
自然言語でのクエリ例と、MCPサーバーが内部で実行する操作を見ていきます。
ユースケース1:特定条件のコンタクト検索
プロンプト例:
「過去30日以内に作成された、東京都のコンタクトで、
ライフサイクルステージがMQLのものを一覧表示してください」
MCPサーバーは、この自然言語の指示を解釈し、HubSpotのSearch APIを使って該当するコンタクトをフィルタリングします。従来であれば、フィルター条件のJSON構造を手動で組み立てる必要がありましたが、MCPではこの複雑さがすべて自然言語の裏に隠蔽されます。
ユースケース2:コンタクト情報の一括更新
プロンプト例:
「会社名が"株式会社〇〇"のコンタクトのうち、
業種プロパティが空のものに"IT・通信"を設定してください」
このような条件付き更新も、MCPサーバー経由であればワンステップで実行できます。
取引オブジェクトの操作は、営業プロセスの自動化において最も効果が大きい領域です。
ユースケース3:パイプラインの状況把握
プロンプト例:
「現在の営業パイプラインの状況をサマリーしてください。
ステージ別の取引数と合計金額、
平均滞留日数を含めてレポートにしてください」
AIはMCPサーバー経由で全取引データを取得し、ステージ別に集計・分析した結果を即座に返します。従来であればHubSpotのレポートツールで事前にレポートを設計・保存する必要がありましたが、MCPではその場で自由なフォーマットのレポートを生成できます。
ユースケース4:取引のステージ更新
プロンプト例:
「担当者が田中太郎で、最終活動日が60日以上前の取引を
すべて"停滞"ステージに移動してください」
プロンプト例:
「従業員数が100名以上で、業種が"製造業"の会社の中から、
関連するコンタクトが3名以上登録されている会社を
リストアップしてください」
MCPサーバーの強みは、このようなオブジェクト間の関連(アソシエーション)を横断したクエリも自然言語で実行できる点にあります。
営業担当者が商談前に最も時間をかけるのが、顧客情報の収集と整理です。MCPサーバーを活用すれば、このプロセスを大幅に短縮できます。
プロンプト例:
「株式会社〇〇との来週の商談に向けて、
この会社の基本情報、関連するコンタクト一覧、
過去の取引履歴、オープン中のチケットをまとめてください」
AIエージェントが会社情報、関連コンタクト、取引履歴、サポートチケットを横断的に取得し、商談に必要な情報を一画面で整理して提示します。従来はCRMの複数画面を行き来しながら情報を集めていた作業が、1つのプロンプトで完了します。
MCPサーバーはマーケティング業務においても、リードの分析やキャンペーン効果の検証で大きな効果を発揮します。
リードスコアリングの分析
プロンプト例:
「スコアが80以上のリードのうち、直近30日で
Webサイトに3回以上訪問したコンタクトを抽出してください」
マーケティング担当者がSQLやAPIの知識なしに、複合条件でのリード分析を実行できます。
キャンペーン効果の検証
プロンプト例:
「先月の展示会キャンペーンに紐づくコンタクトのうち、
取引が作成されたものの転換率を算出してください」
特定のキャンペーンに紐づくコンタクトの取引転換率を、AIエージェントが複数のCRMオブジェクトを横断して集計します。HubSpotのデフォルトレポートでは表現しにくいクロスオブジェクト分析も、自然言語で指示するだけで実現可能です。
パイプライン管理の自動化は、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. ライフサイクルステージが設定されていないコンタクト数
修正が必要なものはリストアップしてください」
Claude Codeによる経営データの可視化やコンテンツマーケティングの支援でも、こうした手法が活用されています。
MCPサーバー経由でCRM操作を自動化する場合、セキュリティ設計は最も慎重に検討すべき領域です。
HubSpotのリモートMCPサーバーは、OAuth 2.1ベースの認証を採用しています。PKCE(Proof Key for Code Exchange:認可コードの傍受を防ぐセキュリティ拡張)やリフレッシュトークンのローテーションにも対応しており、企業レベルのセキュリティ要件を満たす設計になっています。
権限設計のベストプラクティスとしては、以下の3原則を守ることが重要です。
MCPサーバー経由のアクセスは、接続したHubSpotユーザーの権限に従います。チーム限定のデータやプライベートなカスタムオブジェクトは、そのユーザーがHubSpot上でアクセス権を持っている場合のみ取得可能です。また、HubSpotのアクティビティログにはMCP経由のAPI呼び出しも記録されるため、誰がどのデータにアクセスしたかを事後的に確認でき、コンプライアンス要件への対応も可能です。
複数のメンバーがMCPサーバーを利用する場合、以下のルールを事前に定めておくことを推奨します。
MCPサーバーは強力なツールですが、現時点での制限事項を正確に把握しておくことが重要です。
読み取り専用の範囲: HubSpot公式のリモートMCPサーバー(パブリックベータ版)は、執筆時点では主に読み取り操作に対応しています。コンタクト・会社・取引・チケット・商品・見積書・請求書・サブスクリプションなどのCRMオブジェクトとそのプロパティデータを取得できますが、書き込み操作のサポートは段階的に拡大されている状況です。
書き込み操作を実行する場合: コミュニティ製のMCPサーバー(例:peakmojo/mcp-hubspotなど)は、コンタクト・取引・会社の作成・更新を含む書き込み操作にも対応しています。ただし、コミュニティ製を利用する場合は、セキュリティリスクの評価とコードレビューを事前に行うことを強く推奨します。
公式MCPサーバーでカバーできないカスタムオブジェクト、ワークフローのトリガー、バルクデータ操作が必要な場合は、HubSpot APIを活用したカスタムMCPサーバーの構築が選択肢になります。
GitHub上にはPeakMojo社が公開するHubSpot MCPサーバーをはじめ、コミュニティ製のMCPサーバーが複数存在します。ベクトルストレージやキャッシュ機構を内蔵し、HubSpot APIの制限を克服するものもあります。ただし、サードパーティサーバーの利用時はセキュリティ監査を実施し、トークンの取り扱いを確認してください。
Stack Overflow社は、自社のCRM環境にMCPを導入した事例を公開しています。公式MCPサーバーの機能をベースにしつつ、自社独自のカスタムオブジェクトやビジネスロジックをカスタムツールとして追加し、営業チームの日常業務を自動化しました。このように、公式とカスタムを組み合わせるハイブリッド構成が、実務では最も現実的なアプローチです。
MCPの技術的な全体像やセキュリティ設計の詳細については、「MCPサーバーの構築ガイド|自社データをAIに接続するための設計と実装手順」で詳しく解説しています。AIエージェントの開発手法については「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の知識が必要になります。
MCPサーバーの利用にはAPIアクセス権が必要です。Freeプランでも基本的なAPI操作は可能ですが、カスタムオブジェクトやマーケティングイベントの取得など、上位プランでのみ利用可能なデータはMCP経由でもアクセスできません。利用するCRMオブジェクトとプロパティが、ご契約のプランで対応しているかを事前に確認してください。
MCPの仕様上、1つのクライアントから複数のMCPサーバーに同時接続できるため、ポータルごとにMCPサーバーを設定すれば、1つのAIエージェントから複数ポータルのデータにアクセス可能です。ただし、ポータル間のデータ混在を防ぐため、プロンプトで対象ポータルを明示するルールの設定が推奨されます。
HubSpotのAPI呼び出し上限に達すると、MCPサーバー経由のリクエストもエラーを返します。AIエージェントには「APIレート制限に達しました」というエラーメッセージが返され、ユーザーにその旨を通知します。頻繁にレート制限に達する場合は、キャッシュ機構の導入やリクエストの最適化を検討してください。
株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化(ERP/CRM/SFA/MAの導入)」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、無料のお問い合わせページより、お気軽にご連絡くださいませ。
株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。
HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。