ChatGPT Ads — MCP-сервер для Claude Code: установка и обзор
MCP-сервер для работы с рекламным кабинетом ChatGPT Ads. Помогает смотреть метрики, аудитории и кампании прямо через AI-клиент.
claude mcp add --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> --transport stdio chatgpt-ads -- npx -y @getmcpads/chatgpt-ads-mcp-serverЧто делает ChatGPT Ads
Сервер связывает AI-ассистента с ChatGPT Ads Advertiser API по протоколу stdio. В базовом наборе доступно 30 инструментов чтения: статистика кампаний, групп объявлений, креативов, данные о конверсиях, лимиты расходов, аудитории и журналы аудита. Все запросы идут напрямую на api.ads.openai.com без промежуточных серверов.
Инструменты изменения отключены по умолчанию — их 28 штук, и для их активации переменная OPENAI_ADS_ENABLE_WRITES должна быть равна true. Даже если запись включена, сервер сначала формирует точный предпросмотр операции и требует явного подтверждения. Созданные кампании создаются на паузе, а переход в статус active блокируется переменной OPENAI_ADS_ENABLE_ACTIVATION.
Для работы требуется Advertiser API key из Ads Manager и идентификатор кабинета вида adacct_.... Обычный API-ключ от OpenAI Platform сюда не подходит.
Какие задачи решает
- проверить статистику рекламных кампаний и конверсий с разбивкой по устройствам и странам
- просмотреть настройки групп объявлений и креативов chat card без перехода в веб-интерфейс
- подготовить изменения бюджета или кампаний с предварительным просмотром перед отправкой
Примеры запросов агенту
- Покажи текущий расход бюджета и статус кампаний в аккаунте через openai_ads_get_account
- Собери аналитику по конверсиям и аудиториям за последнюю неделю
- Подготовь черновик новой группы объявлений и покажи превью перед сохранением
Как установить ChatGPT Ads
Командой платформы
claude mcp add --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> --transport stdio chatgpt-ads -- npx -y @getmcpads/chatgpt-ads-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add chatgpt-ads --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> -- npx -y @getmcpads/chatgpt-ads-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"chatgpt-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>",
"OPENAI_ADS_ENABLE_WRITES": "<OPENAI_ADS_ENABLE_WRITES>",
"OPENAI_ADS_ENABLE_ACTIVATION": "<OPENAI_ADS_ENABLE_ACTIVATION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"chatgpt-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>",
"OPENAI_ADS_ENABLE_WRITES": "<OPENAI_ADS_ENABLE_WRITES>",
"OPENAI_ADS_ENABLE_ACTIVATION": "<OPENAI_ADS_ENABLE_ACTIVATION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> -e OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> -e OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> -e OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> chatgpt-ads npx -y @getmcpads/chatgpt-ads-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ChatGPT Ads
Как установить ChatGPT Ads в Claude Code?
Выполните команду `claude mcp add chatgpt-ads -e OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> -e OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> -- npx -y @getmcpads/chatgpt-ads-mcp-server`.
Что делает ChatGPT Ads MCP-сервер?
Предоставляет вашему AI-ассистенту 30 инструментов для чтения данных рекламного аккаунта и 28 инструментов безопасной записи с обязательным подтверждением.
Какой ключ нужен для подключения к ChatGPT Ads?
Нужен специальный Advertiser API key со страницы настроек Ads Manager, привязанный к аккаунту adacct_.... Ключ от OpenAI Platform API не сработает.
