HubSpot
HubSpot CRMと接続して、連絡先、会社、取引、タスク、製品、ノートなどのCRMデータを照会および管理できます。
主な機能
- CRMオブジェクト(連絡先、会社、取引など)のバッチ照会
- 複数のレコードを一度に作成、更新、削除
- タスク管理
- 製品管理
- ノート管理
- チケット管理
基本情報
認証方式
OAuth 2.0認証を使用します。
認証プロセス
- ユーザー認証リクエスト
- HubSpotでの認証と権限承認
- Access Token発行
- API呼び出し時にAuthorizationヘッダーにBearer Tokenを含める
サポートされるMCPツール
HubSpot MCPは合計50個のツールを提供し、主要なCRMオブジェクトに対するバッチ操作をサポートします。
タスク管理ツール
tasks_batch_create
複数のタスクを一度に作成します。
tasks_batch_read
複数のタスクを一度に照会します。
tasks_batch_update
複数のタスクを一度に更新します。
tasks_batch_archive
複数のタスクを一度にアーカイブ(削除)します。
製品管理ツール
products_batch_create
複数の製品を一度に作成します。
products_batch_read
複数の製品を一度に照会します。
products_batch_update
複数の製品を一度に更新します。
products_batch_archive
複数の製品を一度にアーカイブ(削除)します。
ノート管理ツール
notes_batch_create
複数のノートを一度に作成します。
notes_batch_read
複数のノートを一度に照会します。
notes_batch_update
複数のノートを一度に更新します。
notes_batch_archive
複数のノートを一度にアーカイブ(削除)します。
連絡先管理ツール
contacts_batch_create
複数の連絡先を一度に作成します。
contacts_batch_read
複数の連絡先を一度に照会します。
contacts_batch_update
複数の連絡先を一度に更新します。
contacts_batch_archive
複数の連絡先を一度にアーカイブ(削除)します。
会社管理ツール
companies_batch_create
複数の会社を一度に作成します。
companies_batch_read
複数の会社を一度に照会します。
companies_batch_update
複数の会社を一度に更新します。
companies_batch_archive
複数の会社を一度にアーカイブ(削除)します。
取引管理ツール
deals_batch_create
複数の取引を一度に作成します。
deals_batch_read
複数の取引を一度に照会します。
deals_batch_update
複数の取引を一度に更新します。
deals_batch_archive
複数の取引を一度にアーカイブ(削除)します。
チケット管理ツール
tickets_batch_create
複数のチケットを一度に作成します。
tickets_batch_read
複数のチケットを一度に照会します。
tickets_batch_update
複数のチケットを一度に更新します。
tickets_batch_archive
複数のチケットを一度にアーカイブ(削除)します。
使用例
例えば、
- Promptで「今週中に完了すべきタスクのリストを見せて」と入力すると、
- LLMはMCPを通じて
tasks_batch_readツールを呼び出してタスクリストを照会します。 - そして、Tool呼び出し結果に基づいてチャットで応答します。
OAuth アプリ設定方法
- HubSpot開発者アカウント にログインします。
- Appsメニューに移動します。
- Create appボタンをクリックします。
- アプリ名と説明を入力します。
- Authタブで以下を設定します:
- Redirect URLs: AIPが提供するRedirect URLを入力します。
- Scopes: 必要な権限を選択します(CRMオブジェクトごとのread/write権限)。
- Client IDとClient Secretをコピーします。
- AIPのMCP連携ページでHubSpotを選択し、Connect & Installボタンをクリックします。
- HubSpot認証ページで権限を承認します。
注意事項
- HubSpotのAPI使用制限(Rate Limit)が適用されます。
- バッチ操作は一度に最大100個のレコードを処理できます。
- 削除操作(archive)は元に戻せないため、慎重に使用してください。
- OAuth認証時に必要な権限(Scopes)を正しく設定する必要があります。
- CRMオブジェクトへのアクセス権限は、HubSpotアカウントの権限に応じて制限されます。
Last updated on