HubSpot MCP サーバー

シームレスな HubSpot CRM 統合を実現する強力なモデル コンテキスト プロトコル (MCP) サーバー実装により、AI アシスタントが HubSpot データと対話できるようになります。

概要

この MCP サーバーは、HubSpot CRM API と対話するための包括的なツール セットを提供し、AI アシスタントが次のことを実行できるようにします。

• HubSpot CRMで連絡先と企業を作成および管理します

• 詳細な企業活動履歴とエンゲージメントタイムラインを取得します

• HubSpotインスタンス全体の最近のエンゲージメントデータにアクセスします

• 最近アクティブな企業と連絡先のリストを取得する

• AIアシスタントインターフェースを離れずにCRM操作を実行

この MCP サーバーを使用する理由

• シームレスなAI統合：AIアシスタントをHubSpot CRMデータに直接接続

• 簡素化された CRM 操作: 自然言語コマンドを使用して一般的な HubSpot タスクを実行します。

• リアルタイムデータアクセス：HubSpotインスタンスから最新情報を取得します

• セキュア認証：HubSpotのセキュアAPIトークン認証を使用します

• 拡張可能な設計: 必要に応じてHubSpot API機能を簡単に追加できます

インストール

構成

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

1. HubSpot開発者アカウントにアクセスする

2. 必要なスコープ（連絡先、会社、エンゲージメント）を持つプライベートアプリを作成する

3. 生成されたアクセストークンのコピー

トークンは次の 2 つの方法で提供できます。

1. 環境変数として:

   HUBSPOT_ACCESS_TOKEN=your-access-token

2. コマンドライン引数として:

   npm start -- --access-token=your-access-token

開発の場合は、プロジェクト ルートに.envファイルを作成して環境変数を保存します。

使用法

サーバーの起動

SSEサーバーでの認証の実装

SSEサーバーは認証にmcp-proxy-authパッケージを使用します。認証を実装するには、以下の手順に従います。

1. パッケージをインストールします。

   npm install mcp-proxy-auth

2. AUTH_SERVER_URL環境変数を、API キー検証エンドポイントを指すように設定します。

   export AUTH_SERVER_URL=https://your-auth-server.com/verify

3. 認証付きで SSE サーバーを実行します。

   npx mcp-proxy-auth node dist/index.js

4. SSE URL は次の場所で入手できます。

   localhost:8080/sse?apiKey=apikey

   認証用の実際の API キーにapikey置き換えます。

mcp-proxy-authパッケージは、次の機能を果たすプロキシとして機能します。

• SSEサーバーへのリクエストをインターセプトします

• 認証サーバーに対してAPIキーを検証します

• 認証されたリクエストのみが SSE エンドポイントに到達できるようにします

AIアシスタントとの統合

このMCPサーバーは、モデルコンテキストプロトコル（MCP）をサポートするAIアシスタントと連携するように設計されています。サーバーが起動すると、互換性のあるAIアシスタントがHubSpot CRMデータを操作するために使用できるツールセットが公開されます。

利用可能なツール

サーバーは、次の強力な HubSpot 統合ツールを公開します。

1. hubspot_create_contact

   • 重複チェック機能を使ってHubSpotで新しい連絡先を作成する

   • パラメータ:

     • firstname (文字列、必須): 連絡先の名

     • lastname (文字列、必須): 連絡先の姓

     • email (文字列、オプション): 連絡先のメールアドレス

     • properties (オブジェクト、オプション): 会社、電話番号などの追加の連絡先プロパティ。

   • 例：

     { "firstname": "John", "lastname": "Doe", "email": "john.doe@example.com", "properties": { "company": "Acme Inc", "phone": "555-123-4567", "jobtitle": "Software Engineer" } }

2. ハブスポット作成会社

   • 重複チェック機能を備えたHubSpotで新しい会社を作成する

   • パラメータ:

     • name (文字列、必須): 会社名

     • properties (オブジェクト、オプション): 追加の会社プロパティ

   • 例：

     { "name": "Acme Corporation", "properties": { "domain": "acme.com", "industry": "Technology", "phone": "555-987-6543", "city": "San Francisco", "state": "CA" } }

3. hubspot_get_company_activity

   • 特定の企業の包括的な活動履歴を取得する

   • パラメータ:

     • company_id （文字列、必須）: HubSpotの会社ID

   • メール、通話、会議、メモ、タスクなどの詳細なエンゲージメントデータを返します

4. hubspot_get_recent_engagements

   • すべての連絡先と企業の最近のエンゲージメント活動を取得します

   • パラメータ:

     • days （数値、オプション、デフォルト：7）：遡る日数

     • limit （数値、オプション、デフォルト：50）：返されるエンゲージメントの最大数

   • 最近の CRM アクティビティの時系列リストを返します

5. hubspot_get_active_companies

   • HubSpotから最近アクティブな企業を取得する

   • パラメータ:

     • limit （数値、オプション、デフォルト：10）：返される企業の最大数

   • 最終更新日順に企業を返します

6. hubspot_get_active_contacts

   • HubSpotから最近アクティブな連絡先を取得する

   • パラメータ:

     • limit （数値、オプション、デフォルト：10）：返される連絡先の最大数

   • 最終更新日順に連絡先を返します

サーバーの拡張

サーバーは簡単に拡張できるように設計されています。HubSpot APIの新しい機能を追加するには、以下の手順に従ってください。

1. src/hubspot-client.tsのHubSpotClientクラスに新しいメソッドを追加します。

2. src/index.tsのsetupToolHandlersメソッドに新しいツールを登録します。

3. npm run buildでプロジェクトをリビルドします。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

キーワード

HubSpot、CRM、モデルコンテキストプロトコル、MCP、AIアシスタント、TypeScript、API統合、HubSpot API、CRM統合、コンタクト管理、企業管理、エンゲージメントトラッキング、AIツール