xAI 托管了一台 Model Context Protocol（MCP）服务器，让 AI 助手和智能体可直接访问 xAI 文档。无需将文档复制粘贴到 prompt，只需让任意兼容 MCP 的客户端指向该服务器，它即可获取所需信息。

你可以在任意主流 IDE 或编辑器中使用它。

Endpoint：

https://docs.x.ai/api/mcp

该服务器使用 Streamable HTTP 传输，并以无状态模式运行，无需管理会话。

快速入门

Grok Build

在 Grok Build 中，通过终端添加服务器：

grok mcp add --transport http xai-docs https://docs.x.ai/api/mcp

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

[mcp_servers.xai-docs]
url = "https://docs.x.ai/api/mcp"

运行 grok mcp doctor xai-docs 验证连接。项目范围的配置和故障排查请参阅 MCP 服务器。

Cursor

在 Cursor 中，前往 Settings → MCP 并添加一个新服务器：

类型： url（Streamable HTTP）
URL： https://docs.x.ai/api/mcp

Zed

在 Zed 中，前往 agent: open settings -> Model Context Protocol（MCP）服务器。

将以下内容添加到新的服务器配置中。

{
    "xai-docs": {
       "url": "https://docs.x.ai/api/mcp"
    }
}

Windsurf

在 Windsurf 中，前往 Settings → MCP，然后使用相同的 endpoint URL 添加一个新服务器。

OpenCode

在 OpenCode Config 的 mcp 下添加以下配置：

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "xai-docs": {
            "type": "remote",
            "url": "https://docs.x.ai/api/mcp",
            "enabled": true
        }
    }
}

任意兼容 MCP 的客户端

任何支持 Streamable HTTP 传输的客户端都可以通过指向该 endpoint URL 进行连接。例如，使用 MCP TypeScript SDK：

import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const client = new Client({ name: 'my-app', version: '1.0.0' });

const transport = new StreamableHTTPClientTransport(
  new URL('https://docs.x.ai/api/mcp'),
);

await client.connect(transport);

// List all available doc pages
const result = await client.callTool({ name: 'list_doc_pages' });

console.log(result);

// Get a specific page
const page = await client.callTool({
  name: 'get_doc_page',
  arguments: { slug: 'developers/quickstart' },
});

console.log(page);

使用 curl

你也可以通过 HTTP 直接与 MCP 服务器交互。该服务器接受 JSON-RPC 请求：

# Initialize (optional — the server is stateless)
curl -X POST https://docs.x.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1.0.0" },
      "protocolVersion": "2025-03-26"
    },
    "id": 1
  }'

# List available tools
curl -X POST https://docs.x.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": 2
  }'

# Call a tool
curl -X POST https://docs.x.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_docs",
      "arguments": { "query": "rate limits", "max_results": 3 }
    },
    "id": 3
  }'

最后更新：2026 年 9 月 8 日

社区

文档 MCP 服务器