Meta Ads — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер, который даёт агенту прямой доступ к API Meta Ads: читать статистику кампаний, сравнивать показатели, менять бюджеты и статусы.
Apache-2.0 обновлён 2026-10-23
claude mcp add --env META_ACCESS_TOKEN=<META_ACCESS_TOKEN> --env META_ENABLE_WRITES=<META_ENABLE_WRITES> --env META_API_VERSION=<META_API_VERSION> --transport stdio get-mcp-ads-meta-ads -- npx -y @getmcpads/meta-ads-mcp-serverЧто делает Meta Ads
Сервер предоставляет 42 инструмента для чтения (кампании, группы объявлений, креативы, аудитории, пиксели, каталоги, страницы, A/B-тесты, логи активности) и 24 инструмента для записи — по умолчанию выключены, каждое изменение показывает превью перед применением. Агент может запрашивать 190 метрик, включая производные (ROAS, CPA, частота показов), и группировать данные по 56 параметрам и 90 измерениям. Матрица совместимости проверяет допустимость комбинаций до отправки запроса.
Сервер работает локально, запросы идут напрямую в API платформы через токен доступа META_ACCESS_TOKEN. Требуется Node.js версии 22.23.4 и новее на 22-й ветке, 24.22.1 и новее на 24-й, либо 26.12.1 и новее — эти релизы включают исправления безопасности октября 2026 года. Инструменты записи включаются переменной META_ENABLE_WRITES=true; без неё доступны только операции чтения.
Какие задачи решает
- сравнить эффективность кампаний по ROAS и CPA за период
- проверить статус доставки объявлений и причины отклонения
- изменить бюджет или расписание группы объявлений после превью
- получить метрики с группировкой по возрасту, полу и устройству
- переименовать кампанию или создать новую с заданными параметрами
Примеры запросов агенту
- Покажи все активные кампании аккаунта и их расход за последние 7 дней
- Сравни CTR и конверсии по группам объявлений кампании
<id>с разбивкой по платформам - Измени дневной бюджет группы
<adset_id>на 150 долларов — сначала покажи превью
Как установить Meta Ads
Командой платформы
claude mcp add --env META_ACCESS_TOKEN=<META_ACCESS_TOKEN> --env META_ENABLE_WRITES=<META_ENABLE_WRITES> --env META_API_VERSION=<META_API_VERSION> --transport stdio get-mcp-ads-meta-ads -- npx -y @getmcpads/meta-ads-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add get-mcp-ads-meta-ads --env META_ACCESS_TOKEN=<META_ACCESS_TOKEN> --env META_ENABLE_WRITES=<META_ENABLE_WRITES> --env META_API_VERSION=<META_API_VERSION> -- npx -y @getmcpads/meta-ads-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"get-mcp-ads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_ENABLE_WRITES": "<META_ENABLE_WRITES>",
"META_API_VERSION": "<META_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"get-mcp-ads-meta-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_ENABLE_WRITES": "<META_ENABLE_WRITES>",
"META_API_VERSION": "<META_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -e META_ENABLE_WRITES=<META_ENABLE_WRITES> -e META_API_VERSION=<META_API_VERSION> get-mcp-ads-meta-ads npx -y @getmcpads/meta-ads-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Meta Ads
Как установить Meta Ads в Claude Code?
Выполни claude mcp add meta-ads -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- npx -y @getmcpads/meta-ads-mcp-server. Токен доступа Meta возьми в настройках приложения на developers.facebook.com.
Что делает Meta Ads?
Даёт агенту доступ к API Meta Ads: читать статистику кампаний, объявлений и креативов, менять бюджеты, статусы и расписание, создавать кампании. Инструменты записи выключены по умолчанию и показывают превью перед каждым изменением.
Какая версия Node.js нужна для Meta Ads?
Версия 22.23.4 и новее на 22-й линии, 24.22.1 и новее на 24-й, либо 26.12.1 и новее. На более старой версии сервер запустится с предупреждением в stderr.