功能

MCP 服务器

MCP (Model Context Protocol) 服务器将外部工具暴露给 Grok。配置完成后，这些工具将与内置工具一起可用，命名空间为 <server>__<tool>。

添加服务器

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

# Local stdio server; everything after -- is the server command
grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# Remote server over HTTP (OAuth handled automatically)
grok mcp add --transport http linear https://mcp.linear.app/mcp

# Remote server with a static auth header (--header is repeatable)
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 参数以提供机器可读的输出。

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

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
env = { API_KEY = "${MY_API_KEY}" }   # ${VAR} expands at load time
startup_timeout_sec = 30              # default 30
tool_timeout_sec = 6000               # default 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。