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

  • 2026年3月14日
  • 最終更新: 2026年4月13日
この記事の結論

最初の一歩として: 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エージェントで自動化し、営業・マーケティングの生産性を向上させたい担当者に向けた記事です。

  • HubSpot MCPサーバーの仕組みと、提供される9つのツールの機能 — MCPサーバーを利用するためには、以下の条件を満たす必要があります。
  • 従来のAPI連携との決定的な違いと、対応クライアント(Claude/ChatGPT/Cursor等) — ModelContextProtocol(MCP)は、Anthropic社が2024年に公開したオープンスタンダードです。
  • コンタクト・取引・会社の検索・作成・更新をAIから実行する具体的な手順 — 自然言語でのクエリ例と、MCPサーバーが内部で実行する操作を見ていきます。
  • 営業の商談準備やマーケティングのリード分析など、チーム別の活用パターン — MCPサーバーを使ったレポート生成の最大のメリットは、「レポートの事前設計が不要」という点です。
  • パイプライン管理・レポート生成・データクレンジングの自動化設計パターン — パイプライン管理の自動化は、MCPサーバーの活用効果が最も実感しやすい領域の一つです。
  • セキュリティ設計・権限管理とカスタムMCPサーバーとの使い分け — MCPサーバー経由でCRM操作を自動化する場合、セキュリティ設計は最も慎重に検討すべき領域です。

\HubSpot MCP CRM自動化


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

02
SECTION 02
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サーバー 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サーバーを中心に解説します。

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

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

比較項目 従来のAPI連携 MCPサーバー経由
APIエンドポイントの知識 開発者が全エンドポイントを把握する必要あり AIが適切なツールを自動選択
リクエスト構造 JSON構造を手動で組み立て 自然言語で指示するだけ
エラーハンドリング 開発者がコードで対応 AIが文脈に応じて再試行・代替処理
保守コスト API仕様変更時にコード修正が必要 MCPサーバー側で吸収
学習コスト 数週間〜数ヶ月 数時間
柔軟性 事前定義した操作のみ実行可能 自然言語で新しいクエリを即座に実行

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



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

03
SECTION 03
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の使い方|インストールから実践的な開発ワークフローまで完全ガイド」で詳しく解説しています。

Cursorを使用する場合は、プロジェクト設定のMCPセクションからHubSpot MCPサーバーを追加します。開発ワークフローの中でCRMデータを参照しながらコーディングできるため、HubSpotのカスタム統合を開発するエンジニアにとって特に有用です。

3
接続テスト

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

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

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



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

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

MCPサーバーが提供する9つのツール

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サーバー経由であればワンステップで実行できます。

取引(Deal)の管理と自動化

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

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

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

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

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

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

会社(Company)のデータ操作

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

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

商談準備のワークフロー

営業担当者が商談前に最も時間をかけるのが、顧客情報の収集と整理です。MCPサーバーを活用すれば、このプロセスを大幅に短縮できます。

プロンプト例:
「株式会社〇〇との来週の商談に向けて、
 この会社の基本情報、関連するコンタクト一覧、
 過去の取引履歴、オープン中のチケットをまとめてください」

AIエージェントが会社情報、関連コンタクト、取引履歴、サポートチケットを横断的に取得し、商談に必要な情報を一画面で整理して提示します。従来はCRMの複数画面を行き来しながら情報を集めていた作業が、1つのプロンプトで完了します。

マーケティングチームの活用パターン

MCPサーバーはマーケティング業務においても、リードの分析やキャンペーン効果の検証で大きな効果を発揮します。

リードスコアリングの分析

プロンプト例:
「スコアが80以上のリードのうち、直近30日で
 Webサイトに3回以上訪問したコンタクトを抽出してください」

マーケティング担当者がSQLやAPIの知識なしに、複合条件でのリード分析を実行できます。

キャンペーン効果の検証

プロンプト例:
「先月の展示会キャンペーンに紐づくコンタクトのうち、
 取引が作成されたものの転換率を算出してください」

特定のキャンペーンに紐づくコンタクトの取引転換率を、AIエージェントが複数のCRMオブジェクトを横断して集計します。HubSpotのデフォルトレポートでは表現しにくいクロスオブジェクト分析も、自然言語で指示するだけで実現可能です。



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

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

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

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

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

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

商談アラートの設計

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

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

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

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



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

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

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

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

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

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

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

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

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

クレンジング項目 検出方法 自動修正アクション
重複コンタクト メールアドレスの完全一致・類似度検出 マージ候補のリスト化
不完全データ 必須プロパティ(会社名・電話番号等)の空欄チェック 欠損項目のリスト化・補完候補の提示
表記ゆれ 会社名の正規化((株)→ 株式会社、全角半角統一) 統一ルールに基づく自動修正
古いデータ 最終活動日が1年以上前のコンタクト アーカイブ候補のリスト化
不正なメールアドレス 形式チェック(@マーク・ドメイン存在確認) 無効フラグの付与
プロンプト例:
「HubSpotのコンタクトデータのクレンジングレポートを作成してください。
 以下の観点でチェックしてください:
 1. メールアドレスが重複しているコンタクトのペア一覧
 2. 会社名が空欄のコンタクト数
 3. 電話番号のフォーマットが統一されていないケース
 4. ライフサイクルステージが設定されていないコンタクト数
 修正が必要なものはリストアップしてください」

Claude Codeによる経営データの可視化コンテンツマーケティングの支援でも、こうした手法が活用されています。



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

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

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

認証と権限の設計原則

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

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

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

HubSpotユーザー権限との連動

MCPサーバー経由のアクセスは、接続したHubSpotユーザーの権限に従います。チーム限定のデータやプライベートなカスタムオブジェクトは、そのユーザーがHubSpot上でアクセス権を持っている場合のみ取得可能です。また、HubSpotのアクティビティログにはMCP経由のAPI呼び出しも記録されるため、誰がどのデータにアクセスしたかを事後的に確認でき、コンプライアンス要件への対応も可能です。

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

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

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


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

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

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

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

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

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

その他の制限事項

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

カスタムMCPサーバーとの使い分け

公式MCPサーバーでカバーできないカスタムオブジェクト、ワークフローのトリガー、バルクデータ操作が必要な場合は、HubSpot APIを活用したカスタムMCPサーバーの構築が選択肢になります。

GitHub上にはPeakMojo社が公開するHubSpot MCPサーバーをはじめ、コミュニティ製のMCPサーバーが複数存在します。ベクトルストレージやキャッシュ機構を内蔵し、HubSpot APIの制限を克服するものもあります。ただし、サードパーティサーバーの利用時はセキュリティ監査を実施し、トークンの取り扱いを確認してください。

Stack Overflow社は、自社のCRM環境にMCPを導入した事例を公開しています。公式MCPサーバーの機能をベースにしつつ、自社独自のカスタムオブジェクトやビジネスロジックをカスタムツールとして追加し、営業チームの日常業務を自動化しました。このように、公式とカスタムを組み合わせるハイブリッド構成が、実務では最も現実的なアプローチです。

MCPの技術的な全体像やセキュリティ設計の詳細については、「MCPサーバーの構築ガイド|自社データをAIに接続するための設計と実装手順」で詳しく解説しています。AIエージェントの開発手法については「AIエージェント開発入門」も参考にしてください。



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

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

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



あわせて読みたい

10
SECTION 10
あわせて読みたい

まとめ

  • 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の知識が必要になります。

Q6. HubSpotの全プラン(Free、Starter、Professional、Enterprise)で利用可能ですか?

MCPサーバーの利用にはAPIアクセス権が必要です。Freeプランでも基本的なAPI操作は可能ですが、カスタムオブジェクトやマーケティングイベントの取得など、上位プランでのみ利用可能なデータはMCP経由でもアクセスできません。利用するCRMオブジェクトとプロパティが、ご契約のプランで対応しているかを事前に確認してください。

Q7. 複数のHubSpotポータルを1つのAIエージェントから操作できますか?

MCPの仕様上、1つのクライアントから複数のMCPサーバーに同時接続できるため、ポータルごとにMCPサーバーを設定すれば、1つのAIエージェントから複数ポータルのデータにアクセス可能です。ただし、ポータル間のデータ混在を防ぐため、プロンプトで対象ポータルを明示するルールの設定が推奨されます。

Q8. API呼び出し上限に達した場合、MCPサーバーの利用はどうなりますか?

HubSpotのAPI呼び出し上限に達すると、MCPサーバー経由のリクエストもエラーを返します。AIエージェントには「APIレート制限に達しました」というエラーメッセージが返され、ユーザーにその旨を通知します。頻繁にレート制限に達する場合は、キャッシュ機構の導入やリクエストの最適化を検討してください。

関連記事


株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化(ERP/CRM/SFA/MAの導入)」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、無料のお問い合わせページより、お気軽にご連絡くださいませ。

関連キーワード:

サービス資料を無料DL

著者情報

7-1

今枝 拓海 / Takumi Imaeda

株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。
HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。