MCPを使用してHubSpotをClaudeに接続します

ハブスポット無料プランクエリストリームクロード

HubSpotアカウントについて、普段の英語でClaudeに質問できます。ネットワーク内にすでにあるAgentがSQLを読み取り専用で実行し、AIクライアントがログイン情報を保持することはありません。所要時間は約10分で、Freeプランで利用できます。

無料で始めよう

最終的に手に入るもの

Claudeは、リアルタイムの読み取り専用クエリを使用してHubSpotアカウントに関する質問に答え、列の意味を説明し、さらに質問があればフォローアップしてくれます。データベースへのログインやファイアウォールの変更は一切不要です。ネットワーク内に既に存在するエージェントがSQLを実行し、行のみを返します。エージェントが配置されたら、設定画面の操作に慣れていれば、Claudeへの接続は約90秒で完了します。手順は以下のとおりです。

クロード チャットGPT カーソル クロード・コード VS Code ウィンドサーフィン ジェミニCLI ジェットブレインズ コーデックス+5件追加読み取り専用

中身は？ ハブスポット・ディールズ 私のHubSpotアカウントで確認したいのですが、いくつか行を表示して、各列の意味を教えてください。

qs_get_table_schema qs_run_query スキーマインテリジェンス

まずテーブル構造を確認し、次にエージェントを通して読み取り専用クエリを実行しました。以下はhubspot.dealsテーブルの3つの行です。

取引名	ディールステージ	額
1042	ノースウィンド・トレーダーズ	シアトル
1057	アルパイン・アウトフィッターズ	デンバー
1063	ハーバーフーズ	ハリファックス

取引名 行を識別します。 ディールステージ そして 額 それらはあなたのセマンティックインテリジェンスモデルに記述されているので、名前でフィルタリングできます。

どれが３つか 額 今四半期で最も収益を上げたのはどの商品でしたが、前四半期と比べてどうでしょうか？何か調べておくべき点はありますか？

qs_get_relationships qs_run_query qs_run_query

私は参加しました ハブスポット・ディールズ ～へ オーダー Semantic Intelligenceが発見した関係性に基づいて、四半期ごとに集計を実行しました。どちらのクエリも読み取り専用で、それぞれ3行を返しました。

額	今四半期	前四半期	変化
デンバー	184,200	133,900	+38%
シアトル	171,650	168,400	+2%
ハリファックス	96,300	129,700	−26%

デンバー つまり、顧客数はほぼ同じながら売上高が38％増加し、平均注文額が上昇したということだ。 ハリファックス 26%減少しました。減少した顧客のうち2社は、前四半期は毎月注文していたのに、今四半期は全く注文していません。月末までに電話してみる価値はあります。シアトルは横ばいです。ハリファックスの2つのアカウント名を知りたいですか？

選択のみ、エージェントによる確認済み MCPアクティビティタブにログインしました 3つのクエリで合計9行が返されました 14台のMCPクライアントで同じ接続が確立されています。

AIクライアントを一切接続したくないですか？ 事業計画書では、 ノヴァ MCPはQuery Streams自体に組み込まれたアシスタントです。AIクライアントがここで利用できるエージェントツールセットと同じものを使用するだけでなく、外部クライアントでは利用できない機能も備えています。つまり、セマンティックインテリジェンスモデルに対してSQLをドラフトして検証し、結果をグラフに変換し、結果をExcel、Google Sheets、またはREST APIから実行できるクエリとして保存します。キーもコネクタもインストールも不要です。Claude、Cursor、またはChatGPTを既に利用している場合はMCPを、ポータル内で回答を取得したい場合はNovaを使用してください。

HubSpotはAPIを通じてあなたのデータを保持しています。一方、Claudeはブラウザやターミナル上で動作し、そのデータについては何も知りません。従来の方法は、スキーマをチャットに貼り付けてうまくいくことを祈るか、オープンソースのMCPサーバーにHubSpotのパスワードを渡すことでした。Query Streamsはこれとは異なります。HubSpotアカウントに既に存在するエージェントが、Claudeが書き込んだSQLを読み取り専用で実行し、その間にMCPサーバーが誰が質問しているのか、何を実行できるのか、どのくらいの頻度で質問しているのかを確認します。Claudeは回答を受け取りますが、認証情報を受け取ることはありません。

必要なもの

クエリストリームアカウント

MCPは無料プランを含むすべてのプランで利用可能です。無料プランではキー1つまたは接続アプリ1つが利用できますが、このガイドに必要なのはそれだけです。サインアップはこちらから my.querystreams.com.

HubSpotはエージェントを介して接続しました

エージェントは、HubSpot接続がデータエージェントに追加された、常時稼働している任意のコンピューターにインストールされます。まだ完了していませんか？ HubSpotを最初に接続します所要時間は約10分です。

MCPが起動しました

作成者、所有者、管理者は最初からそれを持っています。他のすべての人は、管理者に切り替えてもらう必要があります。 MCP 名前の横にあるスイッチ アカウント → アクセス制御それまでは、MCPページには「お客様のアカウントではMCPが無効になっています」と表示されます。

AIクライアント

claude.ai、Claude Desktop、ChatGPTなどのチャットアプリはキーなしで接続します。Claude Code、Cursor、VS Code、その他約10個のツールはキーを使用します。Portalの AIクライアントを接続する ガイドがそれぞれ設定します。

4つのステップで設定できます

1. ポータルでMCPを開く

   サインインはこちら my.querystreams.com そして開く ストリーム → ライブ → MCPこのページには4つのタブがあります。 コネクション, コンテクスト, ツール そして、管理者向けには、 活動. セマンティックインテリジェンスパネルを確認してください コネクション ここに来てくださった方は、HubSpotコネクタと、そのコネクタ上でSemantic Intelligenceが実行されたかどうかを確認できます。完全なカバレッジのおかげで、Claudeは初回で正しいHubSpot SQLを作成できるのです。

   Open MCP

   「お客様のアカウントではMCPが無効になっています」というメッセージが表示されますか？ 組織には MCP がありますが、ユーザーの機能がオフになっています。管理者がそれをオンにするには、 MCP 名前の横にあるスイッチ アカウント → アクセス制御作成者、所有者、管理者は最初から参加しています。

2. 接続方法を選択してください

   入り口は2つあり、どちらも同じ場所にたどり着く。

   チャットアプリ · キー不要

   claude.ai、Claude Desktop、ChatGPT

   claude.ai と Claude Desktop で、 クエリ ストリーム一覧 Anthropicのコネクタディレクトリで、 接続する そして承認します。URL で追加します。 https://mcp.querystreams.com/mcpはフォールバックです。ChatGPTでは、アプリからクエリ ストリームを追加し（現時点では開発者モード）、クエリ ストリームでサインインします。どちらの方法でもクエリ ストリーム ページが開きます。組織と権限を選択してクリックします。 接続を承認するコピーするものは何もありません。接続は コネクション タブで取り消すことができます。

   開発者ツール・鍵

   クロード・コード、カーソル、VSコードとその仲間たち

   MCPページでクリック AIクライアントを接続するガイドは尋ねる AIクライアントはどのように接続しますか？： 選ぶ 設定ファイル内のキーを使用するツールを選んでから キーを生成する それ： キー名, 読む そして クエリを実行する チェックした、 有効期限 （なし、30日間、90日間、または1年間） 設定する キーが記入されたスニペットが表示され、 接続を確認してください 最初の呼び出しを待つ。

   どちらの方法も同じ3つの権限を使用します。これらの権限は、同意画面またはキー上で選択します。

   読む

   コネクタの一覧表示、テーブルと列の参照、保存済みクエリとアラートルールの読み取りを行います。行データは返しません。

   クエリを実行する

   エージェントを通して読み取り専用のSQLと保存済みクエリを実行し、結果の行を返します。これがないと、AIクライアントはデータの説明はできますが、データに基づいて回答することはできません。

   分析

   プロファイルテーブルを作成し、関係性を検出して、セマンティックインテリジェンスの実行をキューに追加します。Nova AIのクレジットとデータ使用量を消費するため、同意画面で事前にチェックが入ることはありません。

   鍵をなくした？ それはリストされています コネクション タブ： 完全なキーを表示する それを再び表示して 完全なキーをコピー それをコピーします。ノートパソコンが紛失した場合は、そこで取り消してください。そうすれば、それを使用しているすべてのクライアントは、約5分以内に次の呼び出しで失敗します。

3. クロードとつながる

   使用するクロードのレシピを選択してください。サーバーアドレスはどこでも同じです。 https://mcp.querystreams.com/mcp.

   ウェブ版クロード、デスクトップ版クロード、モバイル版クロード キーなし

   1. 開く クエリ ストリーム一覧 Anthropicのコネクタディレクトリでクリックして 接続するデスクトップでは、その下に配置されます。 + → コネクター.
   2. 組織がディレクトリコネクタを非表示にしている場合の代替策： 設定 → コネクタ → カスタムコネクタを追加、 名前 クエリストリーム、URL https://mcp.querystreams.com/mcpOAuthフィールドが空です。 追加;それからチャットで + → クエリストリーム → 接続する.
   3. クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして クエリを実行する任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
   4. Claudeに戻ると、「クエリ ストリームに接続済み」と表示されます。Claudeがツールを初めて使用すると、次の質問が表示されます。 常に許可する.

   Claude Desktopで手動で追加する場合は、 設定 → コネクタ → 追加チャット内ではなく マーケットプレイスを追加 このオプションは、Gitリポジトリを必要とします。コネクタはClaudeアカウントと同期されるため、モバイルアプリとデスクトップ版は自動的にそれを取得します。メニュー名はAnthropicのものであり、変更可能です。

   クロード・コード 鍵

   接続タブのキーを使って、以下のコマンドを実行してください。

   ターミナル

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   これは現在のプロジェクトの .mcp.json。 追加 --スコープ ユーザー すべてのプロジェクトにクエリ ストリームを持たせる。 /mcp Claude Codeの内部で接続を確認する。

   カーソル 鍵

   開く カーソル設定 → MCP → 新しい MCP サーバーを追加または編集 .cursor/mcp.json ワークスペースのルートに:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   カーソルを再起動するか、実行してください MCP: サーバーの再起動; a クエリストリーム バッジはMCPステータスバーに表示されます。

   他のものを使っていますか？ ポータルの AIクライアントを接続する ガイド ChatGPT、VS Code、Visual Studio、OpenAI Codex CLI、Gemini CLI、Windsurf、Zed、Cline、Continue.dev、JetBrains AI 用のすぐに貼り付けられるレシピに加え、 貼り付けて結合する ドロップするツール クエリストリーム 既にお持ちの設定ファイルへのエントリ。HTTP 上で MCP と通信するクライアントであればどれでも動作します: サーバー https://mcp.querystreams.com/mcpヘッダー X-MCPキー （アン） 認証：所持者 同じキーを持つヘッダーでも機能します。

4. 最初の質問をしてください

   まずは、答えが分かっていることから始めてみましょう。そうすれば、クロードが適切なツールを選ぶ様子が分かります。HubSpotアカウントと相性の良いツールを3つご紹介します。

   「私のHubSpotアカウントにはどのようなデータがありますか？」

   Claudeは、認識可能なテーブルを一覧表示し、セマンティックインテリジェンスを持つテーブルを教えてくれ、何を見たいのかを尋ねます。

   「hubspot.dealsから10行を表示して、各列について説明してください。」

   クロードはまずテーブル構造を読み込み（読み込み）、次にエージェントを通して1つのSELECTクエリを実行し（クエリの実行）、dealstageとamountの意味を説明します。

   「hubspot.dealsには、金額ごとに何行ありますか？最も行数が多い金額はどれですか？」

   クロードはHubSpotの用語でGROUP BY句を記述し、実行した後、小さな表を添えた一文で回答します。同じチャット内でフォローアップすることで、会話の文脈が維持されます。

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる qs_list_connectorsポータルガイドの 接続を確認してください ステップにはこう書いてある 接続済み、キーまたはアプリ コネクション タブには、 最終使用日時 数秒以内の時間。

接続されたクロードができること

AIクライアントはクエリストリームツールを認識し、質問に最適なツールを選択します。ポータルの ツール タブ プランに含まれるすべてのツールとモードを一覧表示します。Query Streams は、クエリを実行する前にAIクライアントに各テーブルの列を読み取らせるため、推測ではなく実際の名前を使ってクエリを作成できます。Freeを含むすべてのプランで利用できます：

分析ツールセット。 有料プランでは、HubSpotアカウントが存在する場所でエージェントが基礎作業を行うため、AIクライアントは思考に集中できます。無料プランはこれまで通り動作します。

デフォルトは コンテクスト タブテキストセルの制限、スキーマビュー、結果サイズ、分析のデフォルト設定、および保留された結果。

セマンティックインテリジェンスがここで重要な理由

クロードが受け取るすべての回答には、その構造がどこから来たのかという情報がタグ付けされており、クロードはそれに基づいて、目にしたものに対する信頼度を調整する。

データベースが重要な場合は、Semantic Intelligence を一度実行してください。 ノヴァ → インテリジェンス. コネクション タブには、コネクタごとのカバレッジパネルが表示されます。 セマンティックインテリジェンスの仕組み.

計画で許可されている内容

MCPは無料プランを含むすべてのプランに含まれており、追加料金はかかりません。各プランで設定できるのは、保持できるキーまたは接続アプリの数と、AIクライアントが1分間に発信できる通話の数です。

接続されたアプリはキーとしてカウントされます。1 分あたりの数値に加えて、1 つのキーは 1 分間に最大 10 回のクエリを実行できます。クエリは、AI クライアントが最大 5 分まで延長を要求しない限り、最大 60 秒間実行されます。プランでは、1 つのクエリが返す行数、および分析ツールセットを使用する場合は、保持される結果の長さとサイズも設定します。 MCP完全ガイド すべてのプランを一覧表示します。AIクライアントが受け取るデータは、ExcelやSheetsのクエリと共通のData Realm利用枠にカウントされます。AIエージェント（MCP）の使用量は、結果、スキーマの読み取り、保持された結果のページなど、AIクライアントに配信されるすべてのバイト数を、クライアントがネゴシエートする転送圧縮を行う前にカウントします。一方、スプレッドシートのクエリでは、Network Agentが配信する圧縮済みの結果がカウントされます。AIクライアントから開始されたSemantic Intelligenceの実行では、Portalから開始した場合とまったく同じようにNova AIクレジットが消費されます。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

• 正規クエリとして保存する クエリビルダーでは、クロードはまず保存済みのクエリを参照します。したがって、「アクティブな顧客」とは、あなたのチームが定義する意味になります。
• クロード・プロジェクトを使用する クエリ ストリームを添付し、その指示に独自のルールを記述します。デフォルトで使用する HubSpot データベース、公式定義として保存されているクエリなどです。
• より深い答えが欲しいときは、Grant Analyzeをご利用ください。 列をフィルタリングする前にプロファイリングを行うことは、ステータスコードを推測するのと正しいコードを使用するのとでは大きな違いがあります。Nova AIのクレジットを消費するため、ユーザーが解除するまではオフになっています。
• 図表を請求してください。 claude.ai は、Claude が返す行データからグラフを作成します。

何かがうまくいかないとき

人々が尋ねる質問

関連ガイド

• StripeとClaudeをMCPで接続する
• MCPを使用してShopifyをClaudeに接続します
• MCPを使用してGoogle Analytics 4をClaudeに接続します。
• MCPを使用してGoogle Search ConsoleをClaudeに接続する
• MCP を介してクエリ ストリームを Claude に接続する: セットアップ、権限、およびトラブルシューティング
• HubSpotをGoogleスプレッドシートに接続する方法
• すべてのMCPガイド