X MCP — официальные MCP-серверы X для X API и документации

X MCP — два официальных сервера Model Context Protocol (MCP) от X: один предоставляет ИИ-инструментам доступ к X API, второй ищет и читает документацию платформы. MCP — протокол, через который ИИ-клиенты подключаются к внешним инструментам и данным.

Сверено с официальными страницами X, доступными 7 сентября 2026 года. Тарифы, лимиты и команды могут меняться, поэтому перед настройкой проверяйте актуальную документацию.

Официальный changelog X API указывает MCP-сервер среди компонентов запуска X API Pay-Per-Use 6 февраля 2026 года. Отдельной записи о запуске именно 30 июня 2026 года в доступном changelog нет.

Какие серверы доступны

X MCP — размещённый сервер X с транспортом Streamable HTTP. В официальной документации указаны версия протокола 2025-06-18 и serverInfo: xmcp. Для OAuth-доступа его подключают к клиенту через локальный stdio-мост xurl.

Docs MCP можно добавить отдельно или вместе с X MCP. В приведённой официальной конфигурации для него не указаны учётные данные.

Возможности X MCP

Набор доступных операций зависит от способа авторизации, разрешений приложения (scopes), тарифного доступа и ограничений конкретного эндпоинта.

Два способа авторизации

X требует собственное приложение разработчика и не поддерживает для этого сервера динамическую регистрацию клиента. api.x.com/mcp также не публикует нативное обнаружение MCP OAuth. Поэтому xurl хранит идентичность приложения локально, проводит вход и добавляет свежий Bearer-токен к запросам.

flowchart LR
    A["MCP-клиент"] -- "stdio JSON-RPC" --> B["xurl mcp"]
    B -- "HTTPS и Bearer-токен" --> C["api.x.com/mcp"]
    B <-- "OAuth 2.0 PKCE и обновление токена" --> D["X OAuth"]

Диагностика моста отправляется в stderr, поэтому stdout остаётся чистым каналом JSON-RPC.

Подключение через xurl

Предварительные условия

1. Создайте приложение в X Developer Portal и включите OAuth 2.0.
2. Зарегистрируйте redirect URI http://localhost:8080/callback. Для другого адреса задайте REDIRECT_URI и зарегистрируйте точное совпадение в настройках приложения.
3. Получите CLIENT_ID и, для конфиденциального клиента, CLIENT_SECRET.
4. Установите Node.js, если будете запускать мост через npx.

Отдельная установка для запуска через npm-лаунчер не обязательна:

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

При первом запуске без сохранённого токена xurl открывает браузер. После завершения OAuth-входа токены сохраняются в ~/.xurl и обновляются автоматически, включая принудительное обновление после ответа 401.

export CLIENT_ID="YOUR_X_APP_CLIENT_ID"
export CLIENT_SECRET="YOUR_X_APP_CLIENT_SECRET"
xurl auth oauth2 --headless

Универсальная конфигурация stdio

{
  "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"
      }
    }
  }
}

Для первого запуска установите тайм-аут старта не меньше 300 секунд, если клиент поддерживает такой параметр. MCP handshake ожидает завершения входа в браузере.

Если xurl установлен как исполняемый файл, используйте:

{
  "command": "xurl",
  "args": ["mcp", "https://api.x.com/mcp"]
}

Grok Build

Файл ~/.grok/config.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"

Проверка подключения:

grok mcp doctor xapi
grok mcp list

Cursor и Claude Desktop

Cursor читает глобальную конфигурацию из ~/.cursor/mcp.json, а проектную — из .cursor/mcp.json. Для Claude Desktop используется claude_desktop_config.json. В обоих случаях подходит универсальная конфигурация mcpServers выше.

После запуска завершите OAuth-вход и убедитесь, что клиент показывает инструменты сервера. В Cursor сервер должен отображаться с зелёным индикатором.

VS Code

Файл .vscode/mcp.json:

{
  "servers": {
    "xapi": {
      "type": "stdio",
      "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"
      }
    }
  }
}

Прямое подключение с App-only Bearer

Если клиент поддерживает удалённый MCP с пользовательскими заголовками и нужен только доступ к совместимым операциям чтения, клиент можно направить прямо на сервер:

{
  "mcpServers": {
    "xapi": {
      "url": "https://api.x.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APP_ONLY_BEARER_TOKEN"
      }
    }
  }
}

Для VS Code укажите type: "http" и используйте раздел servers. Статический App-only токен не обновляется автоматически и не позволяет выполнять действия от имени пользователя.

Docs MCP для поиска по документации

Docs MCP предоставляет два инструмента:

Минимальная конфигурация:

{
  "mcpServers": {
    "x-docs": {
      "url": "https://docs.x.com/mcp"
    }
  }
}

Оба сервера можно подключить одновременно: Docs MCP будет находить описание эндпоинтов, а X MCP — вызывать доступные операции API.

Как проверить результат

1. Запустите проверку MCP-сервера в клиенте или откройте список подключённых серверов.
2. Завершите OAuth-вход, если используется xurl.
3. Убедитесь, что клиент обнаружил инструменты X.
4. Сначала выполните безопасную операцию чтения, например поиск пользователя или постов.
5. Для Docs MCP вызовите поиск по документации и затем получение найденной страницы.

Наблюдаемый признак успеха: сервер проходит начальное рукопожатие MCP (handshake), клиент показывает список инструментов, а операция чтения возвращает структурированный результат без 401, client-not-enrolled или ошибки тайм-аута.

Это руководство основано на официальной документации и не заявляет о выполненном практическом тесте от имени автора.

Полезные сценарии

Дайджест трендов и новостей

Исходное условие: известна нужная локация или тема. Агент получает тренды и новостные сюжеты, затем выбирает связанные посты. Зафиксируйте локацию или запрос и время получения; результат проверяйте по возвращённым сюжетам и постам. Сценарий требует контроля количества возвращаемых ресурсов, поскольку чтение тарифицируется по каждому ресурсу.

Исследование обсуждений

Исходное условие: сформулирован поисковый запрос. Агент выполняет полноархивный поиск, группирует посты и при необходимости получает сведения об авторах. Наблюдаемый результат — набор найденных постов и воспроизводимый запрос. Доступ и итоговая стоимость зависят от приложения и объёма выдачи.

Закладки как вход для контент-пайплайна

При OAuth-доступе с нужными scopes агент может читать закладки, раскладывать материалы по папкам и добавлять новые записи. Результат проверяется в списке закладок аккаунта. Для такого сценария App-only Bearer не подходит, поскольку требуется пользовательский контекст.

Подготовка Articles

Агент может создать черновик Article и опубликовать его через доступные инструменты. Перед публикацией нужен отдельный контроль содержимого и прав. Операции записи ограничиваются scopes, тарифным доступом и более строгими rate limits.

Тарифы и контроль расходов

Для X API действует модель pay-per-use без обязательной подписки: кредиты покупаются заранее, а расход отображается в Developer Console. Чтение тарифицируется за каждый возвращённый ресурс, запись и действия — за запрос.

На pay-per-use действует лимит в 3 млн чтений постов за месячный биллинговый цикл. Для большего объёма требуется Enterprise.

Owned Reads применяются к перечисленным X эндпоинтам собственных данных, когда ID совпадает с авторизованным пользователем и этот пользователь владеет приложением. К ним относятся собственные посты, упоминания, закладки, подписчики, подписки, лайки и списки.

Ресурсы дедуплицируются в пределах календарных суток UTC: повторное получение того же оплаченного ресурса обычно не списывает кредит снова. X называет дедупликацию мягкой гарантией, поэтому при сбоях возможны исключения.

Для контроля расходов доступны:

• Spending limit — максимальная сумма за биллинговый цикл; после достижения лимита запросы блокируются.
• Auto-recharge — автоматическое пополнение. Оно срабатывает не чаще одного раза за пять минут и приостанавливается при нулевом или отрицательном балансе.
• Usage API — GET /2/usage/tweets возвращает суточное потребление постов.
• Бесплатные кредиты xAI API — после привязки команды xAI: 10% при накопленных покупках $200–499, 15% при $500–999 и 20% от $1 000 за цикл.

Пример оценки: тренды за $0.010, 40 прочитанных постов по $0.005 и 10 пользователей по $0.010 составят около $0.31 до учёта дедупликации и Owned Reads.

Типичные ошибки

Безопасность

• Создайте отдельное приложение для MCP и выдайте только необходимые scopes.
• Передавайте Client Secret и токены через переменные окружения и не коммитьте их в репозиторий.
• Учитывайте, какой аккаунт открыт в браузере во время OAuth-входа: именно он будет авторизован.
• Для записи обрабатывайте ответы 429 с задержкой и повтором.
• Мост работает локально. Согласно документации X, учётные данные остаются на машине, а серверу по TLS передаётся Bearer-токен.

Официальные ссылки

• X Developer Platform
• MCP servers for the X API and developer docs
• xurl — клиент командной строки для X API
• OAuth 2.0 Authorization Code Flow with PKCE
• Тарифы X API
• Changelog X API
• OpenAPI-спецификация X API v2

Следующий шаг

Чтобы отдельно разобраться в протоколе MCP, прочитайте MCP (Model Context Protocol) — стандарт подключения ИИ к внешним системам.

X MCP подходит для контуров, где ИИ-агенту нужны актуальные данные X, поиск по архиву, пользовательские закладки или подготовка публикаций. Начинать безопаснее с отдельного приложения, минимальных scopes и небольшого spending limit.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov