Grok Build怎么连接MCP?add、doctor、配置范围与停用检查
在Grok Build配置本地或远程MCP,核对用户和项目范围;用list、doctor与ins…
文章目录
Grok Build可以把外部MCP工具加入本地工作流,这与Responses API的tools参数、消费者连接器的公网隧道不是同一套配置。本文先连接已审阅的练习服务,解释配置发现、诊断与清理,不实际安装或授权第三方服务。

第一步:确定服务与范围
本地stdio需要可用的可执行程序与正确参数,远程HTTP需要真实地址和认证。先核对服务来源、工具名和读写能力,避免首次就挂载整个用户目录。使用npx首次下载还涉及包版本和信任,应先审阅再运行。
修改现有配置前备份。选择用户范围还是项目范围:共享仓库不应包含私人token,项目同名服务也可能替换用户配置。先记录当前目录与已有服务,再添加不同名字避免误覆盖。
第二步:按传输配置服务
官方grok mcp add在–后接受本地程序命令,远程使用–transport http。示例远程地址需要自己按服务条款授权,不能把示例URL写成已经连接成功。静态认证可通过受控环境变量管理,不把密钥写进版本库。
grok mcp list # 官方远程配置形状示例,实际授权需本人核对: grok mcp add --transport http linear https://mcp.linear.app/mcp # 连接诊断: grok mcp doctor linear
第三步:核对实际加载来源
项目范围通过–scope project写入当前.grok/config.toml,加载时从当前目录向Git根检查项目配置,同名项目服务会整体替代用户服务。不要以为只是补充一个字段。
Grok也兼容部分Claude、Cursor和.mcp.json来源,config.toml优先。用grok inspect看每个服务及来源,防止以为删掉一个文件就停用了所有同名配置。先确认来源再编辑,不清空其他工具设置。
第四步:诊断连接和认证
list列出配置不代表服务可调用,doctor检查配置与连接,可用–json便于记录。stdio启动失败查命令、参数、工作环境和stderr日志;首次npx下载慢可能需要合理启动超时,不直接把所有超时设无限。
HTTP连接还要区分地址、网络与OAuth。首次OAuth可能触发浏览器流程,身份与权限由本人核对;不要读取或打印mcp_credentials.json内容来展示成功。握手通过后再验证实际工具清单。
只读验收:工具名和服务对应;授权账号正确;允许范围明确;调用练习数据;无写入;错误阶段可定位;日志无token;未加载意外兼容来源。
第五步:在界面与配置中清理
TUI的/mcps可开MCP管理,支持切换、刷新和认证等操作,以实际版本显示为准。修改配置后刷新再检查,不能把文件已保存当成运行中进程已重载。
不再使用时grok mcp remove目标名删除对应配置,另核对项目或兼容来源。停用工具不等于服务token撤销,后者需要按服务认证流程处理。完成标准是连接、调用、范围与清理都可验证,不只是列表里出现一个名字。
官方资料
资料核对日期:2026年11月17日。
本文地址:https://www.163264.com/21512


