MCP 超时、工具过滤与审批
分别控制服务器启动、可见工具、每项工具审批和输出预算。
This page has not been translated into English yet. The original Chinese version is shown below.
连接成功后，还应控制需要暴露哪些工具、等待多久，以及哪些动作需审批。以下设置位于对应 [mcp_servers.<name>] 中。
启动与超时
| 键 | 默认或行为 |
|---|---|
| startup_timeout_sec | 默认 10 秒，服务器启动超时 |
| tool_timeout_sec | 默认 60 秒，单次工具执行超时 |
| enabled | 设为 false 暂停服务器，无需删除配置 |
| required | true 时，启用服务器初始化失败会使启动失败 |
顶层 mcp_optional_startup_grace_ms 默认 1000 毫秒，控制构建初始工具目录时等待可选服务器的时间。设为 0 改为等待各服务器的 startup_timeout_sec；required 服务器仍使用自身启动超时。
过滤与审批
下面是示例服务器配置，实际 URL、工具名与预算须与服务一致：
[mcp_servers.example]
url = "http://localhost:3000/mcp"
enabled_tools = ["open", "screenshot"]
disabled_tools = ["screenshot"]
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 45
[mcp_servers.example.tools.open]
approval_mode = "approve"
output_token_limit = 30000disabled_tools 在 enabled_tools 后应用，因此示例最终不暴露 screenshot。default_tools_approval_mode 支持 auto、prompt、writes、approve；writes 会询问未标记为 read-only 的工具。单个 tools.
output_token_limit 是正数 token 预算，在标准 20% serialization allowance 之前计算，覆盖该工具的模型默认截断预算。提高预算会增加上下文占用，不会使工具返回未提供的数据。
插件携带的 MCP
插件决定其服务器 transport，用户设置不能重写启动命令，但可在 plugins.