HubSpot MCP サーバー

概要

HubSpot CRMとの連携を可能にするモデルコンテキストプロトコル（MCP）サーバー実装。このサーバーにより、AIモデルは標準化されたインターフェースを介してHubSpotのデータやオペレーションと連携できるようになります。

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

コンポーネント

リソース

リソースは実装されていません。結局のところ、必要なのはツールだけです。

プロンプトの例

• LinkedIn プロフィールの Web ページからコピーして Hubspot の連絡先を作成します。
  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
• 会社の最新の活動を入手してください:
  What's happening latestly with my pipeline?

ツール

サーバーは、HubSpot オブジェクトを管理するためのいくつかのツールを提供します。

連絡先管理ツール

• hubspot_create_contact
  • HubSpot で新しい連絡先を作成します（作成前に重複をチェックします）
  • 入力：
    • firstname (文字列): 連絡先の名
    • lastname (文字列): 連絡先の姓
    • email (文字列、オプション): 連絡先のメールアドレス
    • properties (dict, オプション): 追加の連絡先プロパティ
      • 例: {"phone": "123456789", "company": "HubSpot"}
  • 行動：
    • 同じ名と姓を持つ既存の連絡先をチェックします
    • プロパティにcompanyが指定されている場合は、同じ会社との一致もチェックします
    • 一致するものが見つかった場合、既存の連絡先の詳細を返します
    • 一致するものが見つからない場合にのみ新しい連絡先を作成します

企業管理ツール

• hubspot_create_company
  • HubSpot で新しい会社を作成します（作成前に重複をチェックします）
  • 入力：
    • name (文字列): 会社名
    • properties (dict, オプション): 追加の会社プロパティ
      • 例: {"domain": "example.com", "industry": "Technology"}
  • 行動：
    • 同じ名前の既存の会社をチェックします
    • 一致するものが見つかった場合、既存の会社の詳細を返します
    • 一致するものが見つからない場合にのみ新しい会社を作成します
• hubspot_get_company_activity
  • 特定の企業の活動履歴を取得する
  • 入力：
    • company_id (文字列): HubSpot の会社 ID
  • 戻り値: アクティビティオブジェクトの配列

エンゲージメントツール

• hubspot_get_recent_engagements
  • すべての連絡先と企業の最近のエンゲージメント活動を取得します
  • 入力：
    • days （整数、オプション）：遡る日数（デフォルト：7）
    • limit （整数、オプション）：返されるエンゲージメントの最大数（デフォルト：50）
  • 戻り値: 完全なメタデータを含むエンゲージメント オブジェクトの配列
• hubspot_get_recent_companies
  • HubSpotから最近アクティブな企業を取得する
  • 入力：
    • limit （整数、オプション）：返される企業の最大数（デフォルト：10）
  • 戻り値: 完全なメタデータを含む会社オブジェクトの配列
• hubspot_get_recent_contacts
  • HubSpotから最近アクティブな連絡先を取得する
  • 入力：
    • limit （整数、オプション）：返される連絡先の最大数（デフォルト：10）
  • 戻り値: 完全なメタデータを含む連絡先オブジェクトの配列

設定

Smithery経由でインストール

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

前提条件

HubSpotアクセストークンが必要です。以下の方法で取得できます。

1. HubSpotアカウントでプライベートアプリを作成する： HubSpotプライベートアプリガイドに従ってください
   • HubSpotアカウント設定に移動します
   • 「統合」>「プライベートアプリ」に移動します
   • 「プライベートアプリを作成」をクリックします
   • 基本情報を入力してください:
     • アプリに名前を付ける
     • 説明を追加
     • ロゴをアップロード（オプション）
   • 必要なスコープを定義します。
     • チケット
     • crm.objects.contacts.write
     • crm.objects.contacts.sensitive.read
     • crm.objects.companies.sensitive.read
     • 営業メールを読む
     • crm.objects.deals.sensitive.read
     • crm.objects.companies.write
     • crm.objects.companies.read
     • crm.objects.deals.read
     • crm.objects.deals.write
     • crm.objects.contacts.read
   • アプリを確認して作成する
   • 生成されたアクセストークンをコピーする

注意: アクセス トークンは安全な状態に保ってください。バージョン管理にコミットしないでください。

Dockerのインストール

イメージはローカルでビルドすることも、Docker Hubからプルすることもできます。このイメージはLinuxプラットフォーム用にビルドされています。

サポートされているプラットフォーム

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

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

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

コンテナを実行します。

アクセス トークンをコマンドライン引数として直接渡すこともできます。

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

複数のプラットフォーム向けにDockerイメージを公開するには、 docker buildxコマンドを使用します。以下の手順に従ってください。

1. 新しいビルダー インスタンスを作成します(まだ作成していない場合)。
   docker buildx create --use
2. 複数のプラットフォーム用のイメージをビルドしてプッシュします。
   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .
3. 指定されたプラットフォームでイメージが使用可能であることを確認します。
   docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Claude Desktopでの使用

Smithery経由でインストール

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

Dockerの使用

コマンドライン引数を使用することもできます。

発達

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

ライセンス

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