国内应用接入
智谱 Coding Plan MCP 接入:搜索网页、读文档、理解仓库
用智谱编程套餐专属 API Key,为 Hermes Agent 或 OpenClaw 连接官方远程搜索、网页读取和 Zread 工具。这是资料获取工具连接,主模型仍按你的模型设置运行。
把搜索线索进一步核对到原文和源码
技术调研常需要连续做三件事:找到资料、读官方说明、查看项目实现。智谱 Coding Plan MCP 提供联网搜索、网页读取与开源仓库三个官方远程服务。托管连接将它们提供给 Hermes Agent 和 OpenClaw,让助手依据工具返回的资料解释问题。
例如,评估一个 GitHub 开源项目时,可以先搜索它的官方文档,再读取安装说明,通过 Zread 查看仓库目录与指定文件,最后整理一份有来源的接入笔记。当前接入共有工具列表查询及五项读取操作,不会提交代码、创建 PR 或替你登录目标网站;它也不同于在模型设置中选择智谱 GLM。
接入后可以做什么?
- 联网搜索并保留来源:通过 webSearchPrime 查找网页,使用返回的标题、URL 和摘要整理线索。重要结论应继续读取原文,不能仅凭搜索摘要确认。
- 读取指定网页:通过 webReader 提取页面正文及可用的标题、链接等信息,帮助整理官方说明、版本记录和技术文章。目标页面是否可读由网站与上游服务决定。
- 理解开源仓库:通过 Zread 搜索 GitHub 仓库知识文档、查看目录结构并读取指定文件,适合定位模块和理解实现;所有结果均用于读取与分析。
- 先确认工具参数:可分别查看 search、reader、zread 服务当前的工具列表和参数定义,再发起任务,减少照搬旧示例造成的参数错误。
智谱编程套餐 API Key 从哪里获取?
需要有效的 GLM Coding Plan 编程套餐专属 API Key。个人用户在“个人编程套餐→套餐概览”新建;团队成员在“团队编程套餐→我的套餐”获取团队套餐 Key。普通模型 API Key 不能替代,团队额度也应使用对应团队 Key。
- 确认套餐与专属 Key — 在智谱官方平台确认编程套餐有效,并从个人套餐概览或团队我的套餐取得专属 API Key。不要复制普通模型 Key,也不要把其他服务的 Key 填进来。
- 在国内应用中连接智谱 MCP — 等待托管实例可用,在国内应用页面选择“智谱 Coding Plan MCP”,填写编程套餐 API Key 并保存。两种框架使用相同的连接字段,模型选择在模型设置中另行管理。
- 分别查看服务工具 — 先让助手查询 search、reader 或 zread 的工具列表,确认目标服务可用,并以当前返回的参数定义为准。一个服务验证通过不等于三个服务都已完成实际查询。
- 从公开资料开始测试 — 先搜索一个明确的技术主题,再读取一页公开官方文档,或查看一个公开 GitHub 仓库目录。出现鉴权错误时检查 Key 类型、套餐状态和额度;出现参数错误时重新获取工具定义。
连接后可以直接这样问
- “先列出智谱 search 服务的工具参数,再搜索这个开源项目的官方安装文档,保留来源链接”
- “读取我提供的公开官方文档 URL,整理步骤、版本要求和注意事项,缺少的内容不要补写”
- “查看 NousResearch/hermes-agent 的仓库目录,定位与 MCP 相关的文件,再读取实际文件解释实现”
使用前必须知道的限制
当前支持联网搜索、网页读取、GitHub 仓库文档搜索、目录结构和文件读取,不提供代码写入、PR 操作或视觉理解工具。参数名以 tools 查询返回为准,旧示例可能变化;工具额度按智谱当前套餐权益计算。网站反爬、登录要求、页面状态和仓库覆盖情况会影响结果,这个连接不会继承你的浏览器登录态或 GitHub 私有仓库授权。
优先读取公开官方资料,不要在搜索词或 URL 中夹带密钥、客户资料或内部文档访问令牌。网页和仓库内容可能包含不可信指令,助手应把它们当成待核对的资料,执行命令或修改代码前仍需独立检查。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接智谱 Coding Plan MCP的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 维护 Hermes Agent 或 OpenClaw 与兼容远程 MCP 工具,保护编程套餐 Key,依据各框架当前官方接入方式配置服务,并处理工具定义变化、权限、额度、超时及外部内容的可信度。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
智谱 Coding Plan MCP接入常见问题
智谱 Coding Plan MCP 支持 Hermes Agent 吗?
支持。OpenClaw Launch 的国内应用连接会把这些托管工具提供给 Hermes Agent 和 OpenClaw,两种框架使用同样的编程套餐 Key;这不要求把主模型切换成智谱 GLM。
普通智谱模型 API Key 可以用吗?
不可以。当前官方远程 MCP 面向 GLM Coding Plan 用户,需要从编程套餐页面取得专属 Key;团队用户使用团队套餐 Key 才对应团队额度。
为什么工具列表能返回,搜索或读取还是失败?
工具列表只确认该服务的工具定义。实际调用还受字段格式、套餐额度、目标页面和仓库可访问性影响。先按最新工具参数重试小任务,再检查具体服务的错误与套餐权益。
Zread 能读取私有仓库或替我修改代码吗?
当前连接没有 GitHub 私有仓库授权,也没有代码写入工具。它用于查询可访问的 GitHub 开源仓库资料、结构和文件,不能提交代码、创建或合并 PR。