MCP 服务器

添加服务器

最快的方式是使用 grok mcp 命令：

# 本地 stdio 服务器；-- 之后是服务器命令
grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# 通过 HTTP 的远程服务器（自动处理 OAuth）
grok mcp add --transport http linear https://mcp.linear.app/mcp

# 带静态认证头的远程服务器（--header 可重复）
grok mcp add --transport http api https://mcp.example.com/mcp --header "Authorization: Bearer ${API_TOKEN}"

grok mcp list 显示已配置的服务器，grok mcp remove <name> 删除一个，grok mcp doctor [name] 诊断配置和连接问题。list 和 doctor 支持 --json 输出。

在 config.toml 中声明

服务器也可直接在 ~/.grok/config.toml 中声明：

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
env = { API_KEY = "${MY_API_KEY}" }
startup_timeout_sec = 30
tool_timeout_sec = 6000

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
headers = { "x-mcp-session-id" = "{{session_id}}" }

Grok 在 url、command、args、env 和 headers 中展开 ${VAR}（以及 ${VAR:-default}），因此密钥可保留在环境中。需要 OAuth 的服务器在首次使用时触发浏览器流程；令牌存储在 ~/.grok/mcp_credentials.json 下。

项目作用域

向 grok mcp add 传入 --scope project（写入当前目录的 .grok/config.toml）可定义随仓库分发的服务器。加载时，Grok 从当前目录向上遍历到 git 根目录读取每个 .grok/config.toml，同名项目服务器会完全替换用户服务器。

在 TUI 中

/mcps 打开扩展弹窗的 MCP 标签页：用 Space 切换服务器，r 在编辑配置后刷新，i 认证 OAuth 服务器，a 和 x 添加或删除。

兼容性

Grok 还从 ~/.claude.json、.cursor/mcp.json 和项目 .mcp.json 文件加载 MCP 配置，优先级低于 config.toml。通过 [compat.claude] mcps = false 或 [compat.cursor] mcps = false 禁用特定供应商。grok inspect 显示每个加载的服务器及其来源。

故障排除

grok mcp doctor 是首选工具。对于启动但无法连接的 stdio 服务器，Grok 将 stderr 捕获到 ~/.grok/logs/mcp/<server>.stderr.log。首次启动时下载包的冷启动 npx 服务器可能需要更高的 startup_timeout_sec。