HubSpot MCP Server

HubSpot MCP Server

HubSpot MCPサーバーは、AIエージェントとHubSpot CRMデータのシームレスなやり取りを可能にするベータ版の統合です。標準化されたモデルコンテキストプロトコルを使用しています。これにより、AIベースのクライアントは、HubSpotでの複雑なCRM操作を実行し、インサイトを取得し、アクションを自動化できます。すべて一貫した安全なインターフェースを通じて行われます。

Author: hubspot


プロトコルを表示

HubSpot MCPサーバーとは？

HubSpot MCPサーバーは、HubSpot CRM機能を標準化されたMCPツールとして公開する軽量サーバーアプリケーションです。この統合により、Claude Desktop、Cursor、その他のモデルコンテキストプロトコルに対応するクライアントが、安全にHubSpotデータにアクセス、クエリ、変更できます。手動のAPI統合やHubSpotのAPIの詳細を学ぶ必要はありません。複雑なCRM操作をユーザーフレンドリーなコマンドに抽象化し、AI駆動のワークフローやエージェント自動化を実現します。

HubSpot MCPサーバーの設定方法

  1. NodeとNPMをインストール: nodejs.org からNode.jsとnpmをダウンロードしてインストールします。
  2. プライベートHubSpotアプリを作成:
    • HubSpotダッシュボードにアクセス: 設定 > 統合 > プライベートアプリ。
    • 「プライベートアプリを作成」をクリックし、アプリの名前を設定し、必要なスコープを設定して、生成されたアクセストークンをコピーします。
  3. MCPクライアントを設定:
    • Claude Desktopの場合:
      • アクセストークンを使用してHubSpotサーバーの設定をClaudeの設定ファイル（claude_desktop_config.json）に追加し、アプリを再起動します。
    • Cursorの場合:
      • プロジェクトディレクトリの.cursor/mcp.jsonに設定を追加します。
    • その他のMCPクライアントについては、外部MCPサーバーの設定手順に従います。
  4. 環境変数: PRIVATE_APP_ACCESS_TOKENが正しく設定されていることを確認します。

HubSpot MCPサーバーの使い方

  1. サーバーを設定した後、MCPクライアント（例えば、Claude DesktopやCursor）を再起動します。
  2. AIクライアントから直接HubSpot専用ツールにアクセスできます。「Acme社の最新の更新を取得」や「私のHubSpotアカウントに新しい連絡先を作成」などのプロンプトを使用します。
  3. AIエージェントはMCPツールを利用してCRM操作を実行し、インサイトを取得し、レコードを更新します。
  4. 設定の問題が発生した場合は、該当のドキュメントやトラブルシューティングページを参照してください。

主な機能

  • 統一されたアクセス: 手動のAPI管理なしで、MCP対応クライアントからHubSpotに接続。
  • 幅広い機能: レコードの読み取りや更新、アソシエーション、ワークフロー、エンゲージメントの管理まで、さまざまなCRMアクションを実行可能。
  • 安全で柔軟: プライベートアプリのアクセストークンを使用して安全に動作し、生のHubSpotの資格情報を露出する必要がありません。
  • 拡張性: HubSpot CRMワークフローにマップされたMCPツールの拡充に対応。
  • フィードバックサポート: ツールの改善や問題報告のためのフィードバックリンクを即座に生成可能。

ユースケース

  • CRMデータインサイト: ビジネスインテリジェンスのために、取引、チケット、会社のインタラクションを要約します。
  • 連絡先と取引管理: 連絡先、企業、取引、チケットの作成、更新、アソシエーションを自動化します。
  • アクティビティトラッキング: ノートやタスクを追加し、CRM内での期限切れのアクションを追跡します。
  • ワークフロー分析: HubSpotのワークフロー、登録、スケジュールを取得して分析します。
  • カスタムプロパティ管理: CRMオブジェクトに対してカスタムプロパティをリスト、作成、更新できます。

FAQ

Q1: MCPサーバーを使用するためには、HubSpotプライベートアプリにどのような権限が必要ですか？
A: 初期設定では、読み取り専用のスコープから始めることをお勧めします。使用を拡大する際には、必要な操作に応じたスコープのみを付与してください（例: CRMオブジェクトの読み書き、エンゲージメントアクセス、プロパティ管理）。

Q2: MCPサーバーを使用しているときにHubSpotデータは安全ですか？
A: はい。MCPサーバーは完全にあなたのインフラ内で動作し、設定したプライベートアプリのアクセストークンのみを使用します。HubSpotの資格情報や敏感なデータは設定以外には保存されたり公開されたりしません。

Q3: 複数のMCPクライアントアプリケーションでHubSpot MCPサーバーを使用できますか？
A: はい、サーバー設定をClaude DesktopやCursorなどの任意のMCP対応クライアントに追加し、各クライアントからHubSpotツールにアクセスできます。

Q4: MCPツールに関するフィードバックを提供したり、問題を報告するにはどうすればよいですか？
A: hubspot-generate-feedback-linkツールを使用してフィードバックURLを生成するか、MCPクライアント内の専用プロンプトを使用してください。

Q5: このサーバーを使ってAIエージェントでどのようなアクションを自動化できますか？
A: バルクレコードの作成や更新から、レポートの生成、アソシエーションの管理、エンゲージメントの追跡まで、すべて自然言語のプロンプトで自動化できます。