mcpField
H
hubspot

hubspot

github.com/openaiマーケティング・グロース56040 回インストール4 週間前に更新
リポジトリ

hubspot について

営業チーム向けの HubSpot ワークフロースキルです。根拠のある CRM 情報の取得や、確認済みのレコード変更を支援し、対象の特定、限定的な読み取り、明示的な承認、結果確認を重視します。

主な機能

  1. 01HubSpot のアクセスとレコード確認
  2. 02プロパティと列挙値の調査
  3. 03CRM レコードと関連情報の読み取り
  4. 04承認済み変更の下書きと検証
  5. 05コネクターの操作範囲を遵守

活用シーン

  1. 01営業対応前の取引や連絡先の確認
  2. 02プロパティや関連付けの変更案作成
  3. 03類似する CRM レコードの判別

MCP 対応

公開されている HubSpot コネクターを使い、ユーザー情報、プロパティの調査、CRM の検索・読み取り、確認済みの書き込みを行います。利用可能な操作は実際のコネクターの範囲に依存します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openai/role-specific-plugins --skill hubspot

インストール後、Claude Code で/hubspotを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

HubSpot ユーザーガイド

ビジネスタスクについては周囲の Sales ワークフローを信頼できる情報源として維持しながら、信頼できる HubSpot のコンテキスト、または安全に確認した HubSpot のアクションを準備します。

共通スキルの指示

必須：まだコンテキストに含まれていない場合は、plugins/sales/skills/index/SKILL.md## Cross-Skill Best Practices を読み、厳密に従ってください。

HubSpot 操作の優先順位

依頼された HubSpot の作業やレコードが曖昧な場合は、次の優先順位に従ってください。

  1. 明示的なユーザーの依頼、指定されたレコード、HubSpot ID、会社、商談、コンタクト、チケット、または明示されたアクション
  2. 実行中の Sales ワークフローに必要な読み取り専用の CRM コンテキスト
  3. ユーザーの言葉とビジネスコンテキストから特定された、正確なレコードまたは確度の高い候補
  4. 依頼に回答するために必要な最小限のプロパティ、関連付け、アクティビティコンテキスト、または結果ページ
  5. 提案する HubSpot の変更を確認済みの下書き
  6. 明示的に承認された、サポート対象の HubSpot 書き込みと、その後の検証

候補となるレコードの中から黙って選んだり、読み取りを暗黙に書き込みへ拡大したり、確認を求めたことを変更の承認とみなしたりしないでください。

主な依存カテゴリ

このワークフローでは特に重要です。品質を高めるために、必要に応じてほかのデータソースも最善の判断で利用してください。

  • ~~CRM、特に公開されている HubSpot コネクター。HubSpot が提供する識別情報、レコード、プロパティ、関連付け、リンク、および承認済みの書き込みに使用します
  • 親となる Sales ワークフロー。HubSpot が管理していないカレンダー、会議の文字起こし、メール、内部メッセージ、ナレッジとファイル、または Sales Intelligence のコンテキストに使用します
  • コネクターにアクセスできない場合、またはレコードの特定に追加情報が必要な場合に使用する、ユーザー提供のレコード ID、名前、エクスポートデータ、プロパティ値、およびビジネスコンテキスト

HubSpot の情報が欠落している、利用できない、古い、曖昧である、または公開されているコネクターの機能によって制限されている場合は、その旨を伝え、回答には HubSpot の裏付けがないと明記してください。

ワークフローのガイダンス

HubSpot 固有の次の手順は、インデックススキルの既定のワークフローより優先されます。

    1. アクセス権と対象を特定する
    • まず get_user_details を使用して、接続されているポータルと、公開されているオブジェクトの読み取り・書き込み可否を確認します。
    • ユーザーが読み取り、下書き、承認済みの書き込みのどれを希望しているかを特定します。回答に影響する場合は、オブジェクトの種類、担当者またはチーム、パイプライン、期間、ステージ、正確なレコードも特定します。
    • レコードが曖昧な場合は、範囲を絞った最小限の候補検索を行い、要約や書き込みに使用する前にユーザーに選択してもらいます。
    1. プロパティとレコードを調べる
    • フィールドが不明な場合は、search_properties を使用し、絞り込んだキーワードを最大5つ指定します。列挙値と書き込み可能なプロパティは get_properties で確認します。
    • 検索、件数、フィルター、ページネーション、関連付けには search_crm_objects を使用します。ID がわかっている場合は get_crm_objects を使用します。非推奨の search または fetch は使用しないでください。
    • 営業上の判断に影響するプロパティと関連付けだけを取得します。フィルター、合計件数、ページまたはサンプルの上限、および分析がサンプルに基づくかどうかを明記してください。
    1. 下書き、承認、検証を行う
    • 変更を提案する場合は、manage_crm_objects を呼び出す前に、フィールド単位で正確な下書きを提示します。
    • ユーザーが確認済みの変更または一括変更を明示的に承認した後にのみ書き込みます。一括処理は最大10件のオブジェクトとし、関連付けは別途確認します。
    • 確認済みの一括変更に対する承認は、その一括変更のみに適用されます。包括的な確認省略を提案してはいけません。
    • 書き込み結果で処理の成否を確認できない場合は、応答を調べ、範囲を絞った読み取りで検証します。

HubSpot のルール

  • 曖昧な名前のみの一致よりも、正確な ID、ドメイン、メールアドレス、氏名と会社名の組み合わせを優先してください。
  • プロパティまたは列挙値を使って検索や書き込みを行う前に、プロパティのラベル、内部名、列挙値、書き込み可能かどうかを確認してください。推測で補わないでください。
  • HubSpot が管理するアカウント、コンタクト、取引、チケット、担当者、パイプライン、アクティビティの情報については、HubSpot を CRM の正としてください。エンリッチメントやウェブ上の情報で CRM の正しい情報を上書きしないでください。
  • 利用できる場合は、コネクターから返されたクリック可能な URL、または信頼できる HubSpot レコード URL を UTM パラメーター付きで含めてください。
  • 推測したデータを書き込んだり、明確な同意なくユーザーが入力したコンテキストを上書きしたり、明示的な承認なく関連付けを変更したりしないでください。
  • 稼働中のコネクターで公開されていないオブジェクト、プロパティ、ページネーションの動作、一括処理数、書き込みに対応していると示唆しないでください。

コネクターの境界

実際に公開されている HubSpot の機能のみを使用してください。

  • ID とアクセス：get_user_details
  • プロパティの確認：search_properties、get_properties
  • レコードの検索と読み取り：search_crm_objects、get_crm_objects
  • 確認済みの書き込み：manage_crm_objects

未対応の広範なエクスポート、削除、マージ、重複排除、任意の自動化、または非公開のオブジェクト操作を求められた場合は、利用できない機能を明示し、範囲を絞った読み取り、下書き、または別の承認済みソースを提案してください。

モード

1. HubSpot の読み取り
  • 会社、取引、コンタクト、チケット、担当者、アクティビティ、プロパティ、または関連付けのコンテキストに使用します。
  • 対象を特定し、判断に必要なフィールドのみを取得して、曖昧さや不足している情報を明示してください。
出力形式
# [HubSpot のレコードまたはコンテキスト]

## 概要

- [信頼できるリンク付きの最重要 CRM 情報]
- [現在の取引、会社、コンタクト、アクティビティ、または関連付けに関する情報]
- [リスク、不足しているプロパティ、曖昧さ、または情報源の不足]

---

{ [制限事項と改善](../index/SKILL.md#limitations-and-improvements) の指示と出力形式／条件に従ってください }

{ [次のステップ](../index/SKILL.md#4-next-steps) の指示と出力形式／条件に従ってください }
2. HubSpot 更新の下書き
  • ユーザーがメモ、プロパティ変更、関連付け、作成、または更新の準備を依頼したものの、書き込みを承認していない場合に使用します。
  • 現在の値と提案する値を分け、正確な対象を明示してください。
出力形式
# HubSpot 更新の提案

**対象：** [レコード名、種類、信頼できるリンクまたは ID]

| プロパティ／関連付け | 現在の値 | 提案する値 | 理由／情報源 |
| --- | --- | --- | --- |
| [ラベル] | [現在の値または不明] | [提案する値] | [根拠のある理由＋リンク] |

## 書き込み前の確認事項

- [不足している入力、関連付けの確認、検証上のリスク、または必要な承認]

---

{ [制限事項と改善](../index/SKILL.md#limitations-and-improvements) の指示と出力形式／条件に従ってください }

{ [次のステップ](../index/SKILL.md#4-next-steps) の指示と出力形式／条件に従ってください }
3. 承認済みの HubSpot 書き込み
  • 正確に確認済みのオブジェクトまたは一括処理に対する明示的な承認を得た後にのみ使用します。
  • 書き込み結果が不明確な場合は、完了を報告する前に検証してください。
出力形式
# HubSpot を更新しました

**レコード：** [名前、種類、信頼できるリンクまたは ID]

- **変更した項目：** [プロパティまたは関連付け]
- **結果：** [検証済みの結果]
- **変更していない項目：** [未対応またはスキップした項目]

---

{ [制限事項と改善](../index/SKILL.md#limitations-and-improvements) の指示と出力形式／条件に従ってください }

{ [次のステップ](../index/SKILL.md#4-next-steps) の指示と出力形式／条件に従ってください }

コメント

Markdown 対応