X Ads — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для чтения отчётов и управления кампаниями в X Ads через локальный stdio. Пригодится таргетологам и разработчикам для аудита и правок рекламы без веб-интерфейса.
claude mcp add --env X_ADS_ACCESS_TOKEN=<X_ADS_ACCESS_TOKEN> --env X_ADS_ACCOUNT_IDS=<X_ADS_ACCOUNT_IDS> --env X_ADS_SCOPES=<X_ADS_SCOPES> --env X_ADS_ENABLE_WRITES=<X_ADS_ENABLE_WRITES> --transport stdio x-ads -- npx -y @getmcpads/x-ads-mcp-serverЧто делает X Ads
Сервер подключает клиент к API X Ads напрямую по протоколу stdio. Внутри доступны 25 инструментов чтения и 21 инструмент изменения данных. Через них агент запрашивает метрики эффективности, таргетинг, списки кампаний или переименовывает рекламные сущности.
Любые операции записи по умолчанию отключены. Чтобы их открыть, флаг X_ADS_ENABLE_WRITES выставляют строго в true вместе со скоупом ads.write. Все изменения сначала возвращают предпросмотр, а реальное действие требует отдельного флага confirm: true. Новые кампании создаются на паузе, поэтому случайного списания бюджета не произойдёт.
Без пользовательского OAuth 2.0 токена сервер не заработает — серверный app-only токен API X отклоняет сразу. Сервер не обновляет токены сам: при истечении сессии придётся обновить значение и перезапустить процесс. Нужна версия Node.js не ниже 22.23.4, 24.22.1 или 26.12.1.
Какие задачи решает
- выгрузить метрики эффективности рекламных кампаний из X Ads
- проверить настройки таргетинга выбранных рекламных аккаунтов
- переименовать кампанию или группу объявлений с обязательным превью
- загрузить медиафайл размером до 4 МБ для рекламных креативов
Примеры запросов агенту
- Покажи статистику расходов по кампаниям в аккаунте из X_ADS_ACCOUNT_IDS за прошлую неделю.
- Сделай предпросмотр переименования кампании с ID 123456 на Brand Campaign Q4.
- Подтверди переименование кампании 123456, передай confirm: true.
Как установить X Ads
Командой платформы
claude mcp add --env X_ADS_ACCESS_TOKEN=<X_ADS_ACCESS_TOKEN> --env X_ADS_ACCOUNT_IDS=<X_ADS_ACCOUNT_IDS> --env X_ADS_SCOPES=<X_ADS_SCOPES> --env X_ADS_ENABLE_WRITES=<X_ADS_ENABLE_WRITES> --transport stdio x-ads -- npx -y @getmcpads/x-ads-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add x-ads --env X_ADS_ACCESS_TOKEN=<X_ADS_ACCESS_TOKEN> --env X_ADS_ACCOUNT_IDS=<X_ADS_ACCOUNT_IDS> --env X_ADS_SCOPES=<X_ADS_SCOPES> --env X_ADS_ENABLE_WRITES=<X_ADS_ENABLE_WRITES> -- npx -y @getmcpads/x-ads-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"x-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/x-ads-mcp-server"
],
"env": {
"X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
"X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>",
"X_ADS_SCOPES": "<X_ADS_SCOPES>",
"X_ADS_ENABLE_WRITES": "<X_ADS_ENABLE_WRITES>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"x-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/x-ads-mcp-server"
],
"env": {
"X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
"X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>",
"X_ADS_SCOPES": "<X_ADS_SCOPES>",
"X_ADS_ENABLE_WRITES": "<X_ADS_ENABLE_WRITES>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e X_ADS_ACCESS_TOKEN=<X_ADS_ACCESS_TOKEN> -e X_ADS_ACCOUNT_IDS=<X_ADS_ACCOUNT_IDS> -e X_ADS_SCOPES=<X_ADS_SCOPES> -e X_ADS_ENABLE_WRITES=<X_ADS_ENABLE_WRITES> x-ads npx -y @getmcpads/x-ads-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о X Ads
Как установить X Ads в Claude Code?
Выполните команду claude mcp add x-ads -e X_ADS_ACCESS_TOKEN=<X_ADS_ACCESS_TOKEN> -e X_ADS_ACCOUNT_IDS=<X_ADS_ACCOUNT_IDS> -- npx -y @getmcpads/x-ads-mcp-server. Замените плейсхолдеры на свой токен OAuth 2.0 и ID рекламных кабинетов.
Что делает MCP-сервер X Ads?
Он даёт ассистенту 25 инструментов чтения данных и 21 инструмент записи для взаимодействия с X Ads API. Позволяет проверять таргетинг, снимать метрики и безопасно готовить изменения рекламы.
Почему операции записи не работают сразу после запуска?
Они отключены ради безопасности. Для их включения нужно явно передать X_ADS_ENABLE_WRITES=true, добавить права ads.write и подтверждать каждый вызов параметром confirm: true.
