MCP 增删、状态与启停

使用终端管理配置，区分默认 project 范围和临时启停。

终端 gemini mcp 管理配置，交互 /mcp 检查当前会话。MCP add/remove 默认 project 范围，与 Skills 默认 user 不同。

添加

gemini mcp add --scope user local-tools node /path/to/server.js
gemini mcp add --transport http http-server https://api.example.com/mcp/
gemini mcp add --transport sse sse-server https://api.example.com/sse/

默认 transport 是 stdio。URL 和脚本为占位；选择 http 时应使用 Streamable HTTP 端点，不能把任意网页当作 MCP URL。

常用选项

选项	用途
`-s`, `--scope`	user 或 project，默认 project
`-t`, `--transport`	stdio、sse、http
`-e`, `--env`	子进程环境变量
`-H`, `--header`	HTTP/SSE 请求头，可重复
`--timeout`	毫秒超时
`--trust`	跳过该服务普通工具确认
`--include-tools` / `--exclude-tools`	逗号分隔工具集合
`--description`	服务说明

不要把真实秘密直接放进可记录的命令行示例；可在设置中引用环境值。

列表与诊断

gemini mcp list

它显示配置与连接状态。Stdio 服务只在当前目录可信时才启动测试；不可信目录中显示 Disconnected 不一定是命令不存在。交互中用 /mcp list，重扫能力可用 /mcp reload。

移除与禁用

gemini mcp remove local-tools --scope user
gemini mcp disable http-server
gemini mcp enable http-server

remove 删除相应作用域配置；disable 保留定义但不连接和提供工具。启停状态保存在 ~/.gemini/mcp-server-enablement.json。--session 请求只对会话生效；交互也有 /mcp enable <name>、/mcp disable <name>。

操作后确认

检查修改的作用域和真实服务名称，再在会话中确认连接与可见工具。删除项目定义不等于其他作用域或扩展中的同名服务也已删除。