核心功能
智谱工具 Coding Plan 是基于 Z.AI Coding Plan MCP 端点的多模态工具集，主要提供以下能力：
1. 网络搜索 (`web_search_prime`)：实时互联网搜索，支持时效性过滤（1天/周/月/年）、域名限定及内容篇幅控制（medium/high）。
2. 网页读取 (`webReader`)：智能抓取目标网页的标题、正文、元数据及外链列表，适合快速获取页面结构化信息。
3. GitHub 仓库文档搜索 (`search_doc`)：直接检索开源仓库文档内容，无需克隆代码库即可查询技术文档。
4. 仓库目录与文件读取 (`get_repo_structure`/`read_file`)：浏览仓库树形结构、读取指定文件内容，支持子目录路径定位。
5. 视觉理解 (Legacy API)：基于 GLM-4.6V 的图像分析能力，支持本地图片和远程URL，可执行UI界面描述、错误信息识别等任务。
6. 文件解析 (Legacy API)：PDF/Word/Excel/PPT 等多格式文档内容提取。
显著优点
- 完全免费：Coding Plan Pro 套餐提供 1000 次/月的 MCP 调用额度，Max 套餐更达 4000 次/月，次月自动重置，对开发者极其友好。
- 官方背书：智谱AI原生实现，基于
api.z.ai/api/mcp/端点，非第三方代理，稳定性有保障。 - 智能降级策略：MCP 连接失败时自动 fallback 到 Legacy API（需账户余额），避免服务中断；内容安全拦截则明确提示而非静默失败，便于调整搜索策略。
- 协议标准：完整支持 MCP streamableHttp 协议，兼容现代AI Agent架构，便于集成到 Claude Desktop、OpenClaw 等 MCP 客户端。
- 开箱即用：提供 Shell 脚本和 Python CLI 双接口，覆盖快速命令行调用和程序化集成场景。
潜在局限与风险
- 视觉理解的可持续性风险：GLM-4.6V 功能通过逆向官方 npm 包实现（官方未提供视觉 MCP 端点，返回404），当前可能占用 Coding Plan 资源池，但智谱可能随时调整计费策略，存在未来收费可能。用户需关注账户用量变化。
- 参数兼容性问题：
--recency（时效过滤）、--domain（域名限定）等高级搜索参数仅在 Legacy 模式生效，MCP 默认模式下无效，易引发配置困惑。
- 内容安全策略：MCP 端点对敏感词有严格拦截，遇内容过滤时不触发 fallback，直接返回空结果，需手动修改搜索词重试。
- Legacy 余额陷阱：Coding Plan 用户通常未充值，fallback 到 Legacy 后可能因 429（余额不足）二次失败，形成"降级即失败"的恶性循环。
- Zread 模式锁定：仓库文档搜索功能仅支持 MCP 模式，Legacy 模式下不可用，限制了降级场景的完整性。
适合人群
- AI 应用开发者：需低成本获取网页抓取、仓库检索能力的 MCP 工具链用户
- 开源技术研究者：频繁查阅 GitHub 文档、需要快速定位仓库信息的工程师
- 多模态实验者：愿意承担潜在费用风险、希望免费试用 GLM-4.6V 视觉能力的早期用户
- 资源敏感型团队：追求 API 成本优化、希望替代付费搜索服务（如 SerpAPI）的中小团队
常规风险建议
1. 密钥管理：API Key 属于敏感凭证，避免硬编码或提交至 Git 仓库，建议使用环境变量 ZHIPU_API_KEY 注入。
2. 用量监控：定期查看智谱控制台，尤其关注视觉理解和文件解析的 Legacy API 调用消耗，防范突发计费。
3. 搜索词优化：遇 MCP 内容拦截时，采用更泛化、去敏感化的表达替换原查询。
4. 降级预期管理：理解 MCP→Legacy fallback 的触发条件，生产环境建议优先保障 MCP 连接稳定性而非依赖降级机制。