HubSpot - AI Studio|HubSpotと生成AIの技術特化メディア

HubSpot MCP Server活用ガイド|AI連携でCRMデータを自然言語で操作する

作成者: 今枝 拓海|1970/01/01 0:00:00

「HubSpotのデータを分析したいが、毎回レポートを作るのが手間」「AIにCRMデータを参照させながら営業戦略を考えたいが、データのコピペが面倒」——CRMに蓄積されたデータを活用したいのに、データへのアクセス方法がボトルネックになっているケースは少なくありません。

HubSpot MCP Serverとは、Model Context Protocol(MCP)を通じて、Claude・ChatGPTなどのAIクライアントからHubSpotのCRMデータに直接アクセスし、自然言語で操作できるようにするサーバー実装です。「今月の商談一覧を表示して」「このコンタクトの過去の対応履歴をまとめて」といった自然言語の指示で、CRMデータの取得・分析・更新が可能になります。

本記事では、HubSpot MCP Serverの仕組み、セットアップ手順、実務での活用パターン、運用上の注意点を解説します。


この記事でわかること

  • MCP(Model Context Protocol)の基本概念
  • HubSpot MCP Serverのアーキテクチャと仕組み
  • セットアップ手順(Claude Desktop連携)
  • 実務での活用ユースケース
  • セキュリティ面の注意点とベストプラクティス

MCPの基本概念

MCP(Model Context Protocol)は、Anthropic社が提唱したオープンプロトコルで、AIモデルと外部データソースを安全に接続するための標準規格です。従来、AIにCRMデータを参照させるには、CSVエクスポートやAPIの手動連携が必要でしたが、MCPを使えばAIクライアントが直接CRMデータにアクセスできます。

簡単に言えば、MCPは「AIとデータソースの間の共通言語」です。HubSpot、Salesforce、Notionなど様々なデータソースに対応したMCPサーバーが公開されており、AIクライアント側はプロトコルに準拠するだけであらゆるデータソースに接続できます。

なぜMCPが注目されているのか

従来のAI × CRM連携では、以下のような課題がありました。

  • データのエクスポート・加工・プロンプトへの貼り付けが手動
  • APIキーの管理やリクエスト制限への対応が煩雑
  • データの鮮度が保てない(スナップショットベースの分析)

MCPを使えば、AIがリアルタイムでCRMデータを参照しながら回答を生成できるため、これらの課題が解消されます。


HubSpot MCP Serverの仕組み

アーキテクチャ

AIクライアント(Claude Desktop等)
    ↕ MCP Protocol
HubSpot MCP Server(ローカル実行)
    ↕ HubSpot API
HubSpot CRM(クラウド)

HubSpot MCP Serverはローカル環境で動作し、AIクライアントからのリクエストをHubSpot APIコールに変換して実行します。AIクライアントはMCPプロトコルを通じてサーバーと通信するため、HubSpot APIの詳細を意識する必要がありません。

主要な機能

HubSpot MCP Serverで利用可能な主要機能は以下の通りです。

機能カテゴリ できること
コンタクト管理 コンタクトの検索・取得・作成・更新
会社管理 会社レコードの検索・取得・作成・更新
取引管理 取引の検索・パイプライン情報の取得
チケット管理 サポートチケットの検索・取得
エンゲージメント メール・ノート・タスクの取得
関連付け オブジェクト間の関連付け情報の取得

セットアップ手順(Claude Desktop連携)

前提条件

  • Node.js 18以上がインストールされていること
  • HubSpotのプライベートアプリトークンを取得済みであること
  • Claude Desktopがインストールされていること

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

  1. HubSpotの「設定」→「連携」→「プライベートアプリ」に移動
  2. 「プライベートアプリを作成」をクリック
  3. アプリ名を設定(例: 「MCP Server」)
  4. 必要なスコープを設定(crm.objects.contacts.read、crm.objects.deals.read 等)
  5. アプリを作成し、アクセストークンを控える

ここが結構ミソになってくるのですが、スコープの設定は必要最小限にすることが重要です。読み取りだけで十分な場合は、書き込み権限を付与しないようにしましょう。セキュリティの観点から、最小権限の原則を適用することをおすすめします。

ステップ2: HubSpot MCP Serverのインストール

npmを使ってMCP Serverパッケージをインストールします。

ステップ3: Claude Desktopの設定

Claude Desktopの設定ファイル(claudedesktopconfig.json)にMCPサーバーの設定を追加します。HubSpotのアクセストークンを環境変数として設定し、サーバーの起動コマンドを指定します。

ステップ4: 動作確認

Claude Desktopを再起動し、「HubSpotのコンタクトを5件表示して」と入力して、正常にデータが返ってくることを確認します。


実務での活用ユースケース

ユースケース1: 営業会議の事前準備

営業会議の前に「今月のパイプラインの状況をまとめて」「受注見込みが高い取引のトップ10を教えて」とAIに指示するだけで、リアルタイムのCRMデータに基づいた報告資料のドラフトが生成されます。

当社でも、HubSpotのデータを使った分析にAIを活用していますが、「ちょっとリサーチするアプローチメール考える時はこういったものを使ってたりはします」というように、AIにデータを参照させながら業務を進めるスタイルが定着しつつあります。

ユースケース2: 顧客分析

「過去6ヶ月で失注した取引の共通点を分析して」「業種別の商談化率を比較して」といったアドホックな分析を、レポートを作成することなく自然言語で実行できます。

ユースケース3: データクレンジングの補助

「重複していそうなコンタクトを検出して」「会社名が未入力のコンタクトの一覧を出して」といった指示で、データ品質の問題を素早く特定できます。

ユースケース4: パーソナライズメールのドラフト作成

コンタクトの情報(会社情報、過去のやり取り、取引履歴)をAIが参照しながら、パーソナライズされたメールのドラフトを生成できます。ただし、AIが生成したメールは必ず人間がレビューしてから送信しましょう。「基本的には送信前に確認が良いかなと思いますね」——この原則はMCP連携でも変わりません。


セキュリティとガバナンスの設計

アクセス権限の設計

  • 読み取り専用トークンの使用: 分析やレポート用途であれば、書き込み権限を付与しない
  • プロパティレベルの制御: センシティブなプロパティ(年収、個人情報等)へのアクセスを制限
  • 利用者の限定: MCP Server経由のアクセスを管理者やマネージャーに限定

データプライバシーへの配慮

MCPを通じてAIに送信されるデータには個人情報が含まれる可能性があります。自社のプライバシーポリシーとAIサービスの利用規約を確認し、コンプライアンス上の問題がないか事前に検証しましょう。

正直な限界

  • ベータ段階の技術: MCP自体がまだ発展途上のプロトコルであり、仕様の変更やブレイキングチェンジが発生する可能性があります
  • 大量データの処理制限: HubSpot APIのレート制限により、大量データの一括取得には制約があります
  • 日本語対応: MCPサーバー自体は日本語データを扱えますが、AIクライアント側の日本語理解精度によってはデータの解釈が不正確になるケースもあります

まとめ

HubSpot MCP Serverを活用すれば、AIクライアントから自然言語でCRMデータにアクセスし、分析・レポート・データクレンジングなどの業務を効率化できます。まずは読み取り専用の設定でセットアップし、営業会議の準備やアドホック分析から使い始めてみましょう。

MCPはまだ新しい技術ですが、AI × CRMの連携方法として今後急速に普及していくことが予想されます。早期に触れておくことで、自社のAI活用の幅を広げられるかなと思います。

無料相談はこちら → StartLink お問い合わせ


よくある質問(FAQ)

Q1. MCPを使うのにプログラミングスキルは必要ですか?

初期セットアップではコマンドライン操作(npmコマンドや設定ファイルの編集)が必要です。ただし、一度セットアップが完了すれば、日常的な利用は自然言語で行えます。セットアップ自体も、手順に従えばエンジニアでなくても対応可能です。

Q2. HubSpotの全データがAIに送信されるのですか?

いいえ、AIが必要とするデータのみがリクエストごとに取得されます。全データが一括でAIに送信されることはありません。また、プライベートアプリのスコープ設定で、アクセス可能なデータの範囲を制限できます。

Q3. Claude以外のAIクライアントでも使えますか?

MCPプロトコルに対応しているAIクライアントであれば利用可能です。現時点ではClaude Desktopが最も安定した対応を提供していますが、今後対応クライアントは増えていくと予想されます。

Q4. MCP経由でHubSpotのデータを更新(書き込み)できますか?

プライベートアプリに書き込み権限のスコープを設定すれば、コンタクトの更新や取引の作成なども可能です。ただし、誤操作によるデータ破損を防ぐため、最初は読み取り専用で運用し、慣れてから書き込み権限を追加することをおすすめします。

Q5. SalesforceにもMCP Serverはありますか?

はい、Salesforce用のMCP Serverも公開されています。MCPはプロトコルの標準化を目指しているため、HubSpotとSalesforceの両方を使っている企業でも、同じAIクライアントから両方のCRMデータにアクセスできます。