# MCP-сервер для Twitter: Claude и Cursor

Удалённый MCP-сервер для Twitter в Claude, Cursor и Codex. Агент читает общедоступные публикации X, ветки и результаты поиска в Markdown. Оплата за публикацию.

Page: https://twitterviewer.app/ru/twitter-mcp-server

Дайте Claude, Cursor и Codex доступ к чтению общедоступного контента X. Один удалённый сервер, пять инструментов только для чтения, результат — в Markdown. Войдите один раз через браузер или используйте ключ API.

TwitterViewer — независимый сервис. Это не официальный API X, и он не связан с X Corp. Сервис читает только общедоступные публикации: он не может публиковать, ставить лайки, подписываться, отправлять сообщения или читать закрытые аккаунты.

## Connect

Server URL: https://twitterviewer.app/mcp (Streamable HTTP). При первом подключении откроется браузер для входа в TwitterViewer. Дополнительная настройка не нужна.

### Claude Code

```
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp
```

With an API key:

```
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp \
  --header "Authorization: Bearer $TWITTERVIEWER_API_KEY"
```

### Cursor

```
{
  "mcpServers": {
    "twitterviewer": { "url": "https://twitterviewer.app/mcp" }
  }
}
```

With an API key:

```
{
  "mcpServers": {
    "twitterviewer": {
      "url": "https://twitterviewer.app/mcp",
      "headers": { "Authorization": "Bearer ${env:TWITTERVIEWER_API_KEY}" }
    }
  }
}
```

### Codex

```
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
```

With an API key:

```
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
bearer_token_env_var = "TWITTERVIEWER_API_KEY"
```

## Tools

| Tool | Arguments | What it does |
| --- | --- | --- |
| convert_x_url | url, scope, format, stats, max | Turns a post, thread or profile link into Markdown, Obsidian, text or JSON. |
| search_x_posts | query, max | Searches public posts (Pro and Business). |
| get_x_replies | url, max | Reads the replies under a post. |
| get_x_trends | region | Lists trends for a region. |
| get_credits | none | Shows the balance. |

MCP-сервер для Twitter даёт ИИ-ассистенту безопасный способ читать X. TwitterViewer предоставляет такой удалённый сервер по адресу `https://twitterviewer.app/mcp`. Добавьте его в Claude, Claude Code, Cursor или Codex, и ассистент сможет превращать ссылки из X в Markdown, читать ответы под постами, искать общедоступные публикации и проверять актуальные тренды — без ручного копирования и вставки.

Сервер работает только на чтение. Он не может публиковать посты, отвечать, ставить лайки, подписываться, отправлять сообщения или получать доступ к закрытым аккаунтам. Это независимый сервис, не связанный с X Corp. В этом руководстве объясняется, что такое MCP-сервер для Twitter, как подключить его в каждом клиенте, как работает вход, что делают пять инструментов, как списываются кредиты и как решать распространённые проблемы.

## Что такое MCP-сервер для Twitter?

MCP, или Model Context Protocol, — открытый стандарт, который позволяет ИИ-клиенту вызывать инструменты другой программы. MCP-сервер для Twitter предоставляет инструменты для чтения X (Twitter) через этот стандарт. Вместо того чтобы вставлять ветку в чат, вы просите ассистента прочитать ссылку. Ассистент вызывает инструмент, получает Markdown и работает с ним.

Этот сервер работает удалённо. Вам не нужно ничего устанавливать или постоянно держать запущенный процесс на компьютере: клиент подключается к URL через Streamable HTTP. Это тот же сервис, что и [Twitter API](https://twitterviewer.app/ru/twitter-api), поэтому используется общий баланс кредитов: один кредит за каждый возвращённый пост, а неудачные вызовы бесплатны.

Его также могут называть MCP-сервером для X или Twitter MCP. Всё это означает одно и то же: сервер инструментов, с помощью которого агент читает общедоступные посты. Серверы различаются набором возможностей. Этот намеренно ограничен чтением общедоступного контента.

## Что MCP-сервер для Twitter позволяет делать вашему агенту?

После подключения агент может выполнять четыре вида задач с контентом X:

- **Читать по ссылке.** Передайте адрес поста, ветки или профиля, и он вернёт Markdown, заметки Obsidian, обычный текст или JSON.
- **Искать.** Попросите найти общедоступные посты с помощью поисковых операторов X, например все публикации аккаунта, набравшие не менее 100 лайков. Поиск доступен на тарифах Pro и Business.
- **Читать ответы.** Узнайте, что люди отвечают под постом и какие возражения повторяются.
- **Проверять тренды.** Получите список актуальных тем в выбранном регионе.

Ответы приходят в формате Markdown, поэтому занимают мало места в контексте модели и сохраняют структуру оригинала: порядок постов в ветке, ссылки автора и ссылки на изображения. Агент получает готовый документ, ему не приходится собирать данные с веб-страницы и гадать, как она устроена.

## Подключение MCP-сервера для Twitter

URL сервера — `https://twitterviewer.app/mcp`. Выберите свой клиент ниже. Во всех примерах используется вход через браузер — самый простой способ подключения.

### Claude Code

Выполните в терминале одну команду:

```bash
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp
```

Запустите Claude Code, выполните `/mcp`, чтобы увидеть сервер, и при первом подключении перейдите по ссылке для входа. После этого можно попросить обычными словами: «Прочитай https://x.com/username/status/1234567890123456789 в формате Markdown».

### Claude

В веб-версии или настольном приложении Claude откройте настройки, перейдите в раздел подключений, выберите добавление пользовательского подключения и вставьте URL сервера. Claude откроет окно браузера для входа в TwitterViewer. После этого инструменты появятся в ваших чатах.

### Cursor

Добавьте сервер в свой `mcp.json`:

```json
{
  "mcpServers": {
    "twitterviewer": { "url": "https://twitterviewer.app/mcp" }
  }
}
```

Откройте настройки MCP в Cursor, включите сервер и войдите в аккаунт, когда появится запрос.

### Codex

Добавьте сервер в файл конфигурации Codex:

```toml
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
```

Перезапустите Codex, и в нём появятся все пять инструментов.

## Вход через браузер или с ключом API

Авторизовать MCP-сервер для Twitter можно двумя способами. Для каждого клиента способ можно выбрать отдельно.

**Вход через браузер** используется по умолчанию. При первом подключении клиент открывает браузер, чтобы вы вошли в TwitterViewer и разрешили подключение. Дополнительные настройки не нужны, и вам не приходится копировать секретные данные.

**Ключ API** подходит для сред без браузера: серверов, задач CI и некоторых редакторов. Создайте ключ на странице API, экспортируйте его в переменную `TWITTERVIEWER_API_KEY` и передавайте как токен Bearer. В Claude Code добавьте к команде `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"`. В Cursor добавьте запись `headers` с тем же значением. В Codex добавьте `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` под URL.

В обоих случаях кредиты списываются с аккаунта, под которым выполнен вход. Не храните ключи в общих файлах и репозиториях. Если ключ утёк, удалите его на странице API. Каждый аккаунт может иметь хотя бы один ключ: 1 на бесплатном тарифе, 2 на Plus, 5 на Pro и 20 на Business.

## Пять инструментов

Все пять работают только на чтение и доступны агенту под следующими именами.

| Инструмент | Что делает | Стоимость |
| --- | --- | --- |
| `convert_x_url` | Преобразует ссылку на пост, ветку или профиль в Markdown, Obsidian, текст или JSON | 1 кредит за пост |
| `search_x_posts` | Ищет общедоступные посты с помощью поисковых операторов X (Pro и Business) | 1 кредит за пост |
| `get_x_replies` | Читает общедоступные ответы под постом | 1 кредит за ответ |
| `get_x_trends` | Возвращает список актуальных тем в регионе | 1 кредит за вызов |
| `get_credits` | Показывает баланс и источники кредитов | Бесплатно |

`convert_x_url` принимает ссылку, охват (`post`, `thread` или `conversation`), формат, а для профилей — ещё и количество возвращаемых постов. Этим инструментом агенты пользуются чаще всего. `search_x_posts` принимает запрос и максимальное количество постов. Для него нужен подключённый аккаунт X, поскольку X показывает результаты поиска только вошедшим пользователям. Полный список аргументов приведён на странице [Документация API](https://twitterviewer.app/docs/api).

## О чём просить агента

Сервер инструментов полезен, когда вы знаете, какую задачу ему поручить. После подключения хорошо работают такие запросы:

- «Прочитай эту ветку и выдели пять главных мыслей: https://x.com/username/status/1234567890123456789»
- «Найди в X посты о нашем запуске за последнюю неделю и сгруппируй их по темам».
- «Что люди отвечают на этот пост? Покажи повторяющиеся возражения».
- «Преобразуй эту ветку в Markdown для Obsidian и сохрани как заметку».
- «Какие темы сейчас в тренде в Японии?»
- «Сколько кредитов TwitterViewer у меня осталось?»

Агенты могут сочетать инструменты. Например, при исследовании агент может найти посты, преобразовать три самые подходящие ветки, прочитать ответы под одной из них и затем написать краткий обзор. Каждый шаг — отдельный вызов инструмента, стоимость которого зависит от числа возвращённых постов. После выполнения расходы можно проверить через `get_credits`.

Если вам нужно один раз прочитать одну ветку, страница [X в Markdown](https://twitterviewer.app/ru/x-to-markdown) решает ту же задачу в браузере, а [Чтение веток Twitter](https://twitterviewer.app/ru/twitter-thread-reader) показывает всю ветку на одной странице. MCP-сервер нужен агентам, которые должны делать это самостоятельно.

## Сценарии работы с MCP-сервером для Twitter

На отдельные вопросы ответить несложно. Сервер особенно полезен, когда агент объединяет инструменты в небольшую последовательность действий. Три сценария встречаются чаще всего.

**Отбор материалов для чтения.** Вы вставляете в чат десять ссылок из X и спрашиваете, какие стоит прочитать. Агент вызывает `convert_x_url` для каждой ссылки, задаёт `scope` со значением `thread` и отключает `stats`, чтобы сократить текст, а затем ранжирует материалы по содержательности. Девять из десяти ссылок могут вести на одиночные посты, поэтому расходы часто составляют около десяти кредитов.

**Исследование темы.** Вы просите агента выяснить, что люди думают о продукте. Он использует `search_x_posts` с несколькими операторами, преобразует две-три лучшие ветки, читает ответы под самым обсуждаемым постом через `get_x_replies` и пишет короткий отчёт со ссылками на источники. Стоимость равна числу фактически прочитанных постов; после выполнения баланс можно проверить через `get_credits`.

**Сохранение заметок.** Вы просите сохранить ветку как заметку Obsidian. Агент вызывает `convert_x_url` с форматом `obsidian`, который добавляет метаданные frontmatter с автором, датой и ссылкой на источник, и записывает файл в ваше хранилище. Результат такой же, как на странице [X в Markdown](https://twitterviewer.app/ru/x-to-markdown), но вы получаете его прямо из чата.

Две привычки помогают экономить кредиты. Просите прочитать ветку, а не профиль, если вам не нужны последние публикации: профиль с 200 постами стоит 200 кредитов. И поручите агенту останавливаться и спрашивать разрешение, прежде чем преобразовывать больше нескольких длинных веток, чтобы вы контролировали баланс.

## Кредиты и ограничения

Кредиты работают так же, как в REST API. Один кредит — один возвращённый пост. Данные об авторе бесплатны. За неудачный вызов, пустой результат или PDF, который не удалось сформировать, кредиты не списываются. Бесплатный аккаунт получает 50 кредитов однократно. Платные тарифы добавляют 3 000, 8 000 или 25 000 кредитов в месяц. Пакеты на 1 000, 6 000 и 20 000 кредитов стоят $5, $20 и $50 и не имеют срока действия. Подробнее о планах — на странице [Тарифы](https://twitterviewer.app/ru/pricing).

Количество вызовов ограничено для каждого аккаунта в минуту: 10 на бесплатном тарифе, 30 на Plus, 60 на Pro и 300 на Business. Если агент запускает цикл, лимит также защищает баланс. Когда кредиты заканчиваются, инструмент не выдаёт ошибку с трассировкой стека: он возвращает одну строку со ссылкой на страницу тарифов, и агент может передать её вам.

Для данных действуют те же ограничения, что и в API. Доступны только общедоступные посты, поэтому закрытые аккаунты, защищённые посты, личные сообщения, удалённые публикации и заблокированные аккаунты не дадут полезного результата. Контент ненадолго кешируется — примерно на две минуты для поста, поэтому совсем свежая правка может ещё не отображаться.

## Только чтение — по замыслу

Многие опасаются давать агенту доступ к аккаунту в соцсети, и на то есть причины: агент с правом записи может случайно что-нибудь опубликовать. Этот MCP-сервер для Twitter исключает такую проблему. У него нет инструментов для публикации постов, ответов, лайков, репостов, подписок, блокировок или отправки сообщений. Он никогда не запрашивает ваш пароль или токены X. Максимум, что может сделать запутавшийся агент, — потратить кредиты на чтение, а лимит запросов и ваш баланс ограничивают эти расходы.

Поиск — единственная функция, которая использует аккаунт X, поскольку X показывает результаты поиска только вошедшим пользователям. Для этого используется аккаунт X, который вы сами подключаете на тарифе Pro или Business, и только для запросов, сделанных вами или вашим агентом. Отключить его можно в любой момент.

## MCP-сервер для Twitter, API, CLI или замена домена: что выбрать?

Все четыре способа используют общий баланс. Выбирайте в зависимости от того, где выполняется работа.

- **MCP-сервер:** подходит, когда ассистент вроде Claude, Cursor или Codex должен сам решать, когда читать X. Без кода, копирования и вставки.
- **REST API:** подходит для ваших скриптов, конвейеров обработки и приложений. Подробнее на странице [Twitter API](https://twitterviewer.app/ru/twitter-api).
- **Инструмент командной строки:** `npx twitterviewer <link>` для быстрого преобразования в терминале или скрипте оболочки.
- **Замена домена:** замените `x.com` на `twitterviewer.app` в ссылке и передайте свой ключ; в ответ придёт Markdown.

Навык для агента по адресу `/.well-known/agent-skills/twitterviewer/SKILL.md` может научить его выбирать между этими способами, когда он встречает ссылку из X.

## Решение проблем с MCP-сервером для Twitter

Если сервер не подключается, сначала проверьте следующее.

- **Клиент сообщает, что не может связаться с сервером.** Убедитесь, что URL указан точно: `https://twitterviewer.app/mcp`. Клиентам, которые поддерживают только локальные серверы, нужен промежуточный адаптер. Claude Code, Claude, Cursor и Codex подключаются к удалённым серверам напрямую.
- **Вход через браузер зацикливается.** Завершите вход в том же профиле браузера, который открыл клиент, и убедитесь, что вошли в аккаунт, с которого хотите списывать кредиты.
- **Инструмент сообщает, что кредиты закончились.** Проверьте `get_credits`, затем купите пакет на странице тарифов или дождитесь обновления месячного лимита.
- **Поиск отклоняется.** Для поиска нужны Pro или Business и подключённый аккаунт X. Подключите его на странице «Аккаунт X» в настройках.
- **Ссылка ничего не возвращает.** Пост мог быть удалён или защищён, а аккаунт — заблокирован. Откройте ссылку на странице [Просмотр профиля Twitter](https://twitterviewer.app/ru/twitter-profile-viewer), чтобы увидеть общедоступный контент.
- **Появилось сообщение о превышении лимита запросов.** Подождите указанное в нём количество секунд или перейдите на тариф с более высоким лимитом в минуту.

## MCP-сервер для Twitter: часто задаваемые вопросы

### Что такое MCP-сервер для Twitter?

MCP-сервер для Twitter позволяет ИИ-ассистенту читать X через Model Context Protocol. Версия TwitterViewer работает удалённо, поддерживает только чтение и возвращает Markdown. Благодаря этому агент может читать ветки, искать посты, читать ответы и проверять тренды прямо из Claude, Cursor или Codex.

### Это официальный MCP-сервер X?

Нет. Это независимый сервис, не связанный с X Corp. Он читает только общедоступные посты и не может публиковать, ставить лайки, подписываться или отправлять сообщения.

### Как добавить MCP-сервер для Twitter в Claude Code?

Выполните `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp`, затем откройте `/mcp` внутри Claude Code и при первом подключении войдите через браузер. После этого попросите ассистента прочитать ссылку из X.

### Он работает с Cursor и Codex?

Да. В Cursor добавьте URL в раздел `mcpServers` файла `mcp.json`. В Codex добавьте блок `[mcp_servers.twitterviewer]` с URL. Оба клиента поддерживают вход через браузер и использование ключа API в качестве токена Bearer.

### Нужен ли ключ API?

Нет. Вход через браузер работает без ключа. Ключ полезен в средах без браузера, например на серверах и в CI. Создать его можно на странице API.

### Что умеют инструменты?

Их пять: `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends` и `get_credits`. Все работают только на чтение. Они преобразуют ссылки, ищут общедоступные посты, читают ответы, возвращают список трендов и показывают баланс.

### Сколько стоит использование?

Используются те же кредиты, что и в API: один кредит за возвращённый пост. Данные об авторе и неудачные вызовы бесплатны. Бесплатный аккаунт получает 50 кредитов однократно, а платные тарифы добавляют 3 000, 8 000 или 25 000 кредитов в месяц. Пакеты кредитов стоят $5, $20 и $50 и не имеют срока действия.

### Может ли агент публиковать посты или ставить лайки за меня?

Нет. У сервера нет инструментов для записи в X. Он не может публиковать посты, отвечать, ставить лайки, делать репосты, подписываться или отправлять сообщения и никогда не запрашивает ваш пароль X.

### Почему для поиска нужны Pro или Business?

X показывает результаты поиска только вошедшим пользователям, поэтому для поиска нужен аккаунт X. Эта функция входит в Pro и Business и использует аккаунт, который вы подключаете сами.

### Можно ли использовать MCP-сервер для Twitter с закрытыми аккаунтами?

Нет. Доступен только общедоступный контент. Закрытые аккаунты, защищённые посты, личные сообщения и удалённые публикации не возвращаются.