MCPを使用してHeroku PostgresをClaudeに接続する

MCP · HerokuからClaudeへ

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

Claude、Claude Code、Cursor、または任意のMCPクライアントをQuery Streamsに一度接続するだけで、ClaudeがHerokuデータベースの構造を読み取り、SQLを生成し、データが格納されているエージェントを通して読み取り専用で実行し、結果の行を返します。データベースのパスワードがAIに渡ることは一切ありません。所要時間は約10分で、無料プランで利用可能です。

約10分 Claude、ChatGPT、Cursor、その他11社のクライアント 認証情報はあなたと共にあります 読み取り専用、常に

最終的に手に入るもの

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

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

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

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

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

Heroku Postgresは、Herokuが提供するマネージドPostgreSQLアドオンです。エージェントは、アプリのDATABASE_URLに指定された認証情報を使用して、インターネット経由でPostgreSQLに接続します。

必要なもの

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

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

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

エージェントは、常時稼働している任意のコンピュータにインストールされ、Heroku接続はデータエージェントに追加されます。

選ぶ Heroku Postgres ポータル内のカード。ポート5432とSSLが事前に設定されています。貼り付け データベースURL アプリから 設定 Config Vars の下のタブ、または heroku config:get DATABASE_URLホスト名、データベース名、ユーザー名、パスワードを入力してください。貼り付けた文字列はブラウザに残り、保存されることはありません。HerokuではSSLが必須なので、有効にしておいてください。

MCPが起動しました

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

AIクライアント

ウェブ版Claude、デスクトップ版Claude、モバイルアプリ版Claudeは、いずれもキー不要で接続できます。Claude Code、Cursor、ChatGPTなど、その他約10種類のツールも利用可能です。ポータルには、それぞれのツールに対応した設定が用意されています。

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

1. ポータルでMCPを開く

   サインインはこちら my.querystreams.com そして開く ストリーム → ライブ → MCPこのページには4つのタブがあります。 接続する, 接続されたアプリ, 私の鍵 そして、管理者向けには、 活動. 確認してください 私の鍵 サイドパネルをご覧ください。Herokuコネクタと、Semantic Intelligenceがそのコネクタ上で実行されたかどうかが表示されます。完全なカバレッジのおかげで、Claudeは初回で正しいHeroku SQLを作成できます。

   Open MCP

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

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

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

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

   claude.ai、Claude Desktop、ChatGPT

   Claudeでは、クエリ ストリームは 人間活動関連コネクタディレクトリコネクタを参照するには、クリックしてください。 接続する他の場所では、アプリにアドレスを1つ貼り付けます。 https://mcp.querystreams.com/mcpチャットから接続します。クエリ ストリーム ページが開くので、組織と権限を選択し、クリックします。 接続を承認するコピーするものも、秘密にしておくものもありません。接続は以下に表示されます。 接続されたアプリ そして、そこで取り消される可能性がある。

   開発者ツール・鍵

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

   の上 私の鍵 クリック キーを生成する. 与えて キー名 「私のラップトップ上のクロード・コード」など、 読む そして 実行する チェックを入れ、 有効期限 （なし、30日間、90日間、または1年間）をクリックして キーを生成するコピーしてから インストールを続行します: その 接続する タブには、キーが既に入力された状態で、お使いのツールに対応する正確なコードスニペットが表示されます。

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

   読む

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

   実行する

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

   分析

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

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

3. クロードとつながる

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

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

   1. 開く 設定 → コネクタ そしてクリック コネクタを参照するクエリ ストリームは、 人間活動関連コネクタディレクトリ： 探す クエリストリーム そしてクリック 接続する（またはディレクトリ一覧を直接開いてクリック） 接続する そこには。）
   2. 組織がディレクトリコネクタを非表示にしている場合は、クリックしてください。 カスタムコネクタを追加する 代わりに名前を付けてください。 クエリストリームペースト 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ステータスバーに表示されます。

   他のものを使っていますか？ の 接続する タブ 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. 最初の質問をしてください

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

   「HerokuのPostgresデータベースにはどのようなデータが格納されていますか？」

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

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

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

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

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

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる qs_list_connectors、そして 私の鍵 鍵は 最終使用日時 時刻は数秒以内に更新されます。接続されたアプリは以下に表示されます。 接続されたアプリ 接続された時間と最後に使用された時間。

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

クロードは19個の小さな道具を見分けます。あなたはそれらを自分で呼ぶ必要はありません。クロードがあなたの質問に最適な道具を選んでくれます。簡単に言うと、次のようになります。

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

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

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

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

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

接続されたアプリはキーとしてカウントされます。1 分あたりの数値に加えて、1 つのキーは 1 分間に最大 10 回のクエリを実行できます。クエリは最大 1,000 行を返し、Claude が追加を要求しない限り最大 60 秒実行され、最大 50,000 行、5 分までが上限です。Claude が受け取る行は、Excel および Sheets クエリが使用するのと同じプールである Data Realm の許容量にカウントされ、MCP は圧縮前に測定されるため、幅の広い結果はスプレッドシートの同じ行よりもコストが高くなります。Claude から開始された Semantic Intelligence の実行は、ポータルから開始された場合とまったく同じように Nova AI クレジットを消費します。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

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

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

人々が尋ねる質問

関連ガイド

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