Antigravity CLI × HubSpot公式MCP Server
技術詳細ナレッジ

本構成の全体像

本構成は、Google提供のAntigravity CLI（コマンドライン型AIエージェント）と、HubSpotが公式提供するMCP Server を組み合わせます。両者ともMCP（Model Context Protocol）という業界標準のプロトコルで通信します。

主要コンポーネント

処理の流れ

マーケリーダーが Antigravity CLI に自然言語で質問を入力。CLI内蔵のGeminiが質問を解釈し、HubSpot MCP Server に対して必要なAPI呼び出しを実行。MCP ServerはPrivate App APIキーを使ってHubSpotにアクセスし、データを取得。取得結果をGeminiが整形してマーケリーダーに応答します。すべての通信はTLS暗号化、データはGeminiの学習には使われません。

必要な要件・前提条件

環境要件

HubSpot Private App の権限スコープ（推奨）

最小権限の原則に基づき、用途に応じて以下のスコープを付与します。

• crm.objects.contacts.read ／ コンタクトの読み取り
• crm.objects.companies.read ／ 会社の読み取り
• crm.objects.deals.read ／ 取引の読み取り
• crm.schemas.contacts.read ／ コンタクトのプロパティスキーマ読み取り
• crm.schemas.companies.read ／ 会社のプロパティスキーマ読み取り
• crm.schemas.deals.read ／ 取引のプロパティスキーマ読み取り

書き込みが必要な場合は、対応する .write スコープを追加します。検証フェーズでは読み取りのみでスタートすることを推奨します。

セットアップ手順

一度設定すれば、以降はターミナルで agy コマンドを実行するだけで利用できます。

HubSpot Access Token: pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

# Node.jsバージョン確認
node --version

# HubSpot CLI インストール
npm install -g @hubspot/cli

# バージョン確認（8.2.0以上であること）
hs --version

# Antigravity CLI 起動（初回はブラウザ認証）
agy

# 認証後、対話モードに入る
> /help

{
  "mcpServers": {
    "hubspot": {
      "command": "hs",
      "args": ["mcp", "start"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "pat-na1-xxxxxxxx..."
      }
    }
  }
}

# Antigravity CLI 起動
agy

# MCP接続状態を確認
> /mcp list

# 期待される出力
hubspot - Connected (21 tools)

> 直近1ヶ月で問い合わせフォーム送信した会社を5件、業種と従業員規模を含めて教えて

できること（機能詳細）

HubSpot公式MCP Server は、CRMのほぼ全機能にアクセスできる「フルサーフェスエリア」を提供します。21のツール（操作）が利用可能です。

利用可能な操作カテゴリ

利用シナリオの具体例

セキュリティ評価

本構成は、HubSpotとGoogleが公式提供するコンポーネントを組み合わせるため、セキュリティ面での信頼性が高い構成です。

メリット・デメリット

コスト試算

初期コスト

ランニングコスト（月額）

段階的導入プラン

想定されるリスクと対策

導入時のチェックリスト

組織側で事前確認すべきこと

• セキュリティ部門への提案・社内承認（別資料「セキュリティ評価ナレッジ」を活用）
• HubSpot Super Admin 権限の確認（Private App発行に必要）
• 利用環境の確認：PCのOS、Node.js のインストール可否
• Gemini 有料版の利用環境（Google One AI Pro / Workspace Gemini Alpha 等）の確認

導入支援者と連携して進めること

• Phase 1 用のプロンプトテンプレート（CV前後の行動サマリー用等）の設計
• HubSpot Private App のスコープ設計と発行手順の文書化
• Antigravity CLI セットアップガイド（利用者のPC環境に合わせて作成）
• 初回セットアップの伴走支援（1〜2時間想定）
• Phase 1 期間中の週次レビュー会の開催

導入判断のポイント

本ナレッジに基づき、Phase 1（マーケリーダー1名による限定検証）から始めることが推奨されます。セキュリティ部門への説明には「セキュリティ評価ナレッジ」を活用ください。承認後、約2週間以内に検証開始することが現実的なスケジュール感です。