HubSpot MCP Server でローカル開発を効率化する
はじめに
HubSpot の Developer MCP Server を導入すると、AI アシスタント（Claude Code、Cursor など）が HubSpot の公式ドキュメントを参照しながら、より精度の高いコード生成やサポートを行えるようになります。
この記事では、ローカル環境への導入方法と活用例を紹介します。
MCP (Model Context Protocol) とは
MCP は、AI アシスタントが外部ツールやデータソースと統合するための標準プロトコルです。HubSpot は MCP に対応した開発者向けサーバーを提供しており、これを利用することで AI が HubSpot API の最新ドキュメントを参照できるようになります。
HubSpot が提供する 2 種類の MCP Server
HubSpot は現在、2 種類の MCP Server を提供しています：
1. Developer MCP Server (Local)
本記事で紹介するのはこちら
- ローカル開発環境で動作
- HubSpot API の公式ドキュメントを参照
- コード生成やデバッグ支援に最適
- 現在ベータ版（2025年11月時点）
2. HubSpot MCP Server (Remote)
- リモートで動作
- 実際の HubSpot データにアクセス
- データ分析や顧客情報の取得に利用可能
本記事では、開発効率化に焦点を当て、Developer MCP Server (Local) の導入方法を解説します。
公式ドキュメント:
- https://developers.hubspot.com/mcp
- https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server
できること
Developer MCP Server を有効にすると、以下のようなことが可能になります：
- 「HubSpot API で連絡先の電話番号を更新する方法は？」のような自然言語での問い合わせ
- 既存の HubSpot 連携コードの修正時に、公式ドキュメントに基づいた正確な提案
- API のベストプラクティスに沿ったコード生成
対応開発環境
Developer MCP Server は以下の開発環境に対応しています：
- Cursor
- Claude Code
- VS Code (MCP 対応拡張機能経由)
- Windsurf
Supported clients include Cursor, Claude Code, VS Code, and Windsurf.
https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server#set-up-the-server
前提条件
HubSpot アカウント
MCP Server のセットアップには、HubSpot アカウントが必要です。
無料のデベロッパーアカウントを作成できます：
ベータ版への申請
現在 MCP Server はベータ版のため、利用には申請が必要な場合があります。公式サイトから申請を行ってください。
（自分の場合、申請後すぐに利用できるようになりました）
導入手順
1. HubSpot CLI のインストール
まず、HubSpot の公式 CLI をインストールします：
npm install -g @hubspot/cli@latest
2. HubSpot アカウントとの連携
パーソナルアクセスキーを使用してアカウント認証を行います：
hs account auth
このコマンドを実行すると、~/.hscli/config.yml に認証情報が保存されます。
3. MCP Server のセットアップ
最後に、MCP Server をセットアップします：
hs mcp setup
動作確認
セットアップ完了後、対応する開発環境（Claude Code、Cursor など）を起動し、HubSpot に関する質問をしてみましょう：
HubSpot API でコンタクトを取得する方法を教えて
MCP Server が正常に動作している場合、AI が HubSpot の公式ドキュメントを参照して、より詳細で正確な回答を返すようになります。
使用上の注意点
トークン消費量
MCP Server を有効にすると、AI がドキュメントを参照するため、通常よりもトークン消費量が多くなる傾向があります。必要に応じて使い分けることをお勧めします。
ベータ版であることへの留意
現在、Developer MCP Server はベータ版です。予期しない動作や仕様変更の可能性があることを考慮してください。
トラブルシューティング
MCP Server が認識されない
# CLI のバージョン確認
hs --version
# 認証状態の確認
hs account list
# MCP Server の再セットアップ
hs mcp setup
認証エラー
パーソナルアクセスキーの有効期限が切れている可能性があります。HubSpot の設定画面から新しいキーを生成し、再度 hs account auth を実行してください。
まとめ
HubSpot の Developer MCP Server を導入することで、HubSpot API を使った開発がより効率的になります。公式ドキュメントを参照しながらコード生成ができるため、API の使い方を調べる時間を大幅に削減できます。
ベータ版ではありますが、開発体験の向上に大きく貢献するツールなので、ぜひ試してみてください。
Discussion