GitHub Copilot × CData Code Assist MCP for HubSpot で HubSpot のリアルタイムデータを活用する方法
GitHub Copilot は、Visual Studio Code をはじめとする IDE に統合された AI コーディングアシスタントです。MCP に対応しているため、ローカルツールやエンタープライズデータソースに接続し、開発中にリアルタイムデータを自然言語で操作できます。
Model Context Protocol(MCP) は、LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP サーバーはスキーマの探索やリアルタイムクエリなどの機能を提供し、AI エージェントがリアルタイムデータに安全かつ一貫した方法でアクセスできるようにします。
この記事では、CData Code Assist MCP for HubSpot のインストールから HubSpot への接続設定、Code Assist MCP アドオンと GitHub Copilot の連携、さらに Visual Studio Code から HubSpot のデータ をクエリする方法まで、ステップバイステップで解説します。
HubSpot データ連携について
CData は、HubSpot のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- API の更新や変更を気にすることなく、HubSpot にアクセスできます。
- 追加の構成手順なしで、HubSpot のカスタムオブジェクトやフィールドにアクセスできます。
- SQL ストアドプロシージャを使用して、添付ファイルのアップロード・ダウンロード、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。
ユーザーは、Tableau、Power BI、Excel などの分析ツールと HubSpot を統合し、当社のツールを活用して HubSpot データをデータベースやデータウェアハウスにレプリケートしています。
他のお客様が CData の HubSpot ソリューションをどのように使用しているかについては、ブログをご覧ください:Drivers in Focus: Simplified HubSpot Connectivity
はじめに
前提条件
- Visual Studio Code がインストールされていること
- Visual Studio Code で GitHub Copilot Chat 拡張機能が有効になっていること
- CData Code Assist MCP for HubSpot がインストールされていること
ステップ1:CData Code Assist MCP for HubSpot のダウンロードとインストール
- まずは CData Code Assist MCP for HubSpot をダウンロードします。
- ダウンロードしたインストーラーをダブルクリックして実行します。
- 画面の指示に従ってインストールを完了させます。
インストールが完了したら、HubSpot への接続設定に進みましょう。
ステップ2:HubSpot への接続を設定
- インストールが完了すると、CData Code Assist MCP for HubSpot の設定ウィザードが起動します。
注意:ウィザードが自動的に起動しない場合は、Windows の検索バーで「CData Code Assist MCP for HubSpot」と入力し、アプリケーションを起動してください。
- MCP Configuration > Configuration Name で、既存の構成を選択するか、
を選択して新しい構成を作成します。
- 構成名を入力(例:「cdata_hubspot」)し、OK をクリックします。
-
設定ウィザードで適切な接続プロパティを入力します。
HubSpot 接続プロパティの取得・設定方法
HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。
OAuth
HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。
また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。
- Connect をクリックして、OAuth 経由で HubSpot に認証します。
- Save & Test をクリックして接続を確定します。
この操作により、GitHub Copilot が Code Assist MCP アドオンを起動する際に参照する .mcp 構成ファイルが作成されます。続いて、Code Assist MCP アドオンを GitHub Copilot に接続しましょう。
ステップ3:Code Assist MCP アドオンを GitHub Copilot に接続
- Visual Studio Code をダウンロード・インストールし、GitHub Copilot Chat 拡張機能を有効にします。
- mcp.json ファイルを開くか新規作成します。
- グローバル設定の場合:%%APPDATA%%/Roaming/Code/User/mcp.json
- プロジェクト固有の設定の場合:
/.vscode/mcp.json
- 以下の JSON コードを追加してファイルを保存します。
- 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
- AI MCP Tool ドロップダウンから Github Copilot を選択します。
- MCP Client Instructions に従って、必要な構成ファイルを作成します。
- 表示された JSON コードをコピーして、構成ファイルに貼り付けます。
方法1:MCP 構成を手動で追加する
{
"servers": {
"cdata_hubspot": {
"command": "C:\Program Files\CData\CData Code Assist MCP for HubSpot\jre\bin\java.exe",
"args": [
"-Dfile.encoding=UTF-8",
"-jar",
"C:\Program Files\CData\CData Code Assist MCP for HubSpot\lib\cdata.mcp.hubspot.jar",
"cdata_hubspot"
]
}
}
}
注意:command の値には Java 17+ の java.exe 実行ファイルへのパスを、JAR パスには CData Code Assist MCP アドオンの .jar ファイルへのパスを指定してください。最後の引数は、CData 設定ウィザードで保存した MCP 構成名(例:「cdata_hubspot」)と一致させる必要があります。
方法2:CData Code Assist MCP for HubSpot の UI から MCP 構成をコピーする
ステップ4:GitHub Copilot からリアルタイム HubSpot のデータ をクエリ
- Visual Studio Code を起動し、GitHub Copilot Chat インターフェースを開きます。ツールアイコンを選択して、設定済みの Code Assist MCP アドオンを有効にします。
- 自然言語で HubSpot のデータ について質問してみましょう。例:
"List all tables available in my HubSpot のデータ data connection."
- 自然言語プロンプトを使って開発を進めることもできます:
For my project, data from the Prospects is very important. Pull data from the most important columns like Slug and PageViews.
これで GitHub Copilot と CData Code Assist MCP for HubSpot の連携は完了です。MCP ツールを使用して、スキーマの探索や HubSpot に対するリアルタイムクエリを実行できます。
Code Assist MCP で構築。CData Drivers で本番運用。
Code Assist MCP を無料でダウンロードして、開発中にライブの HubSpot のデータ へのスキーマ対応アクセスを AI ツールに提供しましょう。本番環境に移行する際は、CData HubSpot Drivers が同じ SQL ベースのアクセスをエンタープライズグレードのパフォーマンス、セキュリティ、信頼性で提供します。
CData コミュニティにアクセスして、インサイトの共有や質問、MCP を活用した AI ワークフローの可能性を探索しましょう。