> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# querying.ai MCPサーバーでAIエージェントを接続する

> Claude Code、Codex、その他のMCPクライアントに、AIエンジンへの問い合わせ、ページのスクレイピング、プロンプト調査、GEOモニターの管理を行うツールを提供します。

querying.ai のMCPサーバーは、APIを [Model Context Protocol](https://modelcontextprotocol.io/) のツールとして公開します。REST APIと同じエンジン、キュー、結果の形、APIキーを使い、キーやタスクを保存しません。

| | |
| - | - |
| エンドポイント | `https://mcp.querying.ai/mcp` |
| トランスポート | Streamable HTTP |
| 認証 | `Authorization: Bearer <API key>` |

## クライアントを接続する

まずキーを環境変数 `QUERYING_API_KEY` に設定してください。キーは [APIキー](https://querying.ai/dashboard/keys) で取得できます。

**Claude Code**

```bash theme={"theme":"css-variables"}
claude mcp add --transport http querying \
  https://mcp.querying.ai/mcp \
  --header 'Authorization: Bearer ${QUERYING_API_KEY}'
```

シングルクォートのままにしてください。ダブルクォートにするとシェルがキーを一度展開し、Claude Code はその値を設定ファイルに保存します。

**Codex**

`~/.codex/config.toml` に追加します。

```toml theme={"theme":"css-variables"}
[mcp_servers.querying]
url = "https://mcp.querying.ai/mcp"
bearer_token_env_var = "QUERYING_API_KEY"
tool_timeout_sec = 240
```

**mcp.json**

`mcp.json` ファイルを読むクライアントの場合:

```json theme={"theme":"css-variables"}
{
  "mcpServers": {
    "querying": {
      "url": "https://mcp.querying.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

その他のStreamable HTTPクライアントも、すべてのリクエストで次のヘッダーを送信すれば動作します。

```http theme={"theme":"css-variables"}
Authorization: Bearer <API key>
Accept: application/json, text/event-stream
Content-Type: application/json
```

Bearerヘッダーのないリクエストは `401` を返します。無効なキーは、最初のツール呼び出しでツールエラーとして報告されます。

## ツール

タスクを送信するツールは、同じAPI呼び出しと同じ料金がかかります。読み取り専用のツールは無料です。

### タスクとリサーチ

| ツール | 機能 | クレジット |
| - | - | - |
| `run_prompt` | プロンプトをエンジンに送信し、結果を待ちます。 | エンジンの料金 |
| `submit_prompt` | プロンプトを送信し、キューに入ったタスクをすぐに返します。 | エンジンの料金 |
| `get_task` | タスクのステータスと、終了していればその結果を返します。 | 無料 |
| `scrape_page` | 1つのWebページまたはテキストPDFをMarkdownとして読み取り(`WEB_SCRAPE`)、完了を待ちます。 | URLごとに1 |
| `read_product` | ショップの商品ページを1つ読み取り(`COMMERCE_PRODUCT`)、価格、在庫、画像、説明画像、仕様、オプションを待ちます。 | 1ページ3 |
| `research_prompts` | あるトピックについて人々がAIアシスタントに尋ねる質問を検索需要の順に見つけ、`create_monitor` にそのまま渡せる `monitorSet` を返します。米国と韓国の市場に対応します。 | 11 |
| `run_product_lookup` | AIショッピングエンジンに商品と最大5件の競合商品を尋ね、結果を待ちます。エンジンごとの表示の有無、販売店、価格、引用サイトと、ショッピングプロンプトの回答に出た商品を返します。米国と韓国の市場に対応します。 | 商品ごとに10、ショッピングプロンプトごとに5 |
| `get_product_lookup` | ルックアップidでProduct Lookupの結果を要約または全体で返します。 | 無料 |

`run_prompt` と `submit_prompt` は `taskType`、`prompt` と、任意の `country`、`idempotencyKey`、`include`、`page`(1から10、`GOOGLE_SERP` と `NAVER_SERP` 用)を受け取ります。エンジンと料金は[エンジン](/ja/engines/overview.md)、リサーチの入力は [Prompt Research](/ja/research/prompt-research.md) を参照してください。

`COMMERCE_SERP` では `prompt` の代わりに `site` と `query` を送り、`limit`(1から40)は任意です。[Commerce Search](/ja/engines/commerce-serp.md) を参照してください。`read_product` は `url` と、任意の `country`、`idempotencyKey` を受け取ります。[Commerce Product](/ja/engines/commerce-product.md) を参照してください。

`run_product_lookup` は `product`、`country` と、任意の `competitors`、`prompts`、`engines`、`idempotencyKey` を受け取ります。入力は [Product Lookup](/ja/research/product-lookup.md) を参照してください。既定の応答は要約です。商品ごとに表示したエンジン、価格帯、販売店と引用サイトの上位10件、エンジン別の比較行を、ショッピングプロンプトごとにエンジン別に表示または言及された商品を含みます。全体の応答の約10分の1です。すべてのリスティング、引用ページ、タスクidが必要なら `detail: "full"` を渡してください。

### GEOモニター

各モニターツールはあなたのキーでAPIを1回呼び出すため、所有権、キーの範囲、プランの上限はRESTと同じく適用されます。[GEOモニタリング](/ja/monitors.md)を参照してください。

| ツール | 機能 | クレジット |
| - | - | - |
| `get_monitor_capabilities` | モニター対応エンジン、タスクごとのクレジット、上限、指標の定義。モニターを設定する前に呼び出してください。 | 無料 |
| `list_monitors` | あなたのモニターと30日間の集計。 | 無料 |
| `get_monitor` | 1つのモニターの旧形式の詳細ビュー。 | 無料 |
| `create_monitor` | モニターを作成し、最初の実行を開始します。各実行は、各エンジンでプロンプト、地点、サンプルごとに1タスクを送信します。 | 実行ごと。[コストとスケジュール](/ja/monitors.md#コストとスケジュール)を参照 |
| `update_monitor` | フィールドを変更するか、`enabled` で一時停止・再開します。 | 無料。プロンプトやエンジンを増やすと各実行のコストが上がります |
| `delete_monitor` | モニターとそのスコア履歴を削除します。元に戻せません。 | 無料 |
| `run_monitor` | 今すぐ実行を開始します。 | 1回の実行分のタスク。スケジュール実行と同じく課金 |
| `get_monitor_analytics` | 言及率と引用率、期間比較、シェア・オブ・ボイス、エンジン別とプロンプト別の行。 | 無料 |
| `get_monitor_sources` | 引用されたドメインまたはページ。`nextCursor` でページ送りします。 | 無料 |
| `get_monitor_results` | スコア付きの行。`includeEvidence` がtrueの場合は回答テキストとソースも含みます。 | 無料 |
| `get_monitor_answer` | 1つの回答のMarkdown、ソース、スコアリングの文脈。 | 無料 |
| `suggest_monitor_prompts` | ブランド情報からプロンプト案を作成します。何も保存しません。 | 無料。1時間あたり30回、20秒に1回まで |
| `get_monitor_alerts` | アラート履歴と、アラートが有効かどうか。 | 無料 |
| `test_monitor_alert` | テストのアラートメールを1通送信します。モニターごとに5分あたり3回まで(`429 RATE_LIMITED`)。 | 無料 |

## タイムアウト

`run_prompt`、`scrape_page`、`read_product`、`research_prompts` はタスクが終了するまでポーリングします。待機時間は `timeoutSeconds`(既定値180、最大900)です。タスクがまだ実行中なら、ツールは `taskId` を含む `TASK_TIMEOUT` エラーを返します。タスクは実行を続けるため、そのidで `get_task` を呼び出して結果を受け取ってください。

`run_product_lookup` も同じようにポーリングします。240秒のクライアントタイムアウト内に終わるよう既定で210秒待ち、ほとんどのルックアップは2〜3分で終わります。まだ実行中なら、ツールは `lookupId` を含む `LOOKUP_TIMEOUT` エラーを返します。そのidで `get_product_lookup` を呼び出してください。

クライアントのツールタイムアウトは `timeoutSeconds` より長く設定してください。Codex の例では、既定の180秒に対して `tool_timeout_sec = 240` を使っています。クライアントが短いツール呼び出ししか許さない場合は、`submit_prompt` の後に `get_task` を使ってください。

## エラー

ツールのエラーは、ツール結果の中でJSONとして返ります。

| コード | 意味 |
| - | - |
| `KEY_SCOPE_DENIED` などのAPIエラーコード | APIが呼び出しを拒否しました。ステータスと詳細が含まれます。[エラー](/ja/concepts/errors.md)を参照してください。 |
| `VALIDATION_ERROR` | ツールの入力が不正です。 |
| `TASK_TIMEOUT` | タスクが終了する前に待機が終わりました。`taskId` を含みます。 |
| `LOOKUP_TIMEOUT` | Product Lookup のすべての質問が終わる前に待機が終わりました。`lookupId` と未完了のエンジンを含みます。 |
| `TASK_FAILED` | タスクが失敗しました。`taskId` とタスクの結果を含みます。 |

## 課金

すべてのツール呼び出しは、キーを所有するアカウントにREST APIと同じ料金で課金されます。キーの設定も適用され、キーの[エンジンの範囲や1日のクレジット上限](/ja/authentication.md#キーの設定)でエージェントが使える量を制限できます。エージェントには、範囲を絞り1日の上限を設定した専用のキーを渡してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.