HubSpot MCP Server。AIとCRMデータをつなげて使う

HubSpot MCP Serverを使うと、AIツールから直接HubSpotのCRMデータを操作できるようになります。この記事では、MCPの基本的な仕組みから、実際にClaudeと連携して感じたメリットや注意点、そしてセキュリティ面の設計について整理しました。

HubSpot MCP Serverとは

MCP（Model Context Protocol）は、AIツールが外部のデータやサービスにアクセスするための標準的なプロトコルです。HubSpotはこのMCPに対応したサーバーを提供しており、AIツールからCRMデータの取得・作成・更新が行えます。

HubSpot MCP Serverは2025年5月にPublic Betaとしてリリースされました。

2種類のMCP Server

HubSpotには目的の異なる2つのMCP Serverがあります。混同しやすいので、ここで整理しておきます。

この記事では主に Remote MCP Server（CRMデータとの連携）について扱います。

MCPでできること

Remote MCP Serverを通じて、以下のようなCRMデータ操作が可能です。

対応オブジェクトと操作

※ プライベートアプリのスコープ設定で、アクセス範囲を制限できます。

主な操作カテゴリ

• データ取得・検索：プロパティやカスタムフィールドを使った高度な検索・フィルタリング
• レコード管理：コンタクトや取引の作成、プロパティの更新、オブジェクト間の関連付け
• エンゲージメント：メモの追加、タスクの作成、アクティビティの取得
• 一括操作：複数レコードの同時更新や作成
• UI操作：特定のHubSpot画面を開くリンクの生成

MCPと連携できるAIツール

HubSpot MCP Serverは特定のAIツールに限定されず、MCPプロトコルに対応したさまざまなクライアントから利用できます。

私はClaude Desktop（現在はClaude Code）で利用しています。この記事の活用事例もClaudeでの体験に基づいています。

Claude Desktopでのセットアップ

Claude DesktopでMCP Serverを利用するには、設定ファイルに以下を追記します。詳細な手順はHubSpot公式のMCPドキュメントを参照してください。

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@hubspot/mcp-server"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-private-app-token",
        "HUBSPOT_PORTAL_ID": "your-portal-id"
      }
    }
  }
}

HubSpot側では、プライベートアプリを作成してアクセストークンを取得し、必要なスコープ（権限）を設定します。

HubSpot MCPとClaude用コネクタの比較

HubSpotのCRMデータにAIからアクセスする方法は、MCPサーバーだけではありません。Claude用のHubSpotコネクタやChatGPTコネクタも提供されています。

活用事例

実際にClaude × MCP Serverで試している内容を共有します。

ミーティングログの整理と蓄積

ZoomやGoogle Meetといったミーティングツールとの自動連携によってHubSpotに保存されたミーティングログをClaudeに渡し、要点の整理や参考情報の収集を依頼できます。整理された情報はメモアクティビティーとしてHubSpot側の会社・コンタクトに保存します。

Proプランであればワークフローで自動化できる処理ですが、Starterプランの環境でも、MCPを経由すれば高額なプランを払わずに同等の処理が実現できます。

情報のタグ付け（プロパティの動的管理）

プロパティーやその値をAPIを通じて作成・編集できるため、「複数のチェックボックス形式」のプロパティーを作成し、コンタクトや会社に気になった情報を都度タグとして付与しています。プロパティーとして保存しておけば、後からリストで絞り込みたいときに便利です。

ロール別の活用イメージ

MCP Serverの活用は個人的な運用だけでなく、チームの各ロールでも有用です。海外のHubSpotパートナーが発信しているユースケースも含めて整理しました。

MCPでできなかったこと

CRMのAPIとして公開されているデータは取得できますが、マーケティングAPI経由のデータ（例：過去に開封されたメールの一覧）はMCP Server経由では取得できません。

例えば、「過去開封されたニュースレターのvol.番号をチェックボックス形式で入れてください」という依頼はうまくいきませんでした。HubSpotのコンタクトプロパティーで取得できるメール情報は「前回のマーケティングEメール」（最後に送信されたメールの名前）のみで、過去の開封履歴はプロパティーとしては取得できないためです。

セキュリティと権限設計

HubSpotの公式ドキュメントでは、本番環境での読み取り専用権限が強く推奨されています。

エージェントがアクセスできるデータは、HubSpotプライベートアプリとそのスコープを通じて制御できます。LLMは誤認識する可能性があるため、誤操作を防ぐため、本番環境のHubSpotアカウントではスコープを読み取り専用に設定することをお勧めします。
developers.hubspot.com/mcp より

AIによるデータ編集のリスク

AIにデータ編集を任せる際には、以下のリスクを理解しておく必要があります。

• ハルシネーション：AIが誤った情報を生成し、意図しないデータ変更が発生する
• 不適切な関連付け：オブジェクト間の関連付けを誤り、データの整合性が崩れる
• 一括操作の影響範囲：複数レコードの同時更新で、想定外のデータ破損が起きる可能性

推奨される権限設計

会社でデータ編集機能の利用を検討する場合は、情報システム部門や法務部門に相談し、リスク評価と適切な管理体制を確立した上で利用してください。

MCPサーバーの選択肢

HubSpot公式以外にも、コミュニティが開発したMCPサーバーが存在します。

2025年11月以降、HubSpot Marketplaceに掲載するAIコネクタは公式MCP Serverの利用が要件となっています。基本的には公式サーバーの利用を推奨します。

HubSpot MCPの主な経緯

よくある質問

MCPは無料で使えますか？

はい。HubSpot Freeプランでも利用できます。ただし、MCP Serverの設定にはプライベートアプリの作成が必要で、多少の技術的な知識が求められます。

Starterプランでも意味がありますか？

あります。Proプランのワークフローで自動化するような処理（例：ミーティングログの整理、データの一括更新）を、MCPとAIで代替できる場合があります。上位プランへのアップグレードなしに高度な運用を実現する手段として有効です。

データが壊れる心配はありませんか？

リスクはあります。そのため、HubSpot公式も本番環境では読み取り専用のスコープ設定を推奨しています。書き込みを試す場合は、まずサンドボックス環境で検証し、本番では必要最小限の権限に絞ることが重要です。

MCPとコネクタ、どちらを使うべきですか？

手軽に始めたいならClaude用HubSpotコネクタ（OAuth接続のみ）、権限を細かく制御したい・Freeプランで使いたい場合はMCP Serverが適しています。両方を併用することも可能です。

参考情報

HubSpot公式

• HubSpot MCP Server（開発者向けポータル）
• MCP Server Beta アナウンス（2025年5月）
• Self-Service MCP Auth Apps（2026年1月）
• Remote MCP Server 統合ガイド
• Claude用HubSpotコネクタ設定ガイド
• @hubspot/mcp-server（npm）

海外パートナーの情報

• Huble - 10 AI Use Cases Enabled by MCP in HubSpot
• Aptitude8 - Integrate GPT and Claude with HubSpot Using MCP Server
• Hypha Dev - HubSpot MCP Server: What It Really Means For Your Everyday Work

日本語の参考記事

• HubSpotもMCPに参戦！？MCPサーバを使ってコンタクトを登録してみた【体験レポ】

その他

• ChatGPT用HubSpotコネクタ設定ガイド
• HubSpot Product Blog - Unlocking Deep Research CRM Connector for ChatGPT
• peakmojo/mcp-hubspot（GitHub）