「HubSpotのCRMデータをAIで分析したいけど、毎回エクスポートしてからChatGPTに貼り付けるのが面倒」「Claude DesktopからHubSpotのコンタクトや取引情報に直接アクセスできたら便利なのに」——こうしたニーズに応えるのが、HubSpot MCP Serverです。
HubSpot MCP Serverとは、Model Context Protocol(MCP)に対応したAIクライアント(Claude Desktop、Cursor、ChatGPTなど)からHubSpot CRMデータにセキュアにアクセスするためのリモートゲートウェイです。 2025年にパブリックベータとして公開され、AIクライアントとCRMデータをリアルタイムで接続できます。
この記事では、HubSpot MCP Serverの仕組みからセットアップ手順、実務での活用方法までを解説します。
この記事でわかること:
MCP(Model Context Protocol)とは、AIモデルが外部アプリケーションのデータやツールにアクセスするための標準化されたプロトコルです。Anthropic(Claudeの開発元)が開発したオープンソースのフレームワークであり、LLM(大規模言語モデル)と外部ツールの接続方法を標準化することを目指しています。
わかりやすく言えば、AIアシスタントが「HubSpotのデータを見て」「Slackにメッセージを送って」といった外部ツール操作を行うための共通のインターフェースです。
AIクライアント(Claude/ChatGPT) ←→ MCPプロトコル ←→ MCPサーバー ←→ 外部アプリケーション(HubSpot等)
従来は、AIツールごとに個別のAPI連携やプラグインが必要でしたが、MCPにより一つの標準プロトコルで複数のアプリケーションと接続できるようになります。これはSalesforceでいうAPIレイヤーのような位置づけですが、AIネイティブな設計という点が大きく異なります。
出典: HubSpot Developers (developers.hubspot.com/mcp)
HubSpot MCP Serverは、MCP対応のAIクライアントからHubSpot CRMデータにセキュアにアクセスするためのリモートゲートウェイです。
現在のアクセス可能なデータ(パブリックベータ時点):
| CRMオブジェクト | 読み取り | 備考 |
|---|---|---|
| コンタクト | ○ | 個人情報保護プロパティは除外 |
| 会社 | ○ | |
| 取引 | ○ | |
| チケット | ○ | |
| 見積もり | ○ | |
| 請求書 | ○ | |
| 製品 | ○ | |
| 明細項目 | ○ | |
| サブスクリプション | ○ | |
| 注文 | ○ | |
| カート | ○ | |
| ユーザー | ○ | |
| オブジェクト間の関連付け | ○ |
現時点での制限事項:
ここが結構ミソになってくるのですが、現時点では読み取り専用です。AIクライアントからCRMデータを参照・分析することはできますが、データの作成・更新・削除はできません。将来的に書き込み機能が追加される可能性はありますが、セキュリティの観点からも、まずは読み取り専用で利用を開始するのがよいかなと思います。
出典: HubSpot Developers (developers.hubspot.com)
推奨スコープ:
crm.objects.contacts.readcrm.objects.companies.readcrm.objects.deals.readcrm.objects.tickets.readClaude Desktopの設定ファイル(claudedesktopconfig.json)にMCPサーバーの設定を追加します。
{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com/sse",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}
設定ファイルの場所:
~/Library/Application Support/Claude/claudedesktopconfig.json%APPDATA%\Claude\claudedesktopconfig.jsonHubSpotは公式のリモートMCPサーバー(mcp.hubspot.com)を提供しているため、ローカルにサーバーを立てる必要はありません。
Cursorの設定画面(Settings → MCP)でMCPサーバーを追加します。
https://mcp.hubspot.com/sseChatGPTは2025年後半にMCPの対応を進めていますが、公式のネイティブサポート状況は変動しています。現時点では、MCPブリッジツールやサードパーティ連携を通じた接続が可能です。
AIクライアントから以下のようなプロンプトで接続をテストします。
HubSpotのコンタクト一覧を10件表示してください。
正常に接続されていれば、CRMのコンタクトデータが返されます。
従来の方法: HubSpotにログイン → 会社レコードを検索 → 過去の取引・メール・ミーティングを手動で確認 → メモにまとめる
MCP活用:
「株式会社〇〇の会社情報、関連する取引の状況、過去のコンタクト履歴をまとめてください。次回の商談で押さえるべきポイントも提案してください。」
AIが自動でCRMデータを参照し、企業情報・取引状況・過去の接触履歴を横断的に分析してレポートを生成します。
「現在の取引パイプラインで、30日以上ステージが変わっていない取引を一覧で出してください。金額の大きい順に並べて、それぞれの懸念点を分析してください。」
営業マネージャーがダッシュボードを見るだけでは気づきにくい「停滞案件」をAIが自動で検出し、対応の優先順位を提案してくれます。
「コンタクトの中で、メールアドレスが空欄のレコード、会社が関連付けられていないレコードの数を教えてください。データ品質の改善提案もお願いします。」
CRMの値がなかなか入っていなくてデータ資産化していない——こうした課題をAIで可視化し、データクレンジングの優先順位を特定できます。
「今月クローズした取引の一覧と、合計金額、平均取引サイクルを計算してください。先月との比較も含めてレポート形式でまとめてください。」
毎週のレポート作成を自動化できます。ダッシュボードの定期配信と組み合わせれば、データの時点固定化にも対応できます。
Claude Code(ターミナルベースのAI開発ツール)でMCPを設定すると、コーディング中にHubSpotのデータスキーマやプロパティ一覧を参照しながら、HubSpot APIの連携コードを生成できます。
「HubSpotの取引オブジェクトのプロパティ一覧を確認して、取引ステージごとの集計APIコール(Python)を書いてください。」
HubSpot公式のMCP Server以外にも、コミュニティやサードパーティが開発したMCPサーバーが存在します。
| 項目 | HubSpot公式MCP Server | サードパーティ(例: peakmojo/mcp-hubspot) |
|---|---|---|
| 提供元 | HubSpot | コミュニティ開発者 |
| 認証 | OAuth 2.0(公式) | Private Appトークン |
| ホスティング | HubSpotがリモートで提供 | ローカルで実行 |
| 対応範囲 | CRMオブジェクト(読み取り) | CRM + 一部書き込み対応の場合あり |
| サポート | HubSpot公式サポート | コミュニティサポート |
| セキュリティ | HubSpotのセキュリティ基盤 | 自己責任 |
公式MCPサーバーは安全性とサポートの面で推奨されますが、書き込み機能が必要な場合はサードパーティ製の選択肢もあります。ただし、セキュリティリスクの評価は自己責任で行う必要があります。
非公開アプリのスコープ設定では、実際に必要なオブジェクトのみに読み取り権限を付与しましょう。不要なスコープを付与すると、セキュリティリスクが増大します。
MCP経由でAIクライアントにCRMデータが送信されるため、社内のデータガバナンスポリシーとの整合性を確認してください。特に個人情報や機密データの取り扱いについて、情報セキュリティ部門との事前協議をおすすめします。
上場・上場準備企業では、SSO、2FA、IP制限に加えて、MCP経由のデータアクセスについてもセキュリティレビューを実施することを推奨します。
HubSpot MCP Serverは、AIクライアントとCRMデータをリアルタイムで接続する新しいインターフェースです。従来のAPI連携と異なり、自然言語でCRMデータに対する質問・分析・レポート生成が可能になります。
まずはClaude DesktopまたはCursorで接続を設定し、コンタクトや取引データの参照からスタートしてみましょう。AIがCRMデータを直接参照できるようになることで、商談準備・レポート作成・データ分析の効率が大きく向上します。
現時点では読み取り専用のパブリックベータですが、今後の機能拡張(書き込み対応、カスタムオブジェクト対応など)にも期待かなと思います。段階的に活用範囲を広げていき、AIとCRMが連携した業務プロセスを構築していきましょう。
MCP Server自体の利用料は現時点では発生しません。ただし、HubSpotの有償プラン(CRMオブジェクトへのAPIアクセス権限)が必要です。また、AIクライアント側(Claude Pro、ChatGPT Plus等)のサブスクリプション費用は別途必要です。
現時点のパブリックベータでは読み取り専用です。CRMレコードの作成・更新・削除はできません。書き込み機能が必要な場合は、HubSpotの通常のAPI(v3 API)を使用するか、サードパーティ製のMCPサーバーを検討してください。
はい、MCPプロトコルに対応したAIクライアントであれば利用可能です。現在確認されているのは、Claude Desktop、Cursor、VS Code(GitHub Copilot)、Windsurf、Claude Codeなどです。ChatGPTについてはMCPのネイティブ対応が進行中です。
HubSpot公式MCP ServerはOAuth 2.0認証を使用し、HubSpotのセキュリティ基盤上で動作します。ただし、CRMデータがAIクライアント(Claude、ChatGPTなど)に送信されることは事実ですので、各AIサービスのデータ取り扱いポリシーを確認し、社内の情報セキュリティポリシーとの整合性を事前にチェックしてください。センシティブデータプロパティは自動的に除外されます。
MCP Serverは「AIクライアントからの対話的なデータアクセス」に適しています。一方、従来のAPI(v3 REST API)は、アプリケーション間のデータ連携、バッチ処理、書き込み操作に適しています。分析・レポート・質問応答にはMCP、システム連携・自動化にはREST APIという使い分けがおすすめです。