Tool 'review_mcp15' cannot have both defer_loading=true and cache_control set. T...

2026年06月09日 16:10 20.24 秒 success

错误信息

Tool 'review_mcp15' cannot have both defer_loading=true and cache_control set. Tools with defer_loading cannot use prompt caching.

AI 解决方案

🔍 错误分析


1. 🌐 错误翻译


原文:Tool 'review_mcp15' cannot have both defer_loading=true and cache_control set. Tools with defer_loading cannot use prompt caching.
译文:工具 'review_mcp15' 不能同时设置 defer_loading=true 和 cache_control。使用延迟加载的工具不能使用提示缓存。

2. 🎯 原因分析


这是一个配置冲突错误。您在为工具 review_mcp15 配置时,同时启用了两个互斥的功能:
defer_loading=true:延迟加载工具,按需加载以节省资源
cache_control:为工具启用提示缓存功能以提高响应速度

系统设计上,延迟加载的工具不能使用缓存机制,因为其加载状态和时机不确定。

3. 💡 解决方案


根据需求选择以下一种配置方式:

方案A:保留延迟加载(推荐用于不常用工具)

# 移除 cache_control 配置
tools:
  - name: review_mcp15
    defer_loading: true
    # 删除 cache_control 相关配置

方案B:保留缓存加速(推荐用于高频工具)

# 移除 defer_loading 配置
tools:
  - name: review_mcp15
    # 删除或设置为 false:defer_loading: false
    cache_control: true  # 或您原本的缓存配置

4. 🛡️ 预防措施


  • 仔细阅读配置文档:在配置工具前,查阅相关文档了解各配置项的兼容性和使用场景

  • 分阶段测试:先单独启用一个功能测试效果,再尝试组合配置

  • 合理规划工具分类:高频工具启用缓存加速,低频工具使用延迟加载节省资源
  • 最佳实践建议

  • 对于核心高频工具:启用缓存,禁用延迟加载

  • 对于辅助低频工具:启用延迟加载,不使用缓存