SQLiteデータベースのフォルダをMCPを使用してClaudeに接続する

MCP · SQLiteフォルダをClaudeへ

聞く クロード SQLiteフォルダファイルについて、 平易な英語で

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

約10分 Claude、ChatGPT、Cursor、その他11社のクライアント ファイルは元の場所に残ります 読み取り専用、常に

最終的に手に入るもの

A Claude that can answer questions about a folder of SQLite database files with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

クロード · クエリ ストリームに接続済み 読み取り専用

各データベースファイルは、fileset.data_eventsに何行分のデータを提供しますか？

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

ファイルセット.データイベント 3つの店舗データベースからイベントテーブルを統合します。ダウンタウン店のデータベースが最も多くの行数を持っています。

_ソースファイル	行数	first_row_id
店舗/ダウンタウン/POS.db	58214	stores/downtown/pos.db:events:0000000
店舗/空港/POS.db	41377	stores/airport/pos.db:events:0000000
店舗/港湾/POS.db	29806	stores/harbor/pos.db:events:0000000

各店舗のイベントを日ごとに詳しく解説しましょうか？

Which stores had the most voided transactions this week, and is anyone an outlier?

qs_run_query qs_run_query

The store databases merge into one ファイルセット.データイベント table, so I counted voids against transactions per store in one query, then broke the outlier down by register:

store	Transactions	Voids	Void rate
downtown	18,204	212	1.2%
airport	12,910	148	1.1%
harbour	9,412	611	6.5%

Harbour voids five times as often as the other stores, and 540 of its 611 voids come from register 3 after 8 pm. Either a till problem or something to ask the evening shift about.

選択のみ、エージェントによる確認済み MCPアクティビティタブにログインしました 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, ノヴァ is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema 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.

の SQLiteフォルダ カードを使用すると、Claude は SQLite データベース ファイルのフォルダーを 1 つのデータベースとしてクエリできます。すべてのファイルで同じ名前のテーブルは、1 つのテーブルにマージされます。 データイベント、そして各行には、それがどのファイルから来たのかが示されます。手動でのATTACHやマージスクリプトはありません。エージェントは各ファイルを読み取り専用で開き、行を自身のコンピュータにキャッシュし、SQLとしてClaudeに提供します。

必要なもの

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

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

フォルダを開くことができるコンピュータ上のエージェント

バージョン2.6.0以降。フォルダは、そのコンピュータ上またはアクセス可能なファイル共有上に配置できます。エージェントはサービスとして実行されるため、共有を次のように入力します。 \\server\share\folderマッピングされたドライブレターとしてではなく。エージェントを初めて使用しますか？ Windowsにインストールしてください, macOS または Linux.

MCPが起動しました

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

AIクライアント

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

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

1. エージェントをフォルダーに指定してください

   ポータルを開く データ → データエージェントフォルダーを開くことができるエージェントを見つけてクリックします コネクタを追加する ボタン。 ファイルとフォルダ ピルクリック SQLiteフォルダ カード。その後、魔法使いがあなたを案内します。 フォルダー, チェック, 設定, レルム そして レビュー:

   フォルダー

   入力 ルートフォルダエージェントのコンピュータ上のパスとして、1行に1つずつ記述します。 サブフォルダーをスキャンする オンになっています、 最大深度 8です。 パターンを含める このファイルタイプに適したグロブから開始します。 パターンを除外する フォルダに不要なファイルが含まれている場合。マッピングされたドライブ文字にはオレンジ色の警告が表示されます。エージェントはそれを認識できないため、 \\server\share 代わりにパスを使用してください。

   チェック

   エージェントは最大64個のサンプルファイルを読み込み、構築予定の内容を表示します。現時点では何も作成されていません。 作成準備完了 これは、サンプリングされたすべてのファイルが適合することを意味します。「{m} 個のファイルのうち {n} 個が除外されます」という黄色のバナーは、適合しないファイルを一覧表示します。 どのファイルとその理由を表示するコネクタは作成して後で修正することもできます。フォルダにレイアウトが混在している場合は、青いパネルが表示されます。 レイアウトごとにテーブルを1つに切り替えます.

   設定

   スキャン間隔 （デフォルトでは1時間ごと、5分ごとから毎日まで）は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。

   レルム、レビュー

   行数がカウントされるデータレルムを選択し、概要を確認してクリックします。 コネクタを作成する最初のスキャンはすぐに開始されます。コネクタの マニフェスト タブには、作成されたものや保存されたファイルが表示されます。

   • ありません テーブル名 フィールド。メンバーテーブルは次のようなテーブルになります。 データイベント. 使用する 表 読み込むメンバーテーブルを選択するためのフィールド。
   • パターンを含める 始まりは **/*.db そして **/*.sqlite. -wal そして -ジャーナル データベースの隣にあるファイルは決して一致しない。
   • ありません テーブルレイアウト 選択肢。注記には、一致するすべてのファイルは同一のレイアウトを共有しなければならず、後で不一致が判明したファイルは隔離され、報告されると説明されている。
   • の上 チェックエージェントは最大64個のファイルをサンプリングし、構築するテーブルを一覧表示します。ファイルによって1つの列の型が異なる場合、オレンジ色のバナーに「スキーマスニッフィングが拒否されました」と表示され、その理由が示されます。

2. どんなテーブルが手に入るか見てみましょう

   すべてが ファイルセット スキーマ。テーブルには名前が付けられています。各メンバーテーブルは次のようになります。 データ_<名前>宣言された列の型は、ファイル間で一致している必要があります。

   テーブル	中身
   ファイルセット.データイベント	列の イベント 一致するすべてのデータベースファイルからのテーブル、それぞれにタグが付けられています _ソースファイル そして _row_id.
   ファイルセット.data_users	他のすべてのメンバーテーブル名についても同様で、名前ごとに1つのマージ済みテーブルが作成されます。
   ファイルセット.ファイル	現在存在するデータベースファイルごとに1行ずつ、パス、サイズ、更新日時を記載。
   ファイルセット.ファイルイベント	変更履歴には以下が含まれます 拒否した そして ドリフト 同意しないファイル名を指定する行。

   すべてのフォルダー コネクタは、クロードに同じ簿記テーブルも提供します。 ファイルセット スキーマ:

   テーブル	中身
   ファイル	フォルダ内のすべてのファイル：パス、ファイル名、拡張子、サイズ、作成日時、更新日時。「このフォルダには何が入っているの？」と尋ねると、クロードがこれを読み上げます。
   ファイルイベント	変更履歴: 出現、変更、消失、または保留されたファイルごとに 1 行 (ドリフト）時間とともに イベント_at そしてその理由は 詳細.
   ディレクトリ, ボリューム	フォルダのサイズと数、およびルートが存在するディスクまたは共有フォルダ。
   _ソースファイル, _row_id	各データ行には2つの列があります。1つは行の由来となるファイル、もう1つはそのファイル内の安定した行IDです。グループ化基準 _ソースファイル ファイルを比較する。

3. クロードとつながる

   開く ストリーム → ライブ → MCP入り口は2つあり、どちらも同じ場所にたどり着きます。

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

   claude.ai、Claude Desktop、ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click 接続する. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpチャットから接続します。クエリ ストリーム ページが開くので、組織と権限を選択し、クリックします。 接続を承認するコピーするものも、秘密にしておくものもありません。接続は以下に表示されます。 接続されたアプリ そして、そこで取り消される可能性がある。

   開発者ツール・鍵

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

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

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

   読む

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

   実行する

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

   分析

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

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

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

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

   1. 開く 設定 → コネクタ そしてクリック コネクタを参照する. Query Streams is listed in the Anthropic Connectors Directory: find クエリストリーム そしてクリック 接続する. (Or open the directory listing directly and click 接続する there.)
   2. If your organization hides directory connectors, click カスタムコネクタを追加する instead. Name it クエリストリームペースト https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click 追加, then in any chat click + → コネクタを参照する → クエリストリーム → 接続する.
   3. クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして 実行する任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
   4. Claudeに戻ると、「クエリ ストリームに接続済み」と表示されます。Claudeがツールを初めて使用すると、次の質問が表示されます。 常に許可する.

   If you do add it by hand in Claude Desktop, use 設定 → コネクタ → 追加チャット内ではなく マーケットプレイスを追加 option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   クロード・コード 鍵

   「マイキー」にあるキーを使って、以下のコマンドを実行してください。

   ターミナル

   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. 最初の質問をしてください

   まずはフォルダを開いて確認できるものから始めましょう。そうすれば、クロードが正しいテーブルに手を伸ばす様子がわかります。SQLiteデータベースファイルのフォルダでうまく機能する3つの例を以下に示します。

   「そのフォルダにはどのSQLiteファイルが含まれていますか？また、それぞれのファイルは最後にいつ変更されましたか？」

   クロードの質問 ファイルセット.ファイル （実行）すると、各データベースファイルが一覧表示されます。 サイズ（バイト） そして 修正済みUTC.

   「過去30日間のファイルごとに、fileset.data_eventsの行数をカウントしてください。」

   クロードはテーブルスキーマを読み込んで日付列を見つけ（読み取り）、次にDuckDBを実行します。 _ソースファイルでグループ化 エージェント（実行）を介して実行します。データベースファイルごとに1行が取得されます。

   「データベースファイルの中で、保留または拒否されたものはありましたか？その理由は？」

   クロードの質問 ファイルセット.ファイルイベント のために ドリフト そして 拒否した 行、 イベント_at （実行）ファイルと理由を取得する 詳細.

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

新規ファイル、変更ファイル、削除ファイルがどのように表示されるか

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

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

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

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

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

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

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

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

安全に保つ

良い次の動き

• スキーマインテリジェンスを実行する コネクタ上で設定することで、クロードがあなたのコラムの説明を見ることができるようになります。
• クロードにファイルを比較してもらうよう頼んでください。 各行には _ソースファイルつまり、1つのクエリで全てのデータベースの順位付けや比較を行うことができます。
• SQLiteフォルダガイドをお読みください で 複数のSQLiteデータベースファイルを結合する あらゆる場面に対応。

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

人々が尋ねる質問

関連ガイド

• CSVファイルのフォルダをMCPを使ってClaudeに接続する
• ExcelファイルのフォルダーをMCPを使ってClaudeに接続します。
• ParquetファイルのフォルダをMCPを使ってClaudeに接続する
• JSONLファイルのフォルダをMCPを使ってClaudeに接続する
• SQLiteフォルダコネクタガイド
• MCP を介してクエリ ストリームを Claude に接続する: セットアップ、権限、およびトラブルシューティング
• すべてのMCPガイド