HubSpot MCP サーバー

概要

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

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

コンポーネント

リソース

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

プロンプトの例

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

# Example YAML prompt
- Create HubSpot contacts and companies from following:
  - John Doe
  - Software Engineer at Tech Corp
  - San Francisco Bay Area • 500+ connections

Experience:
- Tech Corp
  - Software Engineer
    - Jan 2020 - Present · 4 yrs
    - San Francisco, California

- Previous Company Inc.
  - Senior Developer
    - 2018 - 2020 · 2 yrs

Education:
- University of California, Berkeley
  - Computer Science, BS
    - 2014 - 2018

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

# Example VB.NET prompt
- What's happening latestly with my pipeline?

共有スペースの例:

会議後、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 を自動的にインストールするには:

npx -y @smithery/cli install buryhuang/mcp-hubspot --client claude

前提条件

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

Dockerのインストール

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

docker pull buryhuang/mcp-hubspot:latest

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

docker build -t mcp-hubspot .

コンテナを実行します。

docker run -e HUBSPOT_ACCESS_TOKEN=your_access_token_here buryhuang/mcp-hubspot:latest

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

docker run buryhuang/mcp-hubspot:latest --access-token your_access_token_here

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

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

docker buildx create --use

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

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .

イメージを確認します。

docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Claude Desktopでの使用

Smithery経由でインストール

npx -y @smithery/cli@latest install mcp-hubspot --client claude

Dockerの使用

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "your_access_token_here"
      ]
    }
  }
}

発達

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

pip install -e .

共有スペースの統合

共有スペース機能は別のモジュール（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 統合を使用した追加の共有スペース機能が反映され、システムの構造と使用方法が説明されています。

HubSpot MCP Server

Integrations