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

MCP · PostgreSQL から Claude へ

聞く クロード PostgreSQLデータベースについて、 平易な英語で

Connect claude.ai, Claude Desktop, ChatGPT, Cursor or any MCP client to Query Streams once. Your AI client asks; the Agent that already sits with your PostgreSQL database, its partner inside your network, does the heavy lifting: it runs the SQL read-only, and on paid plans it also sizes, profiles and holds results so follow-ups need no second query. No database password ever reaches the AI. About ten minutes, and the Free plan covers it.

約10分 Claude、ChatGPT、Cursor、その他11社のクライアント データはあなたのネットワーク上に留まります 読み取り専用、常に

最終的に手に入るもの

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

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

中身は？ お客様 私のPostgreSQLデータベースで、いくつかの行を表示して、各列の意味を教えてください。

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

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

顧客ID	名称	市
1042	ノースウィンド・トレーダーズ	シアトル
1057	アルパイン・アウトフィッターズ	デンバー
1063	ハーバーフーズ	ハリファックス

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

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

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クライアントを一切接続したくないですか？ 事業計画書では、 ノヴァ is the assistant built into Query Streams itself. It uses the same Agent toolset your AI client gets here, plus what an outside client does not: it drafts and validates the SQL against your Semantic Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

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

必要なもの

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

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

PostgreSQLはエージェント経由で接続されます

PostgreSQLデータベースのある場所にエージェントをインストールし、データエージェントに接続を追加しました。まだ完了していませんか？ まずPostgreSQLに接続します。所要時間は約10分です。

MCPが起動しました

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

AIクライアント

Chat apps such as claude.ai, Claude Desktop and ChatGPT connect with no key. Claude Code, Cursor, VS Code and about ten other tools use a key; the Portal’s Connect an AI client guide sets up each one.

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

1. ポータルでMCPを開く

   サインインはこちら my.querystreams.com そして開く ストリーム → ライブ → MCPこのページには4つのタブがあります。 コネクション, Context, ツール そして、管理者向けには、 活動. Check the Semantic Intelligence panel on コネクション while you are here: it lists your PostgreSQL connector and whether Semantic Intelligence has run on it. Complete coverage is what lets Claude write correct PostgreSQL SQL on the first try.

   Open MCP

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

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

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

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

   claude.ai、Claude Desktop、ChatGPT

   In claude.ai and Claude Desktop, open the Query Streams listing in Anthropic’s Connectors Directory, click 接続する and approve. Adding it by URL, https://mcp.querystreams.com/mcp, is the fallback. In ChatGPT you add Query Streams from the app (developer mode for now) and sign in with Query Streams. Either way a Query Streams page opens: pick the organization and the permissions and click 接続を承認する. Nothing to copy. The connection appears on the コネクション tab and can be revoked there.

   開発者ツール・鍵

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

   On the MCP page click Connect an AI client. The guide asks How will your AI client connect?: choose Use a key in a config file, pick your tool, then Generate a key for it: a キー名, 読む そして Run queries ticked, an 有効期限 (Never, 30 days, 90 days or 1 year). Set it up shows the snippet with the key filled in, and Check the connection waits for the first call.

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

   読む

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

   Run queries

   Run read-only SQL and saved queries through your Agent and return the rows. Without it your AI client can describe your data but not answer from it.

   分析

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

   鍵をなくした？ It is listed on the コネクション tab: Reveal full key shows it again and 完全なキーをコピー それをコピーします。ノートパソコンが紛失した場合は、そこで取り消してください。そうすれば、それを使用しているすべてのクライアントは、約5分以内に次の呼び出しで失敗します。

3. クロードとつながる

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

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

   1. 開く Query Streams listing in Anthropic’s Connectors Directory and click 接続する. In Desktop it then sits under + → コネクター.
   2. Fallback, if your organization hides directory connectors: Settings → Connectors → Add custom connector, name クエリストリーム, URL https://mcp.querystreams.com/mcp, OAuth fields empty, 追加; then in a chat + → クエリストリーム → 接続する.
   3. クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして Run queries任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
   4. Claudeに戻ると、「クエリ ストリームに接続済み」と表示されます。Claudeがツールを初めて使用すると、次の質問が表示されます。 常に許可する.

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

   クロード・コード 鍵

   One command, with your key from the Connections tab:

   ターミナル

   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ステータスバーに表示されます。

   他のものを使っていますか？ The Portal’s Connect an AI client guide 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. 最初の質問をしてください

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

   「私のPostgreSQLデータベースにはどのようなデータが含まれていますか？」

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

   「顧客データから10行分を表示して、各列について説明してください。」

   Claude reads the table structure first (Read), then runs one SELECT through your Agent (Run queries) and describes what name and city mean.

   「顧客は都市ごとに何列持っていますか？最も列数が多い都市はどこですか？」

   クロードはPostgreSQLの方言でGROUP BY句を記述し、実行して、小さな表を添えた一文で回答します。同じチャットでフォローアップすれば、会話の文脈が維持されます。

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる qs_list_connectors, the Portal guide’s Check the connection step says 接続済み, and the key or app on the コネクション tab shows its 最終使用日時 time within a few seconds.

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

Your AI client sees the Query Streams tools; it picks the right one for your question. The Portal’s ツール タブ lists all 38 tools and modes with what your plan includes. On every plan, Free included:

The Analytic toolset. On paid plans the Agent does the groundwork where your PostgreSQL database lives, so your AI client spends its attention on the thinking. Free works as it always has.

The defaults live on the Context タブ: text cell limit, schema view, result size, analysis defaults and held results.

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

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

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

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

MCP is on every plan, including Free, with no separate fee. What each plan sets is how many keys or connected apps you can hold and how many calls a minute your AI client may make:

A connected app counts as a key. On top of the per-minute figure, any one key may run at most 10 queries a minute. A query runs for up to 60 seconds unless your AI client asks for more, up to five minutes. Your plan also sets how many rows one query returns and, with the Analytic toolset, how long and how large a held result may be; the full MCP guide lists every plan. The rows your AI client receives count against your Data Realm allowance, the same pool your Excel and Sheets queries use, and MCP is measured the same way as your spreadsheet queries. Semantic Intelligence runs started from Claude spend Nova AI credits, exactly as they do from the Portal. 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

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

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

人々が尋ねる質問

関連ガイド

• Microsoft SQL Server を MCP を使用して Claude に接続します
• MCPを使用してMySQLをClaudeに接続する
• Microsoft AccessをMCPを使用してClaudeに接続する
• MCPを使用してSQLiteをClaudeに接続する
• MCP を介してクエリ ストリームを Claude に接続する: セットアップ、権限、およびトラブルシューティング
• PostgreSQLをGoogleスプレッドシートに接続する方法
• すべてのMCPガイド