サービスの設定
Zotero 設定 → Knowledge MCP を開きます。文書解析、モデルと検索、MCP 接続にはそれぞれ保存・適用操作があります。タブを切り替えても未保存の入力は保持されます。
文書解析
| サービス | 接続先 | モデル |
|---|---|---|
| PaddleOCR | https://paddleocr.aistudio-app.com/api/v2/ocr/jobs |
PaddleOCR-VL-1.6 |
| MinerU | https://mineru.net/api/v4 |
vlm |
サービスを選び、API キーまたはトークンを入力して有効化・保存します。切替時も各サービスの認証情報とオプションを保持します。モデルは選択した解析サービスで固定され、任意の OCR API がそのまま使えるわけではありません。
外部接続は HTTPS が必要で、HTTP はループバックサービスのみです。URL にパスワード、クエリ、フラグメントは含められません。受理済みタスクは開始時のサービスと接続先を保持し、現在の選択を変えても転送されません。
キュー設定ではローカル実行枠、追跡する遠隔ジョブ、ポーリング、タイムアウト、ファイル・結果の上限を調整します。まず初期値を使用してください。時間は秒、容量は MB 表示です(1 MB = 1,048,576 バイト)。
モデルと検索
同梱プロバイダーは Bailian です。初期モデルは qwen3.7-text-embedding と qwen3.7-text-rerank、ベクトル次元は 768 です。アカウントがモデル、リージョン、接続先、次元数に対応するか確認してください。
- 対応する埋め込み接続先、モデル、キーを入力します。
- 必要なら再ランキングを設定します。候補本文がサービスに送られる場合があり、専用キーか埋め込みキーの共用を選べます。
- 各接続をテストします。現在の入力で実行しますが保存はしません。
- サービスを有効化し、保存して適用した後、適用状態を確認します。
- 必要に応じて既存の文献をベクトル化し、不足する埋め込みを生成します。
保存済みキーの入力欄を空にすると元のキーを保持します。接続成功、設定保存、実行時適用は別の状態です。
埋め込みモデル、接続先、次元数を変えるとベクトル空間が変わります。確認時に旧ベクトルの保持・削除・変更取消を選択してください。互換性のない空間は混ぜません。
検索索引を修復は保存済みベクトルからローカル再構築し、新しい埋め込みを要求しません。既存の文献をベクトル化は外部サービスを呼び出し、利用枠を消費する場合があります。トラブルシューティングを参照してください。
MCP 接続
ローカル MCP は任意で、初期状態は無効です。ローカル AI クライアントが必要な場合に有効化し、ポートを適用して、ライブラリと権限を明示したトークンを作ります。MCP ガイドを参照してください。