要約
HubSpot MCPを使うと、MCP対応のAIツールが独自のインテグレーションではなく標準プロトコルを通じてHubSpotに接続できます。HubSpotは現在2つのMCPサーバーを提供しています。CRMデータへのアクセス用のリモートHubSpot MCPサーバーと、アプリやCMSアセットを構築するためのローカルDeveloper MCPサーバーです。リモートサーバーを使用するには、HubSpotでMCP認証アプリを作成し、MCPクライアントをhttps://mcp.hubspot.comに接続し、PKCEを使用してOAuth認証を行い、HubSpotデータに対してプロンプトを開始します。Workatoはこのパターンを拡張し、マーケティング・財務・サポート・データウェアハウス・承認システムを含むエンタープライズスタック全体にわたって、ガバナンスされたマルチシステムのビジネスアクションをMCPツールとして公開します。
AIの普及は、人々が日々取り組むユースケースの種類にも変化をもたらしています。営業チームやマーケティングチームもこの変化を目の当たりにしています。
RevOpsマネージャーは、どの高額案件が進捗を止めているかを知りたいと思うかもしれません。キャンペーンマネージャーは、先四半期にどのHubSpotキャンペーンがパイプラインに影響したかを平易な言葉で尋ねたいかもしれません。これらはもはや特別で未来志向のユースケースではありません。
これらのワークフローをサポートする方法のひとつがMCPです。
HubSpot MCPは、MCP対応のAIツールにHubSpot CRMデータへの標準化された接続方法を提供します。これによりエージェントはレコードをクエリし・アクティビティを要約し・商談を確認し、サポートされている場合は認証済みのツールコールを通じてCRMオブジェクトを作成または更新できます。
典型的なワークフローはHubSpotを超えてSlack・Google Ads・Snowflake・Zendesk等にまで及ぶことに気づくでしょう。
ここでWorkatoが、そのコンテキストをガバナンスされたマルチシステムのアクションへと変換するのに役立ちます。たとえばエージェントはHubSpot MCPを使って滞留している商談を特定し、その後WorkatoでSlackの適切なチームに通知したり・Snowflakeからアカウントをエンリッチしたり・フォローアップワークフローを作成したりできます。
本ガイドでは、HubSpot MCPの仕組み・セットアップ方法・Workatoを使ってより広範なエンタープライズワークフローへと拡張する方法を説明します。
HubSpot MCPとは何か？
MCP（Model Context Protocol）は、AIアシスタントとエージェントが一貫した方法で外部ツール・システム・データソースに接続できるオープンスタンダードです。
エージェントにすべてのCRMアクションをハードコードする代わりに、MCPはエージェントが利用可能なツールを検出し、データやアクションをリクエストするための構造化された方法を提供します。
HubSpot MCPとは、互換性のあるAIツールがCRMデータソースまたは開発者プラットフォームとしてHubSpotと連携できるようにするHubSpotのMCPサーバーを指します。
これにより、AIアシスタントはどのサーバーを使用するかに応じて、商談の要約・CRMレコードの確認・サポートされているレコードとアクティビティの作成または更新・HubSpotアプリ開発のサポートを行えます。
実際、HubSpotは2つの異なるMCPエクスペリエンスを提供しており、次のセクションでカバーします。
エージェントにすべてのCRMアクションをハードコードする代わりに、MCPはエージェントが利用可能なツールを検出し、データやアクションをリクエストするための構造化された方法を提供します。
リモートHubSpot MCPサーバーとDeveloper MCPサーバーの違い
リモートHubSpot MCPサーバーは、AIエージェントをHubSpot CRMデータに接続したいRevOpsチーム・AIエンジニア・CRM管理者がほとんどの場合に探しているものです。
HubSpotによってhttps://mcp.hubspot.comでホストされ、PKCEを使用したOAuthベースの認証を通じてサポートされているCRMデータへのセキュアな読み取りと書き込みアクセスをサポートしています。
Developer MCPサーバーはHubSpotアプリとCMSコンテンツを構築する開発者向けのローカルCLIベースのサーバーです。HubSpot CLIを通じて動作し、AgenticsなコーディングツールがnHubSpotの開発者プラットフォームとインタラクションするのを支援します。
「この商談で何が変わりましたか？」や「この連絡先のフォローアップタスクを作成してください」といったことをAIツールに対応させたい場合はリモートサーバーを使用してください。
HubSpot UIエクステンションのスキャフォールディング・CMSアセットの操作・HubSpot開発者ツールのナビゲーションの支援が必要な場合はDeveloper MCPサーバーを使用してください。
リモートHubSpot MCPサーバーは何をするのか？
リモートHubSpot MCPサーバーはMCP対応のAIクライアントとHubSpot CRMデータの間の橋渡し役として機能します。
HubSpotのドキュメントによると、既存のHubSpotユーザー権限を尊重しながら、サポートされているCRMレコード・アクティビティ・マーケティングとコンテンツデータ・キャンペーンデータ・組織コンテキストを公開できます。
利用可能な機能には、連絡先・会社・商談・チケット・ユーザー・カート・請求書・注文・明細行・製品・見積書・サブスクリプション・リストなどのCRMレコードの読み取りが含まれます。また、通話・メール・ミーティング・メモ・タスクなどのアクティビティデータもサポートしています。
書き込みアクセスについては、HubSpotは連絡先・会社・商談・チケット・明細行・製品・通話・メール・ミーティング・メモ・タスクなどのアクティビティへの書き込みサポートを文書化しています。
ただし、いくつかの制限があります。HubSpotはアクションが認証済みユーザーの既存の権限を尊重することを規定しています。
また、カスタムの機密データプロパティはMCPサーバーを通じて利用できないことも明記されており、アカウントで「機密データ」がオンになっている場合、標準のCRM APIは引き続きサポートしていてもMCPを通じてアクティビティオブジェクトがブロックされる場合があることも注記されています。
Developer MCPサーバーは何をするのか？
Developer MCPサーバーはローカル開発ワークフロー向けです。サポートされているコーディングツールがHubSpot CLIを通じてHubSpot Developer Platformとインタラクションできるようにします。
HubSpot CLIコマンドの動作の確認・UIエクステンションプロジェクトのスキャフォールディング・開発者ドキュメントの確認・ローカルのアプリとCMS開発タスクの管理支援などに使用できます。
セットアップ時に、Cursor・Claude Code・Codex CLI・Gemini CLI・VS Code・Windsurfなど設定するサポートされているクライアントを選択します。HubSpotはnpx @hubspot/cliを使用するスタンドアロンモードもサポートしており、グローバルなnpmインストールが制限されている場合に役立ちます。
CRMアクセスのためのHubSpot MCPのセットアップ方法
CRMデータアクセスには、リモートHubSpot MCPサーバーを使用する必要があります。このセクションではMCPサーバーのセットアッププロセスを説明します。
HubSpotでMCP認証アプリを作成する
HubSpotアカウントで、「開発」から「MCP認証アプリ」に移動します。新しいMCP認証アプリを作成し、アプリ名・説明・リダイレクトURL・任意のアイコンを入力します。
HubSpotはその後、アプリのOAuth認証情報を生成します。MCP Inspectorでテストする場合、HubSpotのドキュメントではリダイレクトURLとしてhttp://localhost:6274/oauth/callback/debugを含めることが記載されています。
MCPクライアントを設定する
MCPクライアントはhttps://mcp.hubspot.comに接続する必要があり、MCP認証アプリの詳細ページからクライアントID・クライアントシークレット・リダイレクトURLが必要です。クライアントのリダイレクトURLはHubSpotで設定されたものと一致する必要があります。
PKCEを使用してOAuth認証する
PKCEはProof Key for Code Exchangeの略で、特にパブリッククライアントの認証フローを保護するのに役立つOAuthセキュリティ拡張機能です。
HubSpotはMCP認証にPKCEを必要とするため、MCPクライアントはそれを自動的に処理するか、ベリファイアとチャレンジフローを正しく実装する必要があります。
認証時に、ユーザーはHubSpotアカウントを選択し・権限を付与し・アプリを認証します。生成されたアクセストークンにより、MCPクライアントはそのユーザーに代わってHubSpot MCPリクエストを行えます。
HubSpotはMCP認証にPKCEを必要とするため、MCPクライアントはそれを自動的に処理するか、ベリファイアとチャレンジフローを正しく実装する必要があります。
接続をテストする
クイック検証には、HubSpotはOAuthとPKCEを自動的に処理するMCP Inspectorを推奨しています。接続されたら、ツールをリストアップし、get_user_detailsのような基本的なツールを実行して認証済みユーザー・アカウント・利用可能なオブジェクトアクセスを確認できます。
プロンプトを開始する
MCPクライアントが接続されたら、自然言語プロンプトを使ってHubSpotデータをクエリしてアクションを実行できます。
HubSpot MCPのプロンプト例
HubSpot MCPサーバーで使用するサンプルのMCPプロンプトをいくつか確認すると役立ちます。書き込みアクションを許可する前に、リスクの低い読み取り専用プロンプトから始めてください。
以下のようなプロンプトを試してみましょう。「現在提案ステージにある25,000ドル以上のすべての進行中の商談を要約してください。」「Acme Corpの連絡先を見つけ、最近のアクティビティを要約してください。」「過去14日間アクティビティがない商談はどれですか？」「今月クローズ予定の商談の担当者を表示してください。」「ライフサイクルステージとリードステータスのプロパティ定義を見つけてください。」
最も効果的なプロンプトは、オブジェクトの種類・フィルター・日付範囲・希望する出力について具体的です。「パイプラインリスクを要約してください」は曖昧です。「過去30日間にミーティングが記録されていない今四半期クローズ予定の50,000ドル以上のエンタープライズ商談を一覧表示してください」の方がはるかに有用です。
HubSpot MCPのベストプラクティス
どのツールにも推奨される使用ガイドラインがあり、HubSpot MCPも例外ではありません。以下にいくつかのガイドラインをご紹介します。
1. 読み取り専用ユースケースから始める：
レコード作成や更新を有効にする前に、AIを使って商談を要約・レコードを確認・運用上の質問に答えることでチームが信頼を築けるようにすることが重要です。
2. 最小権限アクセスを使用する：
HubSpot MCPはユーザー権限を尊重するため、エージェントを接続する前にHubSpotのロールと権限を整理しておく必要があります。
3. プロンプトで明確に指定する：
必要なオブジェクト・フィルター・フィールド・または出力形式を正確に指定してください。
4. 書き込みアクションを慎重に監視する：
タスクの作成やレコードの更新は時間を節約できますが、プロンプトが曖昧だとCRMのデータ品質を損なう可能性もあります。
5. トークンの更新を計画する：
OAuthアクセストークンは期限切れになるため、カスタムクライアントはリフレッシュトークンを正しく使用し、必要に応じて認証を再実行する必要があります。
6. サポートを確認していない限り機密データワークフローを避ける：
HubSpotは機密データプロパティとアクティビティアクセスに関して、機密データが有効になっているアカウントに制限を設けています。
WorkatoのEnterprise MCPアプローチは、AIエージェントを1つのCRMだけでなく、数百のアプリとシステムにわたってガバナンスされたワークフローに接続します。
WorkatoがMCPスタイルのワークフローをエンタープライズ全体に拡張する方法
HubSpot MCPは、仕事がHubSpot内で始まり、HubSpot内で終わる場合に強力です。しかし多くのエンタープライズワークフローはそうではありません。たとえば、キャンペーンパフォーマンスの問いにはHubSpot・Google Ads・Snowflake・財務データが必要な場合があります。
営業フォローアップワークフローにはHubSpot・Slack・Gong・DocuSign・承認プロセスが必要な場合があります。
ここでWorkatoがMCPパターンを単一のアプリケーションを超えて拡張します。WorkatoのEnterprise MCPアプローチは、AIエージェントを1つのCRMだけでなく、数百のアプリとシステムにわたってガバナンスされたワークフローに接続します。
これにより、チームは再利用可能なビジネスアクションをMCPツールとして公開し・承認ステップを追加し・レート制限を適用し・ユーザーベースのアクセスを強制し・監査証跡を維持できます。
たとえば、AIエージェントはHubSpotのコンテキストを使って滞留している商談を特定し・ウェアハウスからのプロダクト利用データでアカウントをエンリッチし・Slackでアカウントチームに通知し・ビジネスルールを確認した後にのみフォローアップタスクを作成できます。
HubSpotはCRMコンテキストを提供し、Workatoはそのコンテキストをより広範なエンタープライズワークフローに接続するガバナンスされた再利用可能なアクションを公開できます。
HubSpot MCPを試しているチームであれば、次のステップはWorkatoがHubSpotデータとAIエージェントをビジネスの残りのシステムにどのように接続できるかを探ることです。これにより、AgenticsなワークフローはただのCRMルックアップを超えて、セキュアなマルチシステムの実行へと移行できます。
よくある質問
HubSpotにはMCPサーバーがありますか？
はい。HubSpotはCRMデータアクセス用のリモートHubSpot MCPサーバーと、アプリとCMS開発用のローカルDeveloper MCPサーバーという2つのMCPサーバーを提供しています。
リモートサーバーはMCP対応のAIツールをHubSpot CRMデータに接続し、Developer MCPサーバーは開発者がCLIを通じてHubSpotの開発者プラットフォームと連携するのを支援します。
HubSpot MCPをセットアップするにはどうすればよいですか？
リモートHubSpot MCPサーバーをセットアップするには、HubSpotの「開発」>「MCP認証アプリ」でMCP認証アプリを作成します。
その後、生成されたOAuth認証情報を使用してHubSpot MCPに接続するようMCPクライアントを設定します。クライアントはPKCEを使用したOAuthをサポートする必要があり、リダイレクトURLはHubSpotのアプリ設定と一致する必要があります。
MCPはAPIゲートウェイですか？
MCPは厳密にはAPIゲートウェイではありません。AIツールが標準化された方法で外部ツールを検出して使用できるようにするプロトコルです。HubSpotの場合、リモートMCPサーバーはAIクライアントとHubSpot APIの間の橋渡し役として機能しますが、MCP自体は従来のAPIゲートウェイよりも広い概念です。
HubSpot MCPとHubSpot APIの違いは何ですか？
HubSpot APIは、明示的なエンドポイントとペイロードを使って直接インテグレーションを構築する開発者向けに設計されています。HubSpot MCPはAIツールに自然言語とツールコールを通じてHubSpot機能を使用するための標準化されたインターフェースを提供します。
確定的なバックエンドインテグレーションにはAPIの方が優れている場合があります。エージェント支援のワークフローにはMCPの採用が速い場合があります。
HubSpot MCPはCRMレコードを更新できますか？
はい、リモートHubSpot MCPサーバーは特定のCRMレコードとアクティビティへの書き込みアクセスをサポートしています。HubSpotは連絡先・会社・商談・チケット・明細行・製品・通話・メール・ミーティング・メモ・タスクへの書き込みサポートを文書化しています。
アクセスは依然として認証済みユーザーのHubSpot権限とMCPサーバーを通じて利用可能なツールに依存します。
本記事はDeboshree Banerjeeが執筆しました。DeboshreeはStripeのシニアバックエンドエンジニアであり、以前はGoldman Sachs・Walmartでエンジニアリングロールを、ベンチャー支援のスタートアップでテックリードを担っていました。そのキャリアを通じて、データの耐久性・冗長性・セキュリティ・運用信頼性が重要な大規模分散システムに携わってきました。スケーラビリティ・レジリエンシー・データ保護の観点からエンタープライズソフトウェアを評価してきた経験が、SaaSのバックアップとリカバリープラットフォームの分析に活かされています。
