MCP経由でクエリストリームを Claude に接続する: セットアップ、権限、およびトラブルシューティング

14分の読み物

クエリストリームを Claude に接続し、データベースに関する質問を平易な言葉で尋ねましょう。Claude は、スキーマ、保存済みクエリ、スキーマインテリジェンスモデルをリアルタイムで読み取り、ネットワークエージェントを介して読み取り専用 SQL を実行します。データベースのパスワードは一切表示されません。このガイドでは、claude.ai、Claude Desktop、Claude Code、およびその他のすべての MCP クライアントについて説明します。

短縮版。 Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors、探す クエリストリーム、クリック 接続するクエリストリームの同意画面で権限を承認し、クロードに尋ねてください。 「私がアクセスできるデータベースは何ですか？」 That’s it.

始める前に

必要なものは4つあります。ほとんどのアカウントには最初の3つは既に揃っています。

MCPを含む計画

MCPは無料プランを含むすべてのプランで利用可能です。プランによって異なるのは、保持できるキーまたは接続アプリの数と、Claudeが1分間に発信できる通話回数です。無料プランでは、キーまたは接続アプリは1つまで、通話回数は1分あたり30回までとなっています。

オンラインのネットワークエージェント

エージェントは、データベースの隣に配置される小さなサービスで、Query Streams へのアウトバウンド接続を 1 回確立します。チームが既にポータル、Excel、または Google スプレッドシートでクエリを実行している場合は、既にインストールされています。インストールガイド →

少なくとも1つのコネクタ

コネクタとは、ポータルに登録されているデータベースまたはAPIソースのことです。Claudeは、ユーザーが付与した権限の範囲内で、アカウントがアクセスできるすべてのコネクタを確認できます。

ユーザーアカウントでのMCPアクセス

組織の作成者と所有者は自動的に MCP アクセス権を持ちます。その他のユーザーは管理者がチェックを入れる必要があります。 MCP 名前の横に アカウント → アクセス制御.

仕組み

Claudeはデータベースに直接接続することはありません。クラウド上のQuery Streams MCPサーバーと通信し、ネットワークエージェントが既に開いている単一のアウトバウンド接続を介して各リクエストを中継します。エージェントはローカルでクエリを実行し、同じ方法で結果をストリーミングします。リクエストと結果は、エージェントが開始する単一のチャネルを介して双方向に流れるため、ファイアウォールで何も設定する必要はありません。

クロードclaude.ai、デスクトップ、コード、または任意のMCPクライアント

クエリストリーム MCPmcp.querystreams.com
OAuth、スコープ、監査、レート制限

ネットワーク・エージェントネットワーク内部
1つの送信TLS接続

あなたのデータベースSQL Server、Postgres、MySQL、Oracle、BigQuery、Access、ファイル、API…

その設計から、以下の3つの特性が導き出される。

クロードには資格情報がありません。 データベース接続文字列はエージェント上に保存されます。ClaudeはOAuth認証情報またはMCPキーのみを保持しており、どちらもポータルからワンクリックで取り消すことができます。
読み取り専用。エージェント側で強制されます。 のみ セレクト, と そして 説明する ステートメントは受け付けられます。チェックはクラウドやClaudeではなく、接続先のユーザー側で行われます。
すべて記録されます。 すべてのツール呼び出しはMCPページに表示されます。活動タブとクエリ履歴内のすべてのクエリは、接続したユーザーに紐付けられます。

クロードとつながる

アクセス方法は2つあります。チャットアプリはOAuthを使用するため、キーは不要です。開発者ツールはMCPキーを使用します。どちらの方法でも、同じサーバーとツールにアクセスできます。

オプションA：claude.aiとClaude Desktop（OAuth、キー不要）

Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from コネクタを参照する; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.

の上クロード・アイ開ける Settings → Connectors → Browse connectors、検索する クエリストリーム そしてクリック 接続する (or open the directory listing directly). In Claude Desktop the same option is under 設定 → コネクタ. Can’t see it? Your organization may restrict directory connectors: click カスタムコネクタを追加する instead, name it クエリストリーム and paste https://mcp.querystreams.com/mcp.
任意のチャットを開き、 + メッセージボックスの横にあるボタンを選択し、 クエリストリーム そしてクリック 接続する.
新しいブラウザタブでクエリストリームの同意画面が開きます。求められたらサインインし、組織を選択し、権限を確認し（下記参照）、クリックします。 接続を承認する.
クロードに戻ると、 クエリストリームに接続しましたクロードが初めてツールを使用する際、許可を求められます。選択してください。 常に許可する そのため、通話のたびにプロンプトを表示しなくても動作します。

コネクタはデバイスではなくClaudeアカウントに紐付けられているため、ClaudeモバイルアプリとClaudeデスクトップに自動的に表示されます。ポータルからいつでも管理または取り消すことができます。 MCP → コネクテッドアプリ タブ。

「マーケットプレイスを追加」とは異なります。 Claude Desktop では、チャット内 + → コネクタを参照 → マーケットプレイスを追加 オプションでは、プラグインマーケットプレイスの Git リポジトリが必要であり、MCP サーバーの URL は必要ありません。 設定 → コネクタ → 追加.

オプションB：Claude Code、Cursor、その他の開発者ツール（MCPキー）

開発者ツールは、ポータルで生成したキーで認証し、 X-MCPキー ヘッダ。

サインインはこちら my.querystreams.com、開ける MCP → マイキー そしてクリック キーを生成する. 工具や機械にちなんで名前を付けます。例: クロード・コード・ラップトップそして、そのスコープを選択します。
キーを今すぐコピーしてください。後で再度表示してコピーできます。 私の鍵キーは次のような形をしています qsmcp_ 続いて43文字。
Claude Code を実行するには、以下を実行してください。
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE"
Cursor、VS Code、Windsurf、Zed、JetBrains、Gemini CLI、Codex CLI、Continue、Cline の場合は、 MCP → 接続 ポータルのタブをクリックしてください。各クライアントごとに、キーが既に入力された状態で、すぐに貼り付けられる設定が表示されます。

確認するには、 「どのようなクエリストリームコネクタが利用できますか？」 クライアントは電話する必要があります qs_list_connectors そして鍵は 最後に使用された 「マイキー」タブの時刻は数秒以内に更新されます。

権限

OAuth接続でもキー接続でも、アクセスは3つのスコープによって制御されます。同意画面にこれらのスコープが表示され、それらに基づいてキーが作成されます。

範囲	クロードができること	いつ許可するか
読む	コネクタとエージェントの一覧表示、スキーマの参照、スキーマインテリジェンスの説明の閲覧、保存済みクエリとアラートルールの一覧表示。	常にそうだ。他のすべてはそれの上に成り立っている。
分析する	プロファイルテーブル（サンプル値、分布、意味型）を作成し、暗黙的な関係性を検出し、スキーマインテリジェンスの実行をキューに追加します。	推奨。これにより、Claudeは結合処理を実行する前にデータの構造を理解できるようになります。
実行する	読み取り専用のSQLと保存済みクエリを実行し、行をストリームバックします。	構造を閲覧するだけでなく、回答も取得したい人向けです。閲覧専用キーにする場合は、オフにしてください。

接続済みアプリは、承認時に特定のコネクタに限定することができます。生成されたキーは、組織内のすべてのコネクタに送信されます。権限またはキーの取り消しは、約5分以内に有効になります。管理者は、MCPページで組織のすべての有効な権限とキーを確認できます。

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

クロードは少数のツールセットを目にします。あなたはそれらを自分で呼ぶ必要はありません。クロードがあなたの質問に最適なツールを選びます。簡単に言うと、次のようになります。

データを理解する

コネクタ、データベース、エージェントの一覧を表示します。テーブルと列の説明、意味型、サンプル値、列挙型ラベル、宣言済みおよび検出済みのリレーションシップを含む、任意のデータベースのスキーマツリーを読み取ります。

プロフィールと探索

フィルタを作成する前に、テーブルのプロファイリングを行い、実際の値分布を確認します。外部キーが宣言されていないテーブル間の結合を検出します。

保存済みのクエリを使用する

組織で保存されているパラメータ付きクエリを一覧表示し、異なるパラメータで実行できます。複数のソースにまたがるフェデレーションクエリはサーバー側で実行され、既に結合された行が返されます。

アドホックSQLを実行する

コネクタに適した方言で、読み取り専用のSQL文を作成して実行してください。デフォルトでは、結果の行数は1,000行、タイムアウト時間は60秒に設定されていますが、どちらも調整可能です。

アラートを確認する

アラートルールの一覧を表示し、現在の状態と最近の発動状況を確認できます。クロードはドライランモードで新しいルールを提案でき、ユーザーはアラートページでそのルールを有効にします。

モデルを改善する

データベースごとにスキーマインテリジェンスの適用範囲を確認し、お客様の同意を得た上で分析実行をキューに追加することで、今後の回答の精度を向上させます。

ここでスキーマインテリジェンスが重要な理由

クロードが受け取るすべての応答には、それが3つの階層のうちどの階層から来たのかを示すタグが付けられており、クロードはそれに基づいて、目にした情報の信頼度を調整する。

ティア	クロードが見たもの	結果
スキーマ・インテリジェンス	すべてのテーブルと列の説明、意味型、列挙型ラベル、サンプル値、ファクトとディメンションの分類、宣言済みおよび検出された結合。	クロードは、本番環境で使用できるレベルのSQLを初回で作成し、データをあなたのビジネス用語で説明します。
キャプチャされたスキーマ	テーブル名と列名、型、主キー、インデックス、宣言された外部キー。	クロードは仕事はできるが、名前から意味を推測する必要があり、追加の質問が必要になる場合もある。
ライブスキーマ	データベースはコネクタのキャプチャ選択範囲に含まれていないため、構造はリクエストごとにカタログからリアルタイムで読み込まれます。	クエリは引き続き実行されます。Claudeは、必要に応じてサンプルSELECT文を使用して探索を行います。

チームにとって重要なデータベースであれば、一度スキーマインテリジェンスを実行してください。大規模なデータベースの場合は、クエリが実際に使用するテーブルのみを対象に実行範囲を設定してください。スキーマインテリジェンスの仕組み →

プロンプト例

まずは、自分が答えを知っていることから始めてください。それから、追加の質問をしてください。クロードは文脈を常に意識しています。

私がアクセスできるデータベースとテーブルはどれですか？また、そのうちスキーマインテリジェンスを備えているのはどれですか？コネクタの位置をマッピングし、回答が最も得られやすい場所を示します。販売データベースにおいて、顧客と注文がどのように関連しているかを示し、注文ステータス列のプロファイルを作成してください。リレーションシップとカラムプロファイリングを活用します。クロードが実際のステータスコードとその意味を説明します。保存済みのクエリ「地域別月間収益」を、今年の第2四半期分について実行してください。独自のSQLを生成する代わりに、パラメータ付きで信頼できる保存済みクエリを実行します。過去90日間の売上高上位10製品。次に、それを販売チャネル別に分類してください。コネクタの方言によるアドホックなSQL文、そして同じスレッドでのフォローアップ。どの警告ルールが設定されていますか？また、今週、それらのルールが作動しましたか？アラートルールとその最新の状態を読み取ります。

より良い回答のためのヒント

クロード・プロジェクトを利用してください。 Query Streamsコネクタをプロジェクトに接続し、プロジェクトの説明にビジネスルールを記述します。デフォルトで使用するデータベース、公式定義となる保存済みクエリ、命名規則などを指定します。Claudeは引き続きスキーマをリアルタイムで読み込むため、説明は簡潔にまとめられます。
正規クエリと考えるクエリを保存してください。 クロードはまず保存済みのクエリにアクセスするので、「アクティブな顧客」とは、あなたのチームが定義する意味になります。
分析範囲を付与する。 列をフィルタリングする前にその列のプロファイリングを行うことは、ステータスコードを推測するのと、正しいステータスコードを使用するのとでは大きな違いを生みます。
図表を請求してください。 claude.ai は、Claude が取得した行データからグラフを作成します。

費用はいくらですか

MCP自体には、どのプランにも別途料金はかかりません。計測されるのは以下の2点です。

データ量。 Claudeに返されるクエリ結果は、Excel、Google Sheets、Portal、Novaの使用量が共有するデータ領域の予算にカウントされます。MCPはエンドツーエンド圧縮なしでHTTP上で動作するため、非圧縮バイト単位で計測されます。したがって、1MBの結果は約1MBのコストがかかりますが、Excelへの同じ結果は通常150～250KBのコストがかかります。 プレビュー制限 探究的な質問には適している。
スキーマインテリジェンスが実行されます。 Claude を介して分析をキューに入れると、ポータルから実行する場合と同様に、組織に AI クレジットが請求されます。Claude は実行前に確認を求めます。

トラブルシューティング

あなたが見るもの	それはどういう意味か	修理
Claude はクエリストリームツールを表示しません	コネクタは追加されたものの、チャットから接続されなかったか、OAuth承認が完了しなかった。	チャットを開いてクリック +クエリストリームを選択します。接続するそして、同意画面を完了します。
`MCP_KEY_REQUIRED` または401	サーバーにキーまたは許可情報が届きませんでした。キークライアントの場合、これは通常、末尾の改行などのコピー＆ペーストエラー、またはキーが間違ったヘッダーに含まれていることが原因です。	キーを再コピーして `X-MCPキー` ヘッダー。claude.ai の場合は、+ メニューから再接続してください。
`MCP_TOKEN_EXPIRED`	OAuthトークンは一定期間操作がなかったため、有効期限が切れました。	クロードは通常、自動的に更新されます。更新されない場合は、コネクタを一度取り外して再度接続してください。
`MCP_KEY_REVOKED` または `MCP_USER_DISABLED`	キーが取り消されたか、ユーザーのMCPアクセスが無効になっています。	新しいキーを生成するか、管理者にMCPを再度有効にするよう依頼してください。アカウント → アクセス制御.
`MCP_SCOPE_REQUIRED`	許可または鍵にはそのアクションの範囲が欠けていることが多い `実行する`.	再接続して不足しているスコープを承認するか、不足しているスコープを含むキーを生成してください。
`MCP_PLAN_LAPSED`	お客様の組織のサブスクリプションは期限切れとなりました。	ポータルのMCPページには、現在の計画状況と今後の進め方が表示されます。
`MCPエージェントが接続されていません`	コネクタを所有するネットワークエージェントは現在接続されていません。	チェックデータエージェントポータル内で、ホスト上でエージェントサービスを開始します。
`MCP_CONNECTOR_NOT_ALLOWED`	このキーは特定のコネクタでのみ使用可能で、これはその対象ではありません。	「マイキー」でキーのコネクタ許可リストを編集するか、別のキーを使用してください。
`MCP_DATABASE_NOT_CAPTURED`	データベースがコネクタのスキーマキャプチャ選択範囲に含まれていないため、スキーマインテリジェンスや保存されたリレーションシップを読み取ることができません。ただし、クエリは引き続き機能します。	ポータルのコネクタでデータベースをキャプチャ選択に追加し、必要に応じてスキーマインテリジェンスを実行します。
`MCP_RATE_LIMITED`	ご利用のプランでは、1分あたりの通話回数が上限を超えています。	少々お待ちください。負荷の高いセッションでは、スキーマインテリジェンスの恩恵を受け、クロードはより少ない呼び出し回数で応答できるようになります。
`MCP_QUERY_TIMEOUT`	クエリの実行時間がタイムアウト（デフォルト設定は60秒）を超えました。	クロードにフィルターを追加するか、行数の下限を上げるか、 `タイムアウト秒数` 最大300まで。
`MCP_出力が大きすぎます`	結果はあまりにも膨大で、クロードに一度に伝えることはできなかった。	列数や行数を減らすように依頼してください。クロードはたいてい自ら提案してくれるでしょう。
読み取り専用違反	SQLには、 `セレクト`, `と` または `説明する`.	設計上の仕様です。MCP経由での書き込みは一切受け付けられません。

まだ解決しませんか？チケットを開いてください。 my.querystreams.com/support またはメール [email protected].

セキュリティとプライバシー

Claudeは、スキーマメタデータ、サンプル値を含むスキーマインテリジェンスの説明、およびユーザーが要求したクエリの結果を受け取ります。これらの結果は、ユーザーが接続を選択したAIプロバイダーの利用規約に基づき、そのプロバイダーに送信されます。
Query Streamsは、Claudeとの会話を受信したり保存したりしません。
OAuthの権限とキーは、ユーザーごと、組織ごとに付与されます。管理者は、MCPページからすべての権限とキーを確認および取り消すことができます。
詳細は以下をご覧ください。プライバシーポリシーそして利用規約.

よくある質問

ポートを開放したり、VPNを実行したりする必要はありますか？
いいえ。エージェントはポート443で1つのTLSアウトバウンド接続を確立します。アウトバウンドHTTPSが機能すれば、MCPは機能します。

クロードは私のデータを変更できますか？
いいえ。エージェントは読み取りステートメントのみを受け付けます。Claudeは、スキーマインテリジェンスの実行をキューに追加し、ドライランモードでアラートルールを提案できます。どちらもクエリストリームのメタデータに書き込み、データベースには書き込みません。

他にどのようなAIツールが有効ですか？
MCPに対応しているものなら何でも：ChatGPT、Cursor、Claude Code、Windsurf、Zed、VS Code Copilot、JetBrains AI、Gemini CLI、Codex CLI、Continue、Clineなど。ポータルのMCPページには、それぞれに対応した設定ファイルが用意されています。

複数の組織と連携できますか？
各助成金またはキーは、1つの組織に紐付けられています。必要な組織ごとに一度接続してください。

これとNovaの違いは何ですか？
NovaはQuery Streamsポータルに組み込まれたアシスタントであり、同じスキーマインテリジェンスモデルを共有しています。Query Streams内で回答を得たい場合はNovaを、Claude内で他のすべての操作と並行してデータを使用したい場合はMCPを使用してください。