Web サーバーログ → Claude · Query Streams を使用
Query Streams を使えば、Web Server Logs ファイルについて平易な英語で Claude に質問できます。ネットワーク内にすでに配置された Agent が SQL を読み取り専用で実行するため、データベースのパスワードが AI に渡ることはありません。所要時間は約10分で、Free プランで利用できます。
無料で始めよう
最終的に手に入るもの
Claudeは、nginx、Apache、IIS、またはCaddyのアクセスログに関する質問に、エージェントがファイルから構築するテーブルに対するリアルタイムの読み取り専用クエリで回答し、各回答がどのファイルから得られたかを通知します。ログイン情報やファイルパスを見る必要はなく、ファイアウォールを変更する必要もありません。ネットワーク内に既に存在するエージェントがフォルダを読み取り、行のみを返します。エージェントが配置されたら、設定画面に慣れていれば、Claudeへの接続は約90秒で完了します。例:
nginxのログに記録されている最新の5xxエラーを表示してください。
クロードは構造を読みます ファイルセット.イベント まず、エージェントを通して 1 つの SELECT を実行します。 ステータス 500以上、 イベント時間新しい順に表示されます。
| イベント時間 | パス | ステータス |
|---|---|---|
| 2026-09-25 14:02:11+00 | /api/checkout | 502 |
| 2026-09-25 13:58:47+00 | /api/cart/items | 504 |
| 2026-09-25 13:41:05+00 | /search?q=ブーツ | 500 |
クロードは イベント時間なので、ローテーションされたファイルからのリクエストは順番に並びます。フォローアップを尋ねてください。 クライアントIP ほとんど送った。
5xxエラーはどこから発生していますか?エンドポイント1つ、クライアント1つ、それともあらゆる場所から発生していますか?
私はグループ分けしました ファイルセット.イベント による パス 5xxレートで、最悪の経路を10分単位で分類しました。
| パス | リクエスト | 5xx | レート |
|---|---|---|---|
| /api/checkout | 88,210 | 1,904 | 2.2% |
| /api/cart | 142,004 | 61 | 0.04% |
| その他すべて | 2,108,442 | 88 | 0.004% |
これはエンドポイントの一つです。チェックアウト時に発生した502エラーのうち、40件を除くすべてが、コンテナログに記録されている2つのデプロイと一致する10分間の時間帯(14:00~14:10と16:30~16:40)に集中しています。これらの時間帯の間は、チェックアウトは正常に実行されました。
AIクライアントを一切接続したくないですか? 事業計画書では、 ノヴァ MCPはQuery Streams自体に組み込まれたアシスタントです。AIクライアントがここで利用できるエージェントツールセットと同じものを使用するだけでなく、外部クライアントでは利用できない機能も備えています。つまり、セマンティックインテリジェンスモデルに対してSQLをドラフトして検証し、結果をグラフに変換し、結果をExcel、Google Sheets、またはREST APIから実行できるクエリとして保存します。キーもコネクタもインストールも不要です。Claude、Cursor、またはChatGPTを既に利用している場合はMCPを、ポータル内で回答を取得したい場合はNovaを使用してください。
Web Server Logsは、nginxログ、Apacheアクセスログ、IISログ、Caddyログをリクエストごとに1行のテーブルに変換し、Claudeがトラフィックやエラーに関する質問に答えられるようにします。接続するサーバーはありません。エージェントは、ログフォルダを開くことができるコンピューター上のログフォルダを読み取り、そこに行をキャッシュします。ファイルサイズが大きくなるにつれて監視され、ローテーションまたはgzip圧縮されたファイルも認識されるため、リクエストが二重にカウントされることはありません。
必要なもの
クエリストリームアカウント
MCPは無料プランを含むすべてのプランで利用可能です。無料プランではキー1つまたは接続アプリ1つが利用できますが、このガイドに必要なのはそれだけです。サインアップはこちらから my.querystreams.com.
フォルダを開くことができるコンピュータ上のエージェント
バージョン2.6.0以降。フォルダは、そのコンピュータ上またはアクセス可能なファイル共有上に配置できます。エージェントはサービスとして実行されるため、共有を次のように入力します。 \\server\share\folderマップされたドライブレターとしてではなく。Windowsでは、保存したログイン情報を使用して共有にサインインできます。LinuxまたはMacでは、まず共有をマウントします(Linuxでは /月 または /メディアMac 1台 /巻) エージェントを初めてご利用ですか? Windowsにインストールしてください, macOS または Linux.
MCPが起動しました
作成者、所有者、管理者は最初からそれを持っています。他のすべての人は、管理者に切り替えてもらう必要があります。 MCP 名前の横にあるスイッチ アカウント → アクセス制御それまでは、MCPページには「お客様のアカウントではMCPが無効になっています」と表示されます。
AIクライアント
ウェブ版Claude、デスクトップ版Claude、モバイルアプリ版Claudeは、いずれもキー不要で接続できます。Claude Code、Cursor、ChatGPTなど、その他約10種類のツールも利用可能です。ポータルには、それぞれのツールに対応した設定が用意されています。
作業はどこで行われますか? エージェントが動作するコンピュータ上で、フォルダをスキャンし、行をローカルキャッシュにコピーして、クロードが作成したSQL文をそのキャッシュに対して実行します。ファイル自体はそのコンピュータから決して外部に持ち出されることはなく、クロードが要求していないものも外部に持ち出されることはありません。
4つのステップで設定できます
-
エージェントをフォルダーに指定してください
ポータルを開く データ → データエージェントフォルダーを開くことができるエージェントを見つけてクリックします コネクタを追加する ボタン。 ファイルとフォルダ ピルクリック ウェブサーバーログ カード。その後、魔法使いがあなたを案内します。 フォルダー, チェック, 設定, レルム そして レビュー:
- フォルダー
- 入力 ルートフォルダエージェントのコンピュータ上のパスとして、1行に1つずつ記述します。 サブフォルダーをスキャンする オンになっています、 最大深度 8です。 パターンを含める このファイルタイプに適したグロブから開始します。 パターンを除外する フォルダに不要なファイルが含まれている場合。マッピングされたドライブ文字にはオレンジ色の警告が表示されます。エージェントはそれを認識できないため、
\\server\share代わりにパスを使用してください。 - チェック
- エージェントは最大64個のサンプルファイルを読み込み、構築予定の内容を表示します。現時点では何も作成されていません。 作成準備完了 これは、サンプリングされたすべてのファイルが適合することを意味します。「{m} 個のファイルのうち {n} 個が除外されます」という黄色のバナーは、適合しないファイルを一覧表示します。 どのファイルとその理由を表示するコネクタは作成して後で修正することもできます。フォルダにレイアウトが混在している場合は、青いパネルが表示されます。 レイアウトごとにテーブルを1つに切り替えます.
- 設定
- スキャン間隔 (デフォルトでは1時間ごと、5分ごとから毎日まで)は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。
- レルム、レビュー
- 行数がカウントされるデータレルムを選択し、概要を確認してクリックします。 コネクタを作成する最初のスキャンはすぐに開始されます。コネクタの マニフェスト タブには、作成されたものや保存されたファイルが表示されます。
- 選ぶ ログタイプ お使いのサーバーに合ったコネクタを使用してください。プロファイルによって列が異なるため、ログフォーマットごとにコネクタを1つ使用してください。
- のみ カスタムログフォルダ このカードでは、独自のフォーマットを定義できます。リストの下には、「リストにないログタイプが必要ですか?サポートリクエストを送信してください。数日以内に追加します。」と記載されています。
- テーブル名 オプションであり、デフォルトは
イベント. 埋め戻し(日数) 30歳で イベントをN日間保持する 60です。 - の上 チェックエージェントはサンプルを読み込み、ファイル、サイズ、行数の推定値を表示します。ファイルがログタイプと一致しない場合、見出しには「これらのファイルは」と表示され、その後にタイプが表示されます。別のタイプを選択してクリックします。 もう一度テストしてください.
-
どんなテーブルが手に入るか見てみましょう
リクエストは
イベントnginxとApacheを組み合わせたプロファイルはサイト,クライアントIP,認証,方法,パス,http_version,ステータス,バイト,紹介者そしてエージェントブラウザ文字列はエージェントIIS W3C ログは、次のような独自の名前を保持します。c_ip,cs_uri_stemそしてsc_status.テーブル 中身 イベントリクエストごとに1行、 イベント時間プロフィールの列、_ソースファイルそして_行番号.イベント_生の行解析されなかった行は、 ラインそして理由例えば、文法が一致しないなど。ファイルエージェントが読み取るアクセスログファイル。パス、サイズ、更新日時が含まれます。 ファイルイベントファイル履歴(回転、書き換え、切り捨てなどのイベントを含む)。並べ替え基準 イベント_at.ログカーソル各ファイルの読み取り位置と状態。保留中のファイルは、理由とともに状態「parked」を表示します。 最後のエラー.すべてのフォルダー コネクタは、クロードに同じ簿記テーブルも提供します。
ファイルセットスキーマ:テーブル 中身 ファイルフォルダ内のすべてのファイル:パス、ファイル名、拡張子、サイズ、作成日時、更新日時。「このフォルダには何が入っているの?」と尋ねると、クロードがこれを読み上げます。 ファイルイベント変更履歴: 出現、変更、消失、または保留されたファイルごとに 1 行 ( ドリフト)時間とともにイベント_atそしてその理由は詳細.ディレクトリ,ボリュームフォルダのサイズと数、およびルートが存在するディスクまたは共有フォルダ。 _ソースファイル,_row_id各データ行には2つの列があります。1つは行の由来となるファイル、もう1つはそのファイル内の安定した行IDです。グループ化基準 _ソースファイルファイルを比較する。 -
クロードとつながる
開く ストリーム → ライブ → MCP入り口は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クライアントはデータの説明はできますが、データに基づいて回答することはできません。
- 分析
- テーブルをプロファイリングし、関係を検出して、Semantic Intelligenceの実行をキューに追加します。プロファイリングと検出は無料です。Semantic Intelligenceの実行ではNova AIクレジットとデータ利用枠を消費するため、同意画面であらかじめ選択されることはありません。
鍵をなくした? それはリストされています コネクション タブ: 完全なキーを表示する それを再び表示して 完全なキーをコピー それをコピーします。ノートパソコンが紛失した場合は、そこで取り消してください。そうすれば、それを使用しているすべてのクライアントは、約5分以内に次の呼び出しで失敗します。
次に、使用するクロードのレシピを選択してください。サーバーアドレスはどこでも同じです。
https://mcp.querystreams.com/mcp.ウェブ版クロード、デスクトップ版クロード、モバイル版クロード キーなし
- 開く クエリ ストリーム一覧 Anthropicのコネクタディレクトリでクリックして 接続するデスクトップでは、その下に配置されます。 + → コネクター.
- 組織がディレクトリコネクタを非表示にしている場合の代替策: 設定 → コネクタ → カスタムコネクタを追加、 名前 クエリストリーム、URL
https://mcp.querystreams.com/mcpOAuthフィールドが空です。 追加;それからチャットで + → クエリストリーム → 接続する. - クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして クエリを実行する任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
- 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。 追加--スコープ ユーザーすべてのプロジェクトにクエリ ストリームを持たせる。/mcpClaude 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キー(アン)認証:所持者同じキーを持つヘッダーでも機能します。 -
最初の質問をしてください
まずはフォルダを開いて確認できるものから始めましょう。そうすれば、クロードが正しいテーブルに手を伸ばす様子がわかります。nginx、Apache、IIS、またはCaddyのアクセスログでうまく機能する3つの例を以下に示します。
- 「エージェントはどのアクセスログファイルを読み込んでいるのか、そして今週ローテーションされたのはどのファイルなのか?」
- Claudeはfileset.filesと、files_events内のローテーションされた行を、最新のevent_atから順にリストします。
- 「過去7日間で404エラーを返した上位20の経路は何ですか?」
- Claudeは、ステータスとイベント時刻に基づいてイベントをフィルタリングし、パスごとにグループ化して、件数を返します。
- 「解析されなかったログ行はありましたか?また、その理由は?」
- Claudeはevents_raw_linesテーブルの行数を理由別にカウントし、例となる行を表示します。
配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか?」クロードが電話をかけてくる
qs_list_connectorsポータルガイドの 接続を確認してください ステップにはこう書いてある 接続済み、キーまたはアプリ コネクション タブには、 最終使用日時 数秒以内の時間。
それでおしまい。 フォルダに新しいファイルをドロップするだけで、次のスキャン後にはクロードがそのファイルから回答できるようになります。ファイルは元のコンピュータから持ち出されることはなく、AIにパスワードを入力する必要もありません。
ネットワーク共有上のファイルにアクセスする
エージェントは、ユーザーとしてではなく、バックグラウンドサービスとしてファイルを開くため、別のコンピューター上のファイルを開くには追加の手順が必要です。どの手順が必要かは、エージェントが実行されているコンピューターによって異なります。
テストで共有フォルダにアクセスできない場合は、結果の中に以下の単語を探してください。 到達不能 エージェントのコンピュータがサーバーから応答を受け取らなかったことを意味します。Linux または Mac では、 取り付けられていません これは、共有フォルダがまだマウントされていないことを意味し、そのメッセージにはサーバー用の正確なマウントコマンドが含まれています。
共有フォルダ上のフォルダ? Windowsでは、1つのログインで同じサーバーから追加したすべてのフォルダーをカバーできます。 変更を監視するフォルダ これも共有ベースで動作し、ベストエフォート方式で動作します。スケジュールされたスキャンによって、すべての変更が確実に検出されることが保証されます。
新規ファイル、変更ファイル、削除ファイルがどのように表示されるか
新規ファイルと変更されたファイル
毎回 スキャン間隔 エージェントは、各ファイルのサイズと更新日時を台帳と比較します。サイズが合う新しいファイルが追加され、変更されたファイルは全体が再読み込みされるため、テーブルに同じファイルの2つのバージョンが保持されることはありません。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応する。
削除されたファイル
ファイルが消えると、行が削除されます。 行を保持し、削除済みとしてマークする共有がオフラインになり、ほとんどのファイルが一度に消えてしまった場合でも、エージェントはすべてを削除するのではなく、最後に正常に動作していたインベントリを保持します。
保管ファイル
レイアウトに合わないファイル、開けないファイル、またはロックされているファイルは除外されます。その行は読み込まれず、 ファイルイベント どのファイルで、なぜ変更されたのかを記録します。次回変更があった際には自動的に再試行されます。再スキャンボタンはありません。
クロードが見たもの
データは前回のスキャン時点のものです。MCPツールはスキャンをトリガーしないため、「これはいつ最後に更新されましたか?」と尋ねると、クロードが最新のデータを読み上げます。 イベント_at で ファイルイベント あなたのために。
接続されたクロードができること
AIクライアントはクエリストリームツールを認識し、質問に最適なツールを選択します。ポータルの ツール タブ プランに含まれるすべてのツールとモードを一覧表示します。Query Streams は、クエリを実行する前にAIクライアントに各テーブルの列を読み取らせるため、推測ではなく実際の名前を使ってクエリを作成できます。Freeを含むすべてのプランで利用できます:
データをマッピングする
コネクタ、データベース、エージェント。Semantic Intelligenceの実行後、Webサーバーログファイルのテーブルと列、説明、サンプル値、結合情報などが含まれます。
プロフィールと探索
列でフィルタリングする前にプロファイリングし、誰も定義していない結合を見つけましょう。ライブ実行にはAnalyzeが必要です。
読み取り専用のSQLを実行する
Webサーバーログ用の適切な方言によるSELECT文。デフォルトでは60秒、最大5分。実行プランで、1つのクエリが返す最大行数を設定できます。(クエリの実行)
保存されたクエリ、フェデレーション、およびアラート
チームが信頼する保存済みのクエリを新しい値で実行してください。フェデレーションされたクエリは既に結合された状態で返されます。アラートルールを確認し、試運転として1つ作成してください。
分析ツールセット。 有料プランでは、エージェントがWebサーバーログファイルの保存場所などの基礎的な作業を行うため、AIクライアントは思考処理に専念できます。無料プランはこれまで通り動作します。
コンテキスト管理
パーソナルコアとアップ結果を読み取る前にサイズを合わせる(形)、大きなデータベースを領域ごとに走査します(レベル)、そして回答はトークン予算内に収め、 列 そして、細胞の長さも必要となる。
デフォルトは コンテクスト タブテキストセルの制限、スキーマビュー、結果サイズ、分析のデフォルト設定、および保留された結果。
AIクライアントの応答でツール名を認識したい場合は、ツール名を指定してください。
| 許可 | ツール |
|---|---|
| 読む | qs_list_organizations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships qs_profile_table qs_discover_relationships qs_list_saved_queries qs_alerts qs_result (op=windows) |
| 分析 | qs_request_si_analysis qs_setup_si qs_get_task_status、Analyzeを利用できるキーにのみ表示されます。ライブ実行の qs_profile_table そして qs_discover_relationships |
| クエリを実行する | qs_run_query qs_run_saved_query qs_data_freshness qs_result (その他すべてのop) qs_result_release qs_create_alert_rule (提案のみ) |
セマンティックインテリジェンスがここで重要な理由
クロードが受け取るすべての回答には、その構造がどこから来たのかという情報がタグ付けされており、クロードはそれに基づいて、目にしたものに対する信頼度を調整する。
| ティア | クロードが見たもの | 結果 |
|---|---|---|
| セマンティックインテリジェンス | 各テーブルと列の説明、サンプル値、列挙型の意味、宣言済みおよび検出された結合。 | クロードは、WebサーバーログのSQLを初回から正しく記述し、データをビジネス用語で分かりやすく説明してくれます。 |
| キャプチャされたスキーマ | テーブル名、列名、型、キー。 | クロードは仕事をしているが、名前から意味を推測し、必要に応じて追加の質問をするかもしれない。 |
| ライブスキーマ | データベースはコネクタのキャプチャ選択範囲外にあるため、構造はリクエストごとにリアルタイムで読み取られます(クエリ実行権限が必要です。SQL Server、MySQL、PostgreSQLに対応)。 | クエリは引き続き実行されます。Claudeは、より多くのクエリが必要な場合、小さなSELECT文を使って探索を行います。 |
データベースが重要な場合は、Semantic Intelligence を一度実行してください。 ノヴァ → インテリジェンス. コネクション タブには、コネクタごとのカバレッジパネルが表示されます。 セマンティックインテリジェンスの仕組み.
計画で許可されている内容
MCPは無料プランを含むすべてのプランに含まれており、追加料金はかかりません。各プランで設定できるのは、保持できるキーまたは接続アプリの数と、AIクライアントが1分間に発信できる通話の数です。
| プラン | ユーザーごとのキー数 | 組織ごとのキー | 1分あたりの通話数 |
|---|---|---|---|
| 無料 | 1 | 1 | 30 |
| 個人的な核心 | 1 | 1 | 60 |
| パーソナルプラス | 1 | 1 | 90 |
| ビジネスコア | 2 | 3 | 120 |
| ビジネスプラス | 3 | 5 | 150 |
| ビジネスマックス | 5 | 10 | 240 |
| エンタープライズコア | 5 | 25 | 300 |
| エンタープライズプラス | 8 | 50 | 450 |
| エンタープライズマックス | 10 | 100 | 600 |
接続されたアプリはキーとしてカウントされます。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クレジットが消費されます。 価格ページをご覧ください 手当のために。
安全に保つ
読み取り専用、エージェントによる確認済み
実行されるのはSELECT文のみです。チェックはエージェントを実行しているコンピュータ上で行われ、WebサーバーのログファイルにSQLが記録される前に実行されるため、AIクライアントが書き込んだ内容がデータを変更することはありません。
AIに認証情報はありません
Webサーバーログのログイン情報はエージェント上に保持されます。Claudeはクエリストリームのキーまたは接続情報を保持しており、これはMCPページから取り消すことができます。変更は約5分以内に反映されます。
すべて記録されます
すべてのツール呼び出しはMCPに表示されます 活動 タブとクエリ履歴内のすべてのクエリは、クライアントタイプMCPとして記録され、そのクエリを実行したキーまたは接続の所有者に紐付けられます。SQLテキストとキー自体はアクティビティログには書き込まれません。
AIプロバイダーが受け取るもの
テーブル名と列名、サンプル値を含むセマンティックインテリジェンスの説明、および要求したクエリの行。分析ツールセットでは、多くの場合、代わりにサイズの見積もり、プロファイル、または保留された結果の回答が返され、完全な結果はエージェントに保持されます。エージェントが取得したデータは、接続したAIプロバイダーの規約に基づいて、そのプロバイダーに送信されます。クエリストリームは、チャットの内容を見ることはありません。
良い次の動き
- セマンティックインテリジェンスを実行する コネクタ上で設定することで、クロードはあなたの列の平易な英語の説明を受け取ることができます。ファイルテーブルには既に説明が組み込まれています。
- スキャン間隔を短くする より最新の交通情報を取得するには、以下の設定をご利用ください。デフォルトは1時間ごと、最短は5分ごとです。
- コネクタのファイルダイアログを開きます。 各ログファイルとその保存理由を確認するには、コネクタ一覧でこのコネクタを「ログファイル」として表示します。
何かがうまくいかないとき
| あなたが見るもの | それはどういう意味か | 修理 |
|---|---|---|
| お使いのAIクライアントにはクエリストリームツールが表示されません | コネクタは追加されたものの接続されなかったか、キーが間違った場所に貼り付けられた可能性があります。 | クロードでは: + → クエリストリーム → 接続する開発者ツールの場合:再起動してから、 接続を確認してください Portalガイドに記載されています。 |
MCP_KEY_REQUIRED または401 | キーがサーバーに到達しませんでした。これは通常、コピー&ペーストによる不要な改行、またはキーが間違ったヘッダーに含まれていることが原因です。 | 接続タブからキーを再度コピーして送信します。 X-MCPキー ヘッダ。 |
MCP_USER_DISABLED | 管理者があなたのユーザーに対してMCPを無効にしました。 | 彼らに MCP スイッチを再びオンに アカウント → アクセス制御. |
MCP_SCOPE_REQUIRED または MCP_SCOPE_DENIED | キーまたは接続に、その操作(通常はクエリの実行)を実行する権限がありません。 | 接続タブでキーを編集し、チェックを入れる クエリを実行するまたは、アプリを再接続して承認してください。 |
MCP_KEY_ORG_LIMIT_EXCEEDED | ご利用のプランのキー使用制限に達しました。無料プランでは、キー1個または接続可能なアプリ1個までが制限となります。 | 使わなくなったプランは解約するか、上位プランにアップグレードしてください。 |
MCPエージェントが接続されていません または MCPエージェント未登録 | お客様のWebサーバーログファイルを所有するエージェントが現在接続されていません。 | 開く データ → データエージェント そして、そのコンピューター上でエージェントを起動する。 |
MCP_DATABASE_NOT_CAPTURED | このデータベースはコネクタのキャプチャ選択範囲外にあるため、スキーマやセマンティックインテリジェンスは保存されていません。ただし、クエリは引き続き機能します。 | コネクタのキャプチャ選択に追加してから、より詳細な回答が必要な場合はセマンティックインテリジェンスを実行してください。 |
MCP_RATE_LIMITED | ご利用のプランで1分あたりの呼び出し回数が多すぎるか、1つのキーに対して1分間に10回以上のクエリが実行されています。 | ちょっと待ってください。セマンティック・インテリジェンスのおかげで、クロードはより少ない回数で応答できます。 |
MCP_QUERY_TIMEOUT または MCP_出力が大きすぎます | クエリの実行時間がタイムアウトしたか、またはAIクライアントが1回の応答で処理できる量を超えるデータが返されました。 | 行数や列数を減らすか、日付フィルターを適用するように要求してください。コンテキスト管理機能のあるプランの場合は、まず結果のサイズを調整するように要求してください。 |
MCP_DATA_REALM_EXHAUSTED | 貴組織の当該期間のデータ通信量上限に達しました。 | 利用限度額がリセットされるまで待つか、ポータルからチャージしてください。 |
MCP_機能_含まれていません | お客様のプランには、コンテキスト管理、結果分析、または詳細分析が含まれていないか、あるいはこのキーまたは組織に対してこれらのツールが無効になっています。 | AIクライアントにツールなしで続行するように指示するか、プランを上位に上げるか、管理者にツールを有効にするように依頼してください。 |
MCP_RESULT_EXPIRED | 保留されていた結果はもはや保留されていません。有効期限が切れたか、解放された(新しい結果のためのスペースを確保するために早期に解放される場合もある)、またはエージェントが再起動されたためです。 | AIクライアントに、クエリを保留状態で再度実行するように指示してください。 |
MCP_WINDOW_BUDGET | エージェントは現在、そのサイズの結果を保持できません。または、後続の処理に必要なメモリ容量が、エージェントが許容する容量を超えています。 | 保留中の結果を解放するか、フィルターまたは列数を減らしてクエリを絞り込みます。 |
MCP_AGENT_ANALYSIS_DISABLED | そのエージェントまたはコネクタでは、保留中の結果と分析が無効になっています。 | 管理者にオンにするように依頼してください 局所分析 データエージェントのページで設定するか、コネクタで分析を許可します。 |
MCP_WINDOW_SQL_拒否 | フォローアップは、保持された結果に対する読み取り専用の SELECT 文ではなく、結果に存在しない列名を指定するものでもありません。 | 結果に対して、列名を使用して1つのSELECT文を実行するように要求してください。 |
MCP_AGENT_VERSION_TOO_OLD | エージェントは、結果を形成、プロファイリング、保持、または分析する前に、アップデートが必要です。 | エージェントを更新します データ → データエージェントその間、通常のクエリは引き続き機能します。 |
| 読み取り専用違反 | そのSQLはSELECT文ではありませんでした。 | 設計上の仕様です。MCPを通して書き込みを行うことはできません。 |
人々が尋ねる質問
ローテーションされ、gzip圧縮されたログは2回読み込まれるのか?
いいえ。回転ファイルは最初の 4 KB で認識され、同じストリームが継続されます。各 .gz メンバーは一度読み込まれ、zip および cab アーカイブはスキップされます。 ファイルイベント テーブルには、各回転が回転イベントとして記録されます。
最初の読み取りはどのくらい遡って行われ、リクエストはどのくらいの期間保持されますか?
最初の読み取りは30日前に遡り、 埋め戻し(日数)1 ファイルあたり最大 64 MiB を読み取ります。その後、スキャンごとに新しい行が取得されます。Web サーバー ログは、デフォルトで 60 日間イベントを保持します。 イベントをN日間保持する.
解析できなかった行はどうなりますか?
それらは保管されています イベント_生の行 元の行と、no-grammar-match などの理由とともに。何も削除されません。解析されていない行が多いということは、通常は ログタイプ サーバーのログ形式と一致しません。
クロードは私のファイルを読むのか?
いいえ。エージェントは自身のコンピュータ上でデータを読み込み、ローカルキャッシュにその行を保持します。クロードはクエリストリームにSQLを送信し、エージェントはそのキャッシュに対してSQLを実行し、クエリに必要な行のみが返されます。クロードはファイルを開くことはなく、ファイルを変更、移動、削除することもできません。
ポートを開放したり、VPNを実行したりする必要はありますか?
いいえ。エージェントはポート443で1つの送信接続を確立し、リクエストと行の両方がその接続を介して送信されます。送信HTTPSが正常に動作すれば、この方法も機能します。
そのフォルダはネットワーク共有上、またはOneDriveやDropbox上にあっても構いませんか?
エージェントのコンピュータがそれを開ける限り、共有は機能します。次のように入力します。 \\server\share\folderエージェントはサービスとして実行されるため、ログイン時にマッピングされたドライブを認識できません。Windows では、フォルダーの共有ログインを追加します。 資格証明書 共有フォルダへのアクセスを指定されたユーザーのみに制限する場合は、この列を使用します。Linux または Mac では、まず共有フォルダをマウントしてください (保存されたログイン情報は使用されません)。同期されたクラウドフォルダの場合は、このデバイスにファイルを保持するように設定してください。エージェントはクラウドのプレースホルダーファイルをスキップします。
無料プランで本当にこれがカバーされるのですか?
はい。無料プランは、期限切れの試用版ではなく、継続して利用できるプランです。MCPはすべてのプランに含まれています。無料プランでは、キー1つまたは接続アプリ1つ、1分あたり30回の通話が可能です。フォルダコネクタ自体にはファイル制限はありません。無料プランに含まれる内容については、 価格ページ.
Claude以外に、どのようなAIツールが使えますか?
HTTP 上で MCP と通信できるものであれば何でも、ChatGPT、Cursor、Copilot を搭載した VS Code、Visual Studio、OpenAI Codex CLI、Gemini CLI、Windsurf、Zed、Cline、Continue.dev、JetBrains AI など、Portal の「AI クライアントを接続する」ガイドにすぐに使える手順が用意されています。
関連ガイド
すべてのガイド Web Logs
あなたの設定とは少し違いますか?
- ログのフォーマットが既製のログタイプに含まれていない場合は、カスタムログフォルダを使用してフォーマットを自分で定義できます → Custom Logs
設定に問題がありますか?
- エージェントがファイルまたはフォルダが存在しない、またはアクセスが拒否されたと報告しますか?マップされたドライブ、ネットワーク共有、OneDrive、Linuxホームフォルダそれぞれに修正が必要です → エージェントがファイルを読み取ることができる場所
- エージェントがオフラインと表示される、または接続テストと参照がグレー表示されている場合?エージェントがオンラインであることを確認してください → エージェントはオンラインですか?


