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ツール