Connectors

自定义 MCP 服务器隧道

查看 Markdown

当你添加一个 自定义 MCP 连接器 时,Grok 的服务器需要通过公网访问你的 MCP 服务器。运行在 localhost 或私有网络地址(例如 127.0.0.110.x.x.x172.16.x.x192.168.x.x)上的服务无法直接访问,Grok 会拒绝这些 URL。

隧道服务 可以把你本地的服务器暴露成一个公网可访问的地址,供 Grok 连接。

隧道如何工作

隧道会创建一个安全的临时公网 URL,把流量转发到你机器上的某个端口。当 Grok 调用你的 MCP 服务器时,请求会先经过隧道提供方的基础设施,再进入你的本地进程,看起来就像一次本地请求。

Text

Grok ──► https://your-tunnel.example.com ──► tunnel provider ──► localhost:3001

你的 MCP 服务器代码无需改动,只需要向 Grok 提供不同的 URL。

配置隧道

下面列出两个常用且适合 MCP 服务器的隧道方案。

ngrok

ngrok 提供稳定的 URL 和流量查看面板。ngrok 是第三方服务,与 xAI 或 Grok 没有隶属关系。

  1. 安装 ngrok 并完成认证:

Bash

# macOS
brew install ngrok

# Windows
winget install ngrok -s msstore

# Authenticate (free account required)
ngrok config add-authtoken YOUR_AUTH_TOKEN
  1. 启动一个指向 MCP 服务器端口的隧道:

Bash

ngrok http 3001
  1. 复制输出中的 Forwarding URL(例如 https://a1b2c3d4.ngrok-free.app),并把它作为 Grok 自定义连接器对话框中的服务器地址。

Cloudflare Tunnel

Cloudflare Tunnel 是一个免费的替代方案,不需要注册即可快速创建隧道。

Bash

# macOS
brew install cloudflared

# Windows
winget install --id Cloudflare.cloudflared

# Start a quick tunnel
cloudflared tunnel --url http://localhost:3001

复制生成的 *.trycloudflare.com URL,并把它作为 Grok 中的服务器地址。

需要注意的事项

  • 隧道是临时的。 大多数免费隧道 URL 每次重启都会变化。如果你重启了隧道,就需要在 Grok 中删除旧连接器,并用新的 URL 重新添加。

  • 保持 MCP 服务器运行。 Grok 会在对话过程中按需调用你的服务器。如果隧道或本地服务器停止,工具调用就会失败。

  • 认证仍然生效。 如果你的 MCP 服务器需要 OAuth 或 API key,在把隧道 URL 提供给 Grok 之后,你仍然需要在 Grok 中完成这一步认证。隧道只负责网络可达性。


最后更新:2026 年 6 月 11 日