ソース管理

不明なプレースホルダーを見つけたり、どのツールが接続されているか確認する必要がある場合は、CONNECTORS.md を参照してください。

利用可能なソースを把握し、新しいソースの接続をサポートし、ソースのクエリ方法を管理します。

利用可能なソースの確認

利用可能なツールをチェックして、どの MCP ソースが接続されているかを判断します。各ソースは MCP ツールのセットに対応します：

ソース	主な機能
~~chat	メッセージの検索、チャネルとスレッドの読み取り
~~email	メッセージの検索、個別メールの読み取り
~~cloud storage	ファイルの検索、ドキュメント内容の取得
~~project tracker	タスク検索、タイプアヘッド検索
~~CRM	レコードのクエリ（アカウント、連絡先、営業機会）
~~knowledge base	セマンティック検索、キーワード検索

ツールプレフィックスが利用可能な場合、そのソースは接続され、検索可能です。

ユーザーにソースの接続をガイドする

ユーザーが検索を実行したが、接続されているソースが少ないか、まったくない場合：

現在、[N] つのソースが接続されています：[リスト]。

検索を拡張するには、MCP 設定で追加のソースを接続できます：
- ~~chat — メッセージ、スレッド、チャネル
- ~~email — メール、会話、添付ファイル
- ~~cloud storage — ドキュメント、シート、スライド
- ~~project tracker — タスク、プロジェクト、マイルストーン
- ~~CRM — アカウント、連絡先、営業機会
- ~~knowledge base — wiki ページ、ナレッジベース記事

接続するソースが多いほど、検索結果がより完全になります。

ユーザーが接続されていない特定のツールについて尋ねた場合：

[ツール名] は現在接続されていません。追加するには：
1. MCP 設定を開く
2. [ツール] MCP サーバー構成を追加する
3. プロンプトが表示されたら認証する

接続されると、今後の検索に自動的に含まれます。

ソース優先順位の順序付け

異なるクエリタイプは、特定のソースを最初に検索することで利益を得ます。これらの優先度を使用して結果に重み付けし、ソースをスキップしないでください：

クエリタイプ別

意思決定クエリ（「何を決めたのか...」）：

1. ~~chat（意思決定が行われる会話）
2. ~~email（意思決定の確認、告知）
3. ~~cloud storage（会議議事録、決定ログ）
4. Wiki（意思決定がドキュメント化されている場合）
5. Task tracker（意思決定がタスクにキャプチャされている場合）

ステータスクエリ（「...のステータスは？」）：

1. Task tracker（~~project tracker — 信頼できるステータス）
2. ~~chat（リアルタイム議論）
3. ~~cloud storage（ステータスドキュメント、レポート）
4. ~~email（ステータス更新メール）
5. Wiki（プロジェクトページ）

ドキュメントクエリ（「...のドキュメントはどこに...」）：

1. ~~cloud storage（プライマリドキュメント保存領域）
2. Wiki / ~~knowledge base（ナレッジベース）
3. ~~email（メール経由で共有されたドキュメント）
4. ~~chat（チャネルで共有されたドキュメント）
5. Task tracker（タスクにリンクされたドキュメント）

ユーザークエリ（「誰が...に取り組んでいるのか」/ 「誰が...について知っているのか」）：

1. ~~chat（メッセージ作成者、チャネルメンバー）
2. Task tracker（タスク割り当て者）
3. ~~cloud storage（ドキュメント作成者、協力者）
4. ~~CRM（アカウント所有者、連絡先）
5. ~~email（メール参加者）

事実/ポリシークエリ（「我々のポリシーは...」）：

1. Wiki / ~~knowledge base（公式ドキュメント）
2. ~~cloud storage（ポリシードキュメント、ハンドブック）
3. ~~email（ポリシー告知）
4. ~~chat（ポリシー議論）

デフォルト優先度（一般的なクエリ）

クエリタイプが不明な場合：

1. ~~chat（最高のボリューム、最もリアルタイム）
2. ~~email（正式なコミュニケーション）
3. ~~cloud storage（ドキュメントとファイル）
4. Wiki / ~~knowledge base（構造化知識）
5. Task tracker（作業アイテム）
6. CRM（顧客データ）

レート制限への対応

MCP ソースはレート制限を持つ場合があります。これらに適切に対応します：

検出

レート制限応答は通常、以下として表示されます：

• HTTP 429 応答
• 「rate limit」、「too many requests」、「quota exceeded」に言及するエラーメッセージ
• スロットルされた、または遅延した応答

処理

ソースがレート制限されている場合：

1. すぐに再試行しないでください — 制限を尊重する
2. 他のソースを続行します — 検索全体をブロックしない
3. ユーザーに通知します：

注：[ソース] は一時的にレート制限されています。以下の結果は
[他のソース] からのものです。数分後に再試行して [ソース] を含めることができます。

4. ダイジェストの場合 — レート制限が中途で発生した場合、制限が発生する前にカバーされた時間範囲をメモします

予防

• 不要な API 呼び出しを避ける — クエリ前に、ソースが関連する結果を持つ可能性があるかどうかを確認します
• 可能な限り、広範なスキャンより対象クエリを使用します
• ダイジェストの場合、API がサポートしている場所でリクエストをバッチ処理します
• キャッシュ認識：検索が実行されたばかりの場合、同じクエリをすぐに再実行しないでください

ソースのヘルス

セッション中のソース利用可能性を追跡します：

ソースのステータス：
  ~~chat:        ✓ 利用可能
  ~~email:        ✓ 利用可能
  ~~cloud storage:  ✓ 利用可能
  ~~project tracker:        ✗ 接続されていません
  ~~CRM:   ✗ 接続されていません
  ~~knowledge base:      ⚠ レート制限（2 分後に再試行）

検索結果をレポートするときは、どのソースが検索されたかを含めて、ユーザーが回答の範囲を知ることができるようにします。

カスタムソースの追加

エンタープライズサーチプラグインは、MCP 接続されたすべてのソースで機能します。新しい MCP サーバーが利用可能になると、.mcp.json 構成に追加できます。検索コマンドとダイジェストコマンドは、利用可能なツールに基づいて新しいソースを自動的に検出して含めます。

新しいソースを追加するには：

1. MCP サーバー構成を .mcp.json に追加します
2. 必要に応じて認証します
3. そのソースは以降の検索に自動的に含まれます