diff --git a/codex-rs/core/templates/search_tool/tool_description.md b/codex-rs/core/templates/search_tool/tool_description.md
index 07df9dc51..db6b4e34a 100644
--- a/codex-rs/core/templates/search_tool/tool_description.md
+++ b/codex-rs/core/templates/search_tool/tool_description.md
@@ -1,5 +1,6 @@
-# Apps tool discovery
+# Apps (Connectors) tool discovery
 
-Searches over apps tool metadata with BM25 and exposes matching tools for the next model call.
+Searches over apps/connectors tool metadata with BM25 and exposes matching tools for the next model call.
 
-Tools of the apps ({{app_names}}) are hidden until you search for them with this tool (`tool_search`).
\ No newline at end of file
+Tools of the apps ({{app_names}}) are hidden until you search for them with this tool (`tool_search`).
+When the request needs one of these connectors and you don't already have the required tools from it, use this tool to load them. For the apps mentioned above, always prefer `tool_search` over `list_mcp_resources` or `list_mcp_resource_templates` for tool discovery.