HubSpot MCP サーバー
シームレスな HubSpot CRM 統合を実現する強力なモデル コンテキスト プロトコル (MCP) サーバー実装により、AI アシスタントが HubSpot データと対話できるようになります。
概要
この MCP サーバーは、HubSpot CRM API と対話するための包括的なツール セットを提供し、AI アシスタントが次のことを実行できるようにします。
HubSpot CRMで連絡先と企業を作成および管理します
詳細な企業活動履歴とエンゲージメントタイムラインを取得します
HubSpotインスタンス全体の最近のエンゲージメントデータにアクセスします
最近アクティブな企業と連絡先のリストを取得する
AIアシスタントインターフェースを離れずにCRM操作を実行
Related MCP server: HubSpot MCP Server
この MCP サーバーを使用する理由
シームレスなAI統合：AIアシスタントをHubSpot CRMデータに直接接続
簡素化された CRM 操作: 自然言語コマンドを使用して一般的な HubSpot タスクを実行します。
リアルタイムデータアクセス：HubSpotインスタンスから最新情報を取得します
セキュア認証：HubSpotのセキュアAPIトークン認証を使用します
拡張可能な設計: 必要に応じてHubSpot API機能を簡単に追加できます
インストール
構成
サーバーにはHubSpot APIアクセストークンが必要です。以下の方法で取得できます。
HubSpot開発者アカウントにアクセスする
必要なスコープ（連絡先、会社、エンゲージメント）を持つプライベートアプリを作成する
生成されたアクセストークンのコピー
トークンは次の 2 つの方法で提供できます。
環境変数として:
HUBSPOT_ACCESS_TOKEN=your-access-tokenコマンドライン引数として:
npm start -- --access-token=your-access-token
開発の場合は、プロジェクト ルートに.envファイルを作成して環境変数を保存します。
使用法
サーバーの起動
SSEサーバーでの認証の実装
SSEサーバーは認証にmcp-proxy-authパッケージを使用します。認証を実装するには、以下の手順に従います。
パッケージをインストールします。
npm install mcp-proxy-authAUTH_SERVER_URL環境変数を、API キー検証エンドポイントを指すように設定します。export AUTH_SERVER_URL=https://your-auth-server.com/verify認証付きで SSE サーバーを実行します。
npx mcp-proxy-auth node dist/index.jsSSE URL は次の場所で入手できます。
localhost:8080/sse?apiKey=apikey認証用の実際の API キーに
apikey置き換えます。
mcp-proxy-authパッケージは、次の機能を果たすプロキシとして機能します。
SSEサーバーへのリクエストをインターセプトします
認証サーバーに対してAPIキーを検証します
認証されたリクエストのみが SSE エンドポイントに到達できるようにします
AIアシスタントとの統合
このMCPサーバーは、モデルコンテキストプロトコル（MCP）をサポートするAIアシスタントと連携するように設計されています。サーバーが起動すると、互換性のあるAIアシスタントがHubSpot CRMデータを操作するために使用できるツールセットが公開されます。
利用可能なツール
サーバーは、次の強力な HubSpot 統合ツールを公開します。
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" } }
ハブスポット作成会社
重複チェック機能を備えたHubSpotで新しい会社を作成する
パラメータ:
name(文字列、必須): 会社名properties(オブジェクト、オプション): 追加の会社プロパティ
例：
{ "name": "Acme Corporation", "properties": { "domain": "acme.com", "industry": "Technology", "phone": "555-987-6543", "city": "San Francisco", "state": "CA" } }
hubspot_get_company_activity
特定の企業の包括的な活動履歴を取得する
パラメータ:
company_id（文字列、必須）: HubSpotの会社ID
メール、通話、会議、メモ、タスクなどの詳細なエンゲージメントデータを返します
hubspot_get_recent_engagements
すべての連絡先と企業の最近のエンゲージメント活動を取得します
パラメータ:
days（数値、オプション、デフォルト：7）：遡る日数limit（数値、オプション、デフォルト：50）：返されるエンゲージメントの最大数
最近の CRM アクティビティの時系列リストを返します
hubspot_get_active_companies
HubSpotから最近アクティブな企業を取得する
パラメータ:
limit（数値、オプション、デフォルト：10）：返される企業の最大数
最終更新日順に企業を返します
hubspot_get_active_contacts
HubSpotから最近アクティブな連絡先を取得する
パラメータ:
limit（数値、オプション、デフォルト：10）：返される連絡先の最大数
最終更新日順に連絡先を返します
サーバーの拡張
サーバーは簡単に拡張できるように設計されています。HubSpot APIの新しい機能を追加するには、以下の手順に従ってください。
src/hubspot-client.tsのHubSpotClientクラスに新しいメソッドを追加します。src/index.tsのsetupToolHandlersメソッドに新しいツールを登録します。npm run buildでプロジェクトをリビルドします。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
キーワード
HubSpot、CRM、モデルコンテキストプロトコル、MCP、AIアシスタント、TypeScript、API統合、HubSpot API、CRM統合、コンタクト管理、企業管理、エンゲージメントトラッキング、AIツール
This server cannot be installed