インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、HubSpot をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI に HubSpot CRM で作業させます。コンタクト、会社、取引、チケットの検索と更新、レコード同士の関連付けの確認、パイプラインと担当者の確認、メモとタスクの記録ができます。1 つのアカウントを、自分で作成するサービスキーで接続します。
こう聞いてみよう
HubSpot のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → HubSpot をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
HubSpot + Microsoft Copilot
AI に HubSpot CRM で作業させます。コンタクト、会社、取引、チケットの検索と更新、レコード同士の関連付けの確認、パイプラインと担当者の確認、メモとタスクの記録ができます。1 つのアカウントを、自分で作成するサービスキーで接続します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
HUBSPOT_ACCESS_TOKEN
ステップ 1 — 認証情報を取得
- HubSpot で左サイドバーの Development を開き、Keys → Service keys に進んで Create service key をクリックします。スーパー管理者か、Developer tools へのアクセス権を持つユーザーである必要があります。
- キーに名前を付け（例: 「AnythingMCP」）、Add new scope をクリックして下記のスコープにチェックを入れ、Update、Create の順にクリックします。
- キーを開き、Show、Copy の順にクリックします。サービスキーは
pat-で始まります（例:pat-eu1-...）。 - キーを、Bearer という語を付けずに
HUBSPOT_ACCESS_TOKENに貼り付けて、コネクターをインストールします。 - まず
hubspot_get_accountを実行します。キーがどの HubSpot アカウント（Hub ID）のものか、そのタイムゾーンと通貨を確認できます。
従来のプライベートアプリ: 古いアカウントには、プライベートアプリ（Development → Legacy apps、以前は Settings → Integrations → Private Apps）がまだ残っている場合があります。そのアクセストークンも同じように使えます。HUBSPOT_ACCESS_TOKEN に貼り付けてください。
スコープ:
- 読み取り:
crm.objects.contacts.read（メモとタスクも対象）、crm.objects.companies.read、crm.objects.deals.read、crm.objects.tickets.read、crm.objects.owners.read。 - 書き込み:
crm.objects.contacts.write（メモとタスクにも必要）、crm.objects.companies.write、crm.objects.deals.write、crm.objects.tickets.write。
読み取り専用の設定: キーには読み取りスコープだけを付与し、hubspot_create_object、hubspot_update_object、hubspot_associate_records、hubspot_create_note、hubspot_create_task を無効にします。
インストール時はオフ: hubspot_archive_object。AI にレコードを削除させる場合だけオンにしてください。アーカイブしたレコードは HubSpot のゴミ箱に移り、90 日間はそこから復元できます。
データプライバシー設定: HubSpot アカウントでデータプライバシー（GDPR）の設定がオンになっている場合、HubSpot は新しいコンタクトごとに処理の法的根拠、つまり hs_legal_basis プロパティを必須にします。コンタクトを作成するときにどの法的根拠を使うかを AI に伝えてください。指定がないと、HubSpot は「The following required properties were missing」と応答します。
制限: HubSpot で利用できるのは、Free と Starter ではキーごとに 10 秒あたり 100 リクエスト（Professional と Enterprise ではそれ以上）、アカウントごとに 1 日 250,000 リクエスト、検索は 1 秒あたり 5 回までです。上限を超えると HubSpot は 429 を返します。数秒待ってからやり直してください。
よくあるエラー: 401 は、キーが間違っているか、期限切れか、ローテーションされたことを示します。キーをもう一度コピーしてください。403 では不足しているスコープが示されます。Edit からキーに追加してください。404 は、ID またはオブジェクトの種類が間違っていることを示します。400 VALIDATION_ERROR では、誤っているプロパティやフィルターが示されます。たとえば、存在しないプロパティ名や、ドロップダウンの選択肢にない値などです。
このコネクターは、マーケティングメール、フォーム、リスト、ワークフロー、ファイル、見積もりと商品項目の価格設定、レコードの統合、一括書き込みは扱いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
HubSpotのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
hubspot_list_owners | List the HubSpot users who can own records (owners): owner id, user id, email, first and last name, teams and whether archived |
hubspot_get_account | Get the HubSpot account the token belongs to: portal id (Hub ID), account type, time zone and UTC offset, company currency and additional… |
hubspot_search_objects | Search CRM records of one object type (contacts, companies, deals, tickets, notes, tasks, ...) by free text and/or property filters, with… |
hubspot_list_objects | List CRM records of one object type page by page, oldest id first, with the chosen properties and optionally the ids of associated records |
hubspot_get_object | Get one CRM record by id (or by a unique property such as a contact's email with id_property), with the chosen properties, optional… |
hubspot_create_object | Create a CRM record (contact, company, deal, ticket, ...) with property values, optionally associated with existing records |
hubspot_update_object | Change property values of one CRM record; only the given properties change, and an empty string clears a value |
hubspot_archive_object | Archive (delete) one CRM record: it moves to the recycling bin, where it can be restored for 90 days |
hubspot_get_associations | List the records of one type associated with a record, with their association types and labels, e.g. all deals of a company or all contacts… |
hubspot_associate_records | Link two existing records with HubSpot's default (unlabeled) association, e.g. a contact to a company or a deal to a contact |
hubspot_list_pipelines | List the pipelines of deals or tickets with their stages: pipeline id and label, and per stage its id, label, display order and metadata… |
hubspot_list_properties | List the properties of an object type, default and custom: internal name, label, type, field type, group, description, whether read-only… |
hubspot_create_note | Add a note to the CRM timeline, associated with contacts, companies, deals or tickets |
hubspot_create_task | Create a task (to-do, call or email reminder) with a due date, optionally assigned to an owner and associated with records |
プロンプトの例
- 「セールスパイプラインで今月クローズ予定の取引と、それぞれの担当者を教えて。」
- 「コンタクト [email protected] を探して、所属する会社と進行中の取引を見せて。」
- 「Acme Corp の取引を次のステージに進めて、今日の通話の要約をメモとして追加して。」
- 「Globex の取引に、来週の金曜日が期限のフォローアップタスクを私宛てに作成して。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?