HubSpot MCP Server

HubSpot MCP サーバー

概要

このプロジェクトでは、HubSpot CRMと連携し、一元化された共有スペース機能を備えたモデルコンテキストプロトコル（MCP）サーバーを実装します。このサーバーにより、AIモデルは標準化されたインターフェースを介してHubSpotのデータやオペレーションと連携できるようになり、チーム間で重要な会話の要約をリアルタイムで共有できるようになります。

モデル コンテキスト プロトコルとその動作の詳細については、Anthropic の MCP ドキュメントを参照してください。

コンポーネント

リソース

リソースは実装されていません。最終的には、システムはツールによって駆動されます。

プロンプトの例

LinkedIn プロフィールのウェブページからコピーして HubSpot の連絡先を作成します。

会社の最新の活動を入手してください:

共有スペースの例:

会議後、AI コマンド ボックスで「会社の共有スペースでの会話の概要を共有しますか? (はい/いいえ)」というプロンプトが表示されます。確認すると、会話の概要が一元的に保存され、社内の承認されたすべてのマネージャーがアクセスできるようになります。

ツール

サーバーは、新しい共有スペース ツールとともに、HubSpot オブジェクトを管理するためのいくつかのツールを提供します。

連絡先管理ツール

• hubspot_create_contact
  • HubSpot で新しい連絡先を作成します（重複チェック付き）。
  • 入力:
    • 名（文字列）
    • 姓（文字列）
    • メール（文字列、オプション）
    • プロパティ（辞書、オプション、例：{"phone": "123456789", "company": "HubSpot"}）

企業管理ツール

• hubspot_create_company
  • HubSpot で新しい会社を作成します（重複チェック付き）。
  • 入力:
    • 名前（文字列）
    • プロパティ（辞書、オプション）
• hubspot_get_company_activity
  • 特定の会社のアクティビティ履歴を取得します。
  • 入力：
    • 会社ID（文字列）

エンゲージメントツール

• hubspot_get_recent_engagements
  • 最近のエンゲージメント アクティビティを取得します。
  • 入力:
    • 日数（整数、デフォルトは7）
    • 制限（整数、デフォルトは50）
• hubspot_get_recent_companies
  • 最近アクティブになった企業を取得します。
  • 入力：
    • 制限（整数、デフォルトは10）
• hubspot_get_recent_contacts
  • 最近アクティブだった連絡先を取得します。
  • 入力：
    • 制限（整数、デフォルトは10）

共有スペースツール

• create_shared_summary
  • 共有スペースに新しい会話の概要を作成します。
  • 入力:
    • user_id (文字列、ユーザーのメールアドレス/ID)
    • 会社ID（文字列）
    • 概要（文字列）
• get_shared_summaries
  • 特定の会社のすべての会話の概要を取得します。
  • 入力:
    • user_id (文字列)
    • 会社ID（文字列）

これらの共有スペース ツールを使用すると、権限のあるマネージャーが会議の概要を共有できるため、リアルタイムのチーム コラボレーションと重要な洞察への集中アクセスが可能になります。

設定

Smithery経由でインストール

Smithery 経由で Claude Desktop 用の buryhuang/mcp-hubspot を自動的にインストールするには:

前提条件

HubSpotアクセストークンが必要です。HubSpotアカウントでプライベートアプリを作成して取得してください（HubSpotプライベートアプリガイドをご覧ください）。トークンは安全に保管してください。

Dockerのインストール

オプション1: Docker Hubからプルする

**オプション2:**ローカルで構築する

コンテナを実行します。

または、トークンを引数として渡します。

クロスプラットフォームパブリッシング

新しいビルダー インスタンスを作成します。

複数のプラットフォーム向けにビルドしてプッシュ:

イメージを確認します。

Claude Desktopでの使用

Smithery経由でインストール

Dockerの使用

またはコマンドライン引数を使用する:

発達

開発環境をセットアップするには:

共有スペースの統合

共有スペース機能は別のモジュール（shared_space.py）に実装されています。このモジュールは以下の機能を提供します。

• 動的なユーザー ロールを読み込みます (外部 JSON ファイルまたはデータベースから)。
• 会話の概要の CRUD エンドポイント (create_summary、get_summaries、update_summary、delete_summary) を実装します。
• リアルタイム通知プレースホルダーをトリガーします (後で SSE または WebSocket と統合できます)。

メインの server.py ファイルはこれらの関数をインポートし、新しい MCP ツール (create_shared_summary および get_shared_summaries) として登録します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

この更新された README では、HubSpot MCP 統合を使用した追加の共有スペース機能が反映され、システムの構造と使用方法が説明されています。