Community

Docs MCP Server

xAI 托管了一个模型上下文协议 (MCP) 服务器，使 AI 助手和代理能够直接访问 xAI 文档。您可以将任何兼容 MCP 的客户端指向该服务器，让它获取所需信息，而不是将文档复制粘贴到提示中。

您可以将此功能与您选择的所有流行 IDE/编辑器一起使用。

端点：

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

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

快速开始

Cursor

在 Cursor 中，转到 设置 → MCP 并添加一个新服务器：

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

Zed

在 Zed 中，转到 agent: open settings -> 模型上下文协议 (MCP) 服务器。

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

json

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

Windsurf

在 Windsurf 中，转到 设置 → MCP 并使用相同的端点 URL 添加一个新服务器。

OpenCode

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

json

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

任何兼容 MCP 的客户端

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

javascript

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 请求：

bash

# 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
  }'

Community ​

Docs MCP Server ​

快速开始 ​

Cursor ​

Zed ​

Windsurf ​

OpenCode ​

任何兼容 MCP 的客户端 ​

使用 curl ​