MCP-серверы X API и документации
Подключение Grok, Cursor и других AI-инструментов к X API и документации через MCP-сервера с OAuth-авторизацией.
privacy
Эта заметка участвует в semantic memory.
AI Summary
🚀 TL;DR: X предоставляет два MCP-сервера — X MCP для вызова API (поиск постов, управление закладками, публикация Articles) и Docs MCP для поиска по документации. Подключение происходит через локальный bridge xurl или напрямую с Bearer-токеном.
🔑 Ключевые факты: X MCP доступен по URL https://api.x.com/mcp (протокол 2025-06-18), Docs MCP — https://docs.x.com/mcp. Для полной функциональности (включая запись) требуется OAuth 2.0 через bridge xurl с PKCE. Простой режим (App-only Bearer) даёт только чтение без контекста пользователя.
📌 Важные детали: Bridge xurl устанавливается через npm (npx -y @xdevplatform/xurl), требует CLIENT_ID/CLIENT_SECRET, регистрирует redirect_uri http://localhost:8080/callback. Первый запуск открывает браузер для логина, токен кэшируется и автообновляется. Для headless-машин используется xurl auth oauth2 --headless. Таймаут запуска клиента должен быть ≥300 секунд. Ошибки 401/429 требуют повторного логина или бэкоффа.
💡 Вывод и значение: Создать приложение в X Developer Portal, включить OAuth 2.0, скопировать CLIENT_ID/CLIENT_SECRET, добавить серверы в конфиги Grok/Cursor/Claude/VS Code по примерам TOML/JSON. Проверить подключение командой grok mcp doctor xapi. Для работы с документацией подключить x-docs по URL https://docs.x.com/mcp. При необходимости скачать OpenAPI-спецификацию https://api.x.com/2/openapi.json.