HubSpot MCP Serverの活用ガイド｜AIエージェントからCRMデータを操作する方法

  • 2026年3月10日
  • 最終更新: 2026年3月11日

ブログ目次


HubSpotは2026年1月にMCP Serverのパブリックベータを開始し、CRM業界で初めて主要3大LLM（ChatGPT、Claude、Gemini）すべてに対応した公式MCPコネクタを提供しています。INBOUND 2025の時点で、20,000以上の顧客が2,300万件のCRMレコードをAIエージェント経由で活用しており、MCPによるCRM操作は急速に実用段階へと進んでいます。

本記事では、HubSpot MCP Serverのセットアップからツールの活用方法、実践的なユースケースまでを解説します。

この記事でわかること

  • HubSpot MCP Serverが提供する9つのツールの機能と対応CRMオブジェクトが理解できます
  • Claude、ChatGPT、CursorなどのMCPクライアントからHubSpotに接続する手順がわかります
  • AIエージェントを活用した営業・マーケティング業務の自動化パターンを具体的に学べます
  • HubSpot MCP Serverのセキュリティモデルとアクセス制御の仕組みが把握できます
  • カスタムMCPサーバーとの使い分けや拡張方法がわかります

HubSpot MCP Serverの概要

提供されるツール一覧

HubSpot MCP Serverは、ローンチ時点で9つのツールを提供し、マーケティング・営業・カスタマーサービスチームが日常的に操作するCRMオブジェクトをカバーしています。

ツール名 対応オブジェクト 操作内容
search_contacts コンタクト 条件指定によるコンタクト検索
get_contact コンタクト 個別コンタクトの詳細取得
search_companies 会社 会社情報の条件検索
get_company 会社 個別会社の詳細取得
search_deals 取引 パイプラインの取引検索
get_deal 取引 個別取引の詳細取得
search_tickets チケット サポートチケットの検索
get_ticket チケット 個別チケットの詳細取得
get_crm_schema 全オブジェクト カスタムプロパティ定義の取得

対応クライアント

HubSpot MCP Serverは、2025年にChatGPT（6月）、Claude（7月）、Gemini（9月）と段階的にコネクタをリリースしました。2026年現在では、Cursor、Visual Studio Code、Microsoft Copilotなど、MCPプロトコルに対応するすべてのクライアントから接続可能です。

従来のHubSpot APIとの違い

従来のREST APIでは、開発者がエンドポイントのURL、リクエストパラメータ、ページネーション、エラーハンドリングをすべてコードで記述する必要がありました。MCP Serverでは、AIエージェントが自然言語の指示を受けて適切なツールを自動選択し、パラメータを構成して実行します。レポートの作成やダッシュボードの構築なしに、対話型でCRMデータを分析できる点が大きな違いです。

セットアップ手順

HubSpot側の準備

HubSpot MCP Serverを利用するには、HubSpotのデベロッパーポータルでMCPアプリケーションを作成し、必要なスコープ（crm.objects.contacts.read、crm.objects.deals.read等）を設定します。OAuth 2.0による認証フローが採用されており、初回接続時にHubSpotの認可画面でアクセス許可を行います。

Claude Desktopでの接続設定

Claude Desktopの場合、設定ファイル（claude_desktop_config.json）にHubSpot MCP Serverのエンドポイントを追加します。HubSpotが提供するリモートMCPサーバーのURLを指定することで、ローカルにサーバーを立ち上げることなく接続できます。

Cursorでの接続設定

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

営業チームの活用パターン

パイプライン分析の自動化

「今月クロージング予定の取引を金額順に表示して」「ステージが1ヶ月以上停滞している取引を抽出して」といった自然言語の指示で、パイプラインの状況を即座に把握できます。従来はレポート作成に数分かかっていた分析が、会話の中で数秒で完了します。

コンタクト情報の横断検索

「先月ウェビナーに参加した東京の企業のコンタクトを一覧にして」のような複合条件の検索も、AIエージェントが適切なフィルタを構成して実行します。CRMのフィルタUIを操作する必要がなくなり、営業担当者がデータ活用に費やす時間を大幅に削減できます。

商談準備のワークフロー

商談前に「この会社との過去のやり取りをまとめて」と指示すれば、会社情報、関連するコンタクト、過去の取引履歴、オープンチケットを横断的に取得し、商談に必要な情報を一画面で確認できます。

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

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

「スコアが80以上のリードのうち、直近30日でWebサイトに3回以上訪問したコンタクトを抽出して」といった分析を、マーケティング担当者がSQLやAPIの知識なしに実行できます。

キャンペーン効果の検証

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

セキュリティとアクセス制御

OAuthスコープによる権限管理

HubSpot MCP Serverでは、OAuthの認可時に付与するスコープによってAIエージェントのアクセス範囲を制御します。読み取り専用のスコープ（*.read）のみを付与すれば、AIエージェントがデータを変更するリスクを排除できます。

HubSpotのユーザー権限との連動

MCPサーバー経由のアクセスは、接続したHubSpotユーザーの権限に従います。チーム限定のデータやプライベートなカスタムオブジェクトは、そのユーザーがHubSpot上でアクセス権を持っている場合のみ取得可能です。

監査とログ

HubSpotのアクティビティログには、MCP経由のAPI呼び出しも記録されます。誰がどのデータにアクセスしたかを事後的に確認でき、コンプライアンス要件への対応が可能です。

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

公式MCPサーバーの限界

HubSpot公式のMCP Serverは主要なCRMオブジェクトの読み取りに最適化されていますが、カスタムオブジェクト、ワークフローのトリガー、バルクデータ操作などには対応していません。これらの高度な操作が必要な場合は、HubSpot APIを活用したカスタムMCPサーバーの構築を検討してください。

サードパーティMCPサーバーの活用

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

Stack Overflow社のCRM MCP実装事例

Stack Overflow社は、自社のCRM環境にMCPを導入した事例を公開しています。公式MCP Serverの機能をベースにしつつ、自社独自のカスタムオブジェクトやビジネスロジックをカスタムツールとして追加し、営業チームの日常業務を自動化しました。

AIエージェントの開発手法についてはAIエージェント開発入門も参考にしてください。

まとめ

本記事では、HubSpot MCP Serverを活用してAIエージェントからCRMデータを操作する方法について、セットアップから実践的なユースケースまで解説しました。

ポイントを振り返ります。

  • HubSpot MCP Serverは9つのツールを提供し、コンタクト・会社・取引・チケットの検索と取得を自然言語の指示で実行できます
  • Claude Desktop・ChatGPT・Cursorなど主要なMCPクライアントからリモート接続が可能で、ローカルサーバーの構築は不要です
  • OAuthスコープによる権限制御とHubSpotユーザー権限の連動により、AIエージェントのアクセス範囲を適切に管理できます
  • 公式MCPサーバーでカバーできないカスタムオブジェクトやバルク操作には、HubSpot APIを活用したカスタムMCPサーバーの構築が選択肢となります

CRMを活用した業務効率化やAIとの連携に関するご相談は、CRM特化型コンサルティングのStartLinkまでお気軽にお問い合わせください。

よくある質問（FAQ）

Q. HubSpot MCP Serverは無料で利用できますか？

はい、HubSpot MCP Serverはパブリックベータとして無料で提供されています。ただし、MCPサーバーへのアクセスにはHubSpotアカウントとOAuth認証が必要であり、HubSpotのAPI呼び出し上限（レート制限）はMCP経由のリクエストにも適用されます。

Q. HubSpot MCP Serverでデータの書き込み（作成・更新）はできますか？

2026年3月現在のパブリックベータでは、主にCRMオブジェクトの検索と取得（読み取り）に対応しています。書き込み機能は段階的に追加される予定です。現時点でデータの作成・更新が必要な場合は、HubSpot REST APIを利用したカスタムMCPサーバーの構築をご検討ください。

Q. HubSpotの全プラン（Free、Starter、Professional、Enterprise）で利用可能ですか？

MCP Serverの利用にはAPIアクセス権が必要です。Freeプランでも基本的なAPI操作は可能ですが、カスタムオブジェクトやマーケティングイベントの取得など、上位プランでのみ利用可能なデータはMCP経由でもアクセスできません。

Q. 1日のAPI呼び出し上限に達した場合、MCP Serverの利用はどうなりますか？

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

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

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

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

関連キーワード:

サービス資料を無料DL

著者情報

7-1

今枝 拓海 / Takumi Imaeda

株式会社StartLinkの代表取締役。
HubSpotのトップパートナーである株式会社H&Kにて、HubSpotのCRM戦略/設計/構築を軸として、 国内・外資系エンタープライズ企業へコンサルティング支援を実施。 パーソルホールティングス株式会社にて、大規模CRM/SFA戦略の策定・PERSOLグループ横断のグループAI戦略/企画/開発ディレクションの業務を遂行経験あり。
株式会社StartLinkでは、累計100社以上のHubSpotプロジェクト実績を元にHubSpot×AIを軸にした経営基盤DXのコンサルティング事業を展開。