xAI 托管了一个 Model Context Protocol（MCP） server，让 AI assistant 和 Agent 可以直接访问 xAI 文档。无需将文档复制粘贴到 prompt，只需让任意兼容 MCP 的 client 指向该 server，它即可拉取所需信息。

你可以在自己选择的所有主流 IDE / Editor 中使用它。

Endpoint：

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

该 server 使用 Streamable HTTP transport，并以 stateless 模式运行，无需管理 session。

快速入门

Cursor

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

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

Zed

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

将以下内容添加到新的 server 配置中。

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

Windsurf

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

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 的 Client

任何支持 Streamable HTTP transport 的 client 都可以通过指向该 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 server 交互。该 server 接受 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
  }'

社区

Docs MCP Server