# 策展 · X (Twitter) 🔥🔥🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Taylor (@taycaldwell) · 平台：X (Twitter) · 日期：2026-06-30

> 原始來源：https://x.com/taycaldwell/status/2071753251360502131

## 中文摘要

X 發布 X MCP 與 Docs MCP 伺服器強化 AI 互動。這項更新讓 Grok、Cursor 與 Claude 等支援 MCP 的工具，能以使用者帳號權限執行搜尋貼文、管理書籤及發布文章等操作。

**核心功能與架構**
X 官方推出的兩款 MCP 伺服器，旨在將 X 的即時資訊與開發資源直接整合進 AI 工作流中：
- **X MCP**：透過 `https://api.x.com/mcp` 提供 API 介面，支援搜尋貼文、查詢使用者、管理書籤、獲取趨勢與新聞，以及草擬並發布文章。
- **Docs MCP**：透過 `https://docs.x.com/mcp` 提供文件搜尋功能，讓 AI 能即時檢索 X API 的技術文件與範例程式碼。

**技術實作與橋接機制**
由於 X 的 OAuth 協定要求使用開發者應用程式，官方透過 `xurl mcp` 橋接器來處理身分驗證，確保使用者能以個人權限操作：
- 該橋接器透過 `npx` 執行，無需額外安裝步驟，並會自動處理 OAuth2 PKCE 登入與 Token 的自動更新。
- 橋接器將 `stdio` 作為 JSON-RPC 通道，確保與 MCP 客戶端的穩定互動，同時將診斷資訊輸出至 `stderr`。
- 若在無瀏覽器的遠端環境，可透過 `xurl auth oauth2 --headless` 進行離線驗證。

**設定步驟與指令**
使用者需先在 [X Developer Portal](https://developer.x.com) 註冊應用程式並啟用 OAuth 2.0，接著根據所使用的工具進行設定：

1. **安裝 xurl**：
   ```bash
   brew install --cask xdevplatform/tap/xurl
   npm install -g @xdevplatform/xurl
   curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
   ```

2. **Grok Build 設定**（編輯 `~/.grok/config.toml`）：
   ```toml
   [mcp_servers.xapi]
   command = "npx"
   args = ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"]
   enabled = true
   startup_timeout_sec = 300

   [mcp_servers.xapi.env]
   CLIENT_ID = "YOUR_X_APP_CLIENT_ID"
   CLIENT_SECRET = "YOUR_X_APP_CLIENT_SECRET"
   ```

3. **Cursor / Claude Desktop 設定**（於 `mcp.json` 或 `claude_desktop_config.json` 加入）：
   ```json
   {
     "mcpServers": {
       "xapi": {
         "command": "npx",
         "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
         "env": {
           "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
           "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
         }
       }
     }
   }
   ```

**安全與最佳實踐**
- **權限控管**：建議為 MCP 建立專屬的 X 應用程式，僅授予必要的 API 範圍（Scopes）。
- **機密保護**：`~/.xurl` 與存取 Token 屬於敏感資訊，切勿將其提交至版本控制系統或分享於公開日誌中。
- **速率限制**：寫入操作（如發布文章、管理書籤）受到的速率限制較嚴格，若遇到 `429` 錯誤，系統會自動進行退避處理。
- **除錯建議**：若啟動時發生逾時，請將 `startup_timeout_sec` 設定為 300 秒以上，以預留首次瀏覽器登入的時間。可透過 `grok mcp doctor xapi` 指令進行端到端連線測試。

## 標籤

MCP, 功能更新, 新產品, X, Grok, Cursor, Anthropic, Claude