HubSpot CRM MCPサーバー
HubSpot CRM MCPサーバーを使用すると、LLMは自然な会話を通じてHubSpotと連携し、主要なCRMレコード管理を行うことができます。所有者、パイプラインステージ、フィールドプロパティを解決し、HubSpotインターフェースを直接操作せずに連絡先、会社、取引、チケット、アクティビティタイムラインを管理するツールを提供します。
用途
HubSpot CRM MCPサーバーを使用して、次のアクションを実行します:
- 連絡先、会社、取引、チケットを検索
- 新しい連絡先、会社、取引、チケットを作成、または既存レコードのフィールドを更新
- パイプラインステージに沿って取引とチケットを移動
- 関連レコードのリンクとリンク解除
- メモ、通話、メール、ミーティング、タスクをレコードのアクティビティタイムラインにログ記録
- 連絡先、会社、取引、またはチケットに対してログ記録された最近のアクティビティを確認
- 不要になったレコードをアーカイブ
- レコードまたはアクティビティに割り当てる適切な所有者を解決
- レコードを書き込む前にパイプラインステージとフィールドプロパティを参照
プロンプト例
次のプロンプト例を使用して、HubSpot CRM MCPサーバーツールを呼び出します:
Acme CorpのKiran Patelの連絡先を見つけて。Acme Corp更新用の新しい取引を作成して。この取引をClosed Wonに移動して。この連絡先の電話番号を更新して。Acme Corpとの今の通話をログ記録して。この連絡先をその会社にリンクして。Jade Chenが所有する未完了の取引を表示して。Acme Corpに関連付けられているチケットは何ですか。この取引に割り当てられる利用可能な所有者は誰ですか。営業パイプラインのステージを一覧表示して。
HubSpot CRM MCPサーバーツール
HubSpot CRM MCPサーバーは次のツールを提供します:
| ツール | 説明 |
|---|---|
| search_records | 指定したオブジェクトタイプのCRMレコードを、プロパティフィルター、テキストクエリ、またはその両方を使用して検索します。 |
| get_record | 単一のCRMレコードのフィールドをIDで取得します。 |
| list_records | 指定したオブジェクトタイプの最近のレコードをカーソルページネーションで一覧表示します。 |
| create_record | 指定したオブジェクトタイプとプロパティに基づいて、新しいCRMレコードを作成します。 |
| update_record | 既存のCRMレコードの書き込み可能なプロパティを更新します。 |
| archive_record | CRMレコードをIDでアーカイブします。 |
| create_association | 2つのCRMレコードをデフォルトまたはラベル付きの関連付けでリンクします。 |
| list_associations | 指定したオブジェクトタイプのリンク済みレコードを一覧表示します。 |
| delete_association | 関連付けられた2つのCRMレコードのリンクを解除します。 |
| log_activity | メモ、通話、メール、ミーティング、またはタスクを作成し、レコードに関連付けます。 |
| list_activities | 指定したタイプのレコードの最近のアクティビティを一覧表示します。 |
| list_owners | レコードとアクティビティの帰属に使用するhubspot_owner_idを解決するためにCRM所有者を一覧表示します。 |
| list_pipelines | 取引またはチケットのパイプラインとステージを一覧表示します。 |
| list_properties | CRMオブジェクトタイプのプロパティ(フィールド)定義を一覧表示します。 |
HubSpot CRM MCPサーバーをインストール
構築済みMCPサーバーをプロジェクトにインストールするには、次の手順を完了します:
Workatoアカウントにサインインします。
AI Hub > Enterprise MCPに移動します。
+ Create MCP serverをクリックします。
接続済みアプリを使用して構築済みMCPサーバーを開始するセクションに移動し、使用する構築済みMCPサーバーを選択します。
Use this serverをクリックします。
サーバー名フィールドにMCPサーバーの名前を入力します。
場所ドロップダウンメニューを使用して、MCPサーバーのプロジェクトを選択します。
Connectionsセクションに移動し、アプリアカウントに接続します。
MCPサーバーテンプレートで使用するコネクションタイプを選択します。
- User's connection: MCPサーバーツールは、アプリケーションに接続するユーザーのIDと権限に基づいてアクションを実行します。ユーザーは自分の認証情報で認証し、スキルを実行します。
- Your connection: このオプションでは、レシピビルダーによって確立されたコネクションを使用し、通常のアプリコネクションと同じ原則に従います。
コネクションタイプを選択
検証済みユーザーアクセスの認証要件
OAuth 2.0認可コードグラントを使用するアプリコネクションのみが、ユーザーのコネクションで利用できます。詳細については、検証済みユーザーアクセスを参照してください。
次のセクションで、アプリ固有のコネクション設定手順を完了します。
HubSpot CRMコネクションの設定
HubSpot CRMコネクションの設定手順を表示
APIバージョン
HubSpotコネクターはHubSpot REST API v3を使用します。
WorkatoでHubSpotに接続する方法
OAuth 2.0を使用してHubSpotで認証を行うには、次の手順を実行します。
作成 > コネクションをクリックするか、Cを2回押します。
HubSpotを検索し、アプリとして選択します。
コネクション名フィールドにコネクションの名前を入力します。
Location(場所)ドロップダウンメニューを使用して、コネクションを保存するプロジェクトまたはフォルダを選択します。
任意です。 Advanced settings(詳細設定)セクションに移動し、Workatoに付与するスコープを選択します。デフォルトでは、コネクターはレシピのトリガーとアクションに必要な最小限のスコープセットを要求します。詳細については、使用可能なスコープの完全なリストを参照してください。
任意です。 Custom OAuth profileドロップダウンメニューを使用して、コネクション用のCustom OAuth profilesを選択します。
接続をクリックします。
Workatoを認可する予定のHubSpotアカウントを選択し、Choose Accountをクリックします。
アカウントを選択
HubSpotロール要件
各ツールの利用可否は、接続済みアカウントに付与されたCRMスコープによって異なります。 HubSpotはこのコネクターのユーザーごとの認証をサポートしていないため、すべてのツールは単一の接続済みアカウントで実行されます。 list_ownersツールを使用して所有者を解決し、create_recordまたはupdate_recordで設定できます。必要なスコープなしで行われたリクエストは、部分的な結果ではなく、権限拒否の結果を返します。スコープ要件の完全な一覧については、HubSpot Scopesドキュメントを参照してください。
HubSpot CRM MCPサーバーツールの使用方法
利用可能なツールの詳細については、次のセクションを参照してください:
search_recordsツール
search_recordsツールは、指定したオブジェクトタイプのCRMレコードを、プロパティフィルターやテキストクエリを使用して検索します。 LLMはこのツールを使用して、レコードの読み取り、更新、またはリンクの前に、名前、メール、ドメイン、ステージ、所有者で連絡先、会社、取引、またはチケットを検索します。
質問例:
Acme CorpのKiran Patelの連絡先を見つけて。交渉ステージにある取引を表示して。Jade Chenが所有するチケットを検索して。ドメインがacmecorp.comの会社を見つけて。
get_recordツール
get_recordツールは、単一のCRMレコードのフィールドをそのIDで取得します。 LLMはこのツールを使用して、操作する前にレコードを確認したり、直前に行った書き込みを確認したりします。
質問例:
この連絡先のすべての詳細を表示して。この取引の現在のフィールドは何ですか。今更新した後の取引金額を確認して。チケット4821の詳細を取得して。
list_recordsツール
list_recordsツールは、指定したオブジェクトタイプの最近のレコードをカーソルページネーションで一覧表示します。 LLMはこのツールを使用して、特定の検索条件が指定されていない場合に最近のレコードセットを参照します。
質問例:
最近の取引をいくつか表示して。最近作成された連絡先を一覧表示して。最近のサポートチケットを参照して。会社の次のページを表示して。
create_recordツール
create_recordツールは、指定したオブジェクトタイプとプロパティに基づいて、新しいCRMレコードを作成します。 LLMはこのツールを使用して、会話、ミーティング、またはインバウンドリクエストの後に、新しい連絡先、会社、取引、またはチケットを追加します。
質問例:
Acme CorpのAriel Greenの新しい連絡先を作成して。Jade Chenが所有するAcme Corp更新用の取引を追加して。この問題のサポートチケットを作成して。Acme Corpの新しい会社レコードを追加して。
update_recordツール
update_recordツールは、既存のCRMレコードの書き込み可能なプロパティを更新します。 LLMはこのツールを使用して、フィールドの変更、所有者の再割り当て、または取引やチケットの新しいステージへの移動を行います。
質問例:
この連絡先の電話番号を更新して。この取引をClosed Wonに移動して。このチケットをKiran Patelに再割り当てして。取引金額を$50,000に変更して。
archive_recordツール
archive_recordツールは、CRMレコードをIDでアーカイブします。レコードをアーカイブすると、復元可能なソフト削除が実行されます。 LLMはこのツールを使用して、重複、テスト、またはその他不要な連絡先、会社、取引、チケットをアーカイブします。
質問例:
この重複した連絡先をアーカイブして。このテスト取引をパイプラインから削除して。追跡する必要がなくなったチケットをアーカイブして。この古い会社レコードを削除して。
create_associationツール
create_associationツールは、2つのCRMレコードをデフォルトまたはラベル付きの関連付けでリンクします。 LLMはこのツールを使用して、連絡先、チケット、または取引を会社に接続します。
質問例:
この連絡先をその会社にリンクして。この取引をこれら2つの連絡先に関連付けて。このチケットをAcme Corpに接続して。この連絡先をこの取引の意思決定者としてリンクして。
list_associationsツール
list_associationsツールは、指定したオブジェクトタイプのレコードにリンクされたレコードを一覧表示します。 LLMはこのツールを使用して、関連付けを接続または切断する前に、会社の連絡先、連絡先の取引、または取引のチケットを表示します。
質問例:
この会社にリンクされている連絡先は何ですか。この連絡先に関連付けられている取引を表示して。Acme Corpにリンクされているチケットを一覧表示して。この取引はどの会社に関連付けられていますか。
delete_associationツール
delete_associationツールは、関連付けられた2つのCRMレコードのリンクを解除します。 LLMはこのツールを使用して、どちらのレコードにも影響を与えずに関係を削除します。
質問例:
この連絡先をその会社からリンク解除して。この取引とこの連絡先の関連付けを削除して。このチケットをAcme Corpから切断して。この連絡先をこの取引から外して。
log_activityツール
log_activityツールは、メモ、通話、メール、ミーティング、またはタスクを作成し、レコードに関連付けます。 LLMはこのツールを使用して、通話、メール、またはミーティングの後に、連絡先、会社、取引、またはチケットのタイムラインにやり取りを記録します。
質問例:
Acme Corpとの今の通話をログ記録して。更新に関する話し合いについて、この取引にメモを追加して。明日のKiran Patelとのミーティングをログ記録して。来週この連絡先をフォローアップするタスクを作成して。
list_activitiesツール
list_activitiesツールは、指定したタイプのレコードの最近のアクティビティを一覧表示します。 LLMはこのツールを使用して、連絡先、会社、取引、またはチケットの最近の通話、メモ、メール、ミーティング、タスクを確認します。
質問例:
この連絡先にログ記録された最近の通話を表示して。この取引にはどのメモが追加されていますか。このチケットのタスクを一覧表示して。Acme Corpにはどのミーティングがログ記録されていますか。
list_ownersツール
list_ownersツールは、レコードとアクティビティの帰属に使用するhubspot_owner_idを解決するためにCRM所有者を一覧表示します。 LLMはこのツールを使用して、レコードの作成や更新、またはアクティビティのログ記録時に割り当てる正しい所有者を見つけます。
質問例:
この取引に割り当てられる利用可能な所有者は誰ですか。Jade Chenの所有者IDを見つけて。このアカウント内のすべての所有者を一覧表示して。ariel@example.comに一致する所有者は誰ですか。
list_pipelinesツール
list_pipelinesツールは、取引またはチケットのパイプラインとステージを一覧表示します。 LLMはこのツールを使用して、取引やチケットを作成または新しいステージに移動する前に、有効なステージIDを見つけます。
質問例:
営業パイプラインのステージを一覧表示して。サポートチケットの有効なステージは何ですか。取引パイプラインのステージIDを表示して。このパイプラインでNegotiationの次に来るステージは何ですか。
list_propertiesツール
list_propertiesツールは、CRMオブジェクトタイプのプロパティ(フィールド)定義を一覧表示します。 LLMはこのツールを使用して、レコードを作成または更新する前に、書き込み可能なフィールドと有効な値を見つけます。
質問例:
連絡先にはどのフィールドを設定できますか。取引で利用可能なプロパティを一覧表示して。チケット優先度フィールドの有効な値は何ですか。会社レコードの書き込み可能なフィールドを表示して。
はじめに
MCP serverのツールは、Overviewページのツールセクションで表示および管理できます。ツール管理では、次の機能を利用できます:
ツールを開始する必要があります
LLMは、MCP server connector内のアクティブなツールにのみアクセスできます。
最終更新日: