Meta Ads MCP в Cursor, VS Code и Claude Code: руководство по настройке
Подключите Meta Ads к Cursor, VS Code или Claude Code одним MCP-адресом: конфигурация для каждого редактора, вход и как оставить изменения рекламы за собой.
На этой странице
Подключить Meta Ads внутри Cursor, VS Code или Claude Code можно, добавив один адрес удалённого MCP-сервера, https://teraads.co/mcp, и войдя в Tera Ads в браузере. Ничего не нужно устанавливать или размещать. Cursor и VS Code принимают короткую JSON-запись, Claude Code — одну команду, после чего все три могут читать ваши живые кампании и прибыль вашего магазина на Shopify после возвратов. Вы выбираете для каждого подключения, будет ли ИИ только читать, сначала спрашивать вас или вносить изменения.
Главное
- Один адрес работает во всех трёх редакторах:
https://teraads.co/mcp— размещённый MCP-сервер с входом через браузер и без API-ключей в вашей конфигурации. - Cursor читает
~/.cursor/mcp.jsonдля всех проектов или.cursor/mcp.jsonдля одного; VS Code использует MCP: Add Server или.vscode/mcp.json. - Claude Code требует одну команду
claude mcp addили плагин, который добавляет сервер и шесть готовых рекламных навыков. - Ваш ИИ получает 29 инструментов: живое чтение Meta, прибыль вашего магазина после возвратов, а также паузы, включения и изменения бюджета в жёстких пределах.
- Решите, что ИИ вправе делать, ещё до подключения: только чтение, сначала спрашивать или вносить изменения.
Зачем подключать Meta Ads к редактору кода
Если вы сами делаете тему Shopify, скрипты или внутренние инструменты, редактор — это уже то место, где вы проводите день. ИИ-агент там может ответить на вопрос о рекламе без похода в Ads Manager, записать ответ в файл вашего репозитория или проверить, ведёт ли страница, которую вы только что изменили, туда же, куда ваши лучшие объявления отправляют людей.
MCP, Model Context Protocol, — открытый стандарт, благодаря которому это работает: агент редактора вызывает инструменты, которые предоставляет сервер, а сервер общается с рекламной платформой. Как это устроено, описано в материале о MCP-коннекторах. В документации Cursor в качестве поддерживаемых транспортов указаны stdio, SSE и Streamable HTTP, и сказано, что он поддерживает OAuth для серверов, которым это нужно (документация Cursor по MCP). Claude Code входит на удалённые серверы через OAuth командой /mcp (документация Claude Code по MCP). Так что размещённому серверу не нужны ключи, вставленные в файл конфигурации.
Tera Ads Connect — сервер именно такого рода, созданный для брендов на Shopify. Помимо живого чтения Meta он отвечает по вашему магазину: заказам, возвратам, себестоимости, доставке, комиссиям и возмещениям за вычетом ваших расходов на рекламу в Meta и Google. Атрибутированная выручка Meta помечена как данные Meta, поэтому ваш ИИ не принимает её за продажи. Если хотите увидеть более широкую картину серверов, которые можно использовать вместо этого, их сравнивают варианты MCP для Meta Ads.
Прежде чем начать
- Бесплатный аккаунт Tera Ads. Зарегистрируйтесь и подключите рекламный аккаунт Meta. Подключите и Shopify, чтобы ваш ИИ видел продажи и прибыль магазина.
- Доступ владельца. Подключить ИИ к бизнесу в Tera Ads может только владелец бизнеса.
- Ваш редактор. Cursor, VS Code с окном чата или Claude Code в терминале.
- Решение об изменениях. Определите, будет ли ИИ только отчитываться или ещё и ставить объявления на паузу и менять бюджеты. В руководстве по безопасному доступу ИИ есть короткая политика, которую можно скопировать.
Настройка в пять шагов
- Создайте бесплатный аккаунт Tera Ads. Зарегистрируйтесь, подключите рекламный аккаунт Meta, затем подключите Shopify, чтобы ответы включали прибыль магазина после возвратов.
- Добавьте адрес сервера в редактор. Вставьте
https://teraads.co/mcpв настройки MCP Cursor или VS Code либо выполните одну команду в Claude Code; точная запись для каждого — в разделах ниже. - Войдите в Tera Ads в браузере. Редактор откроет Tera Ads, где вы входите и выбираете один бизнес, к которому дать доступ.
- Выберите, что ИИ может делать. Выберите «только чтение», «сначала спрашивать меня» или «вносить изменения» для этого подключения; между последними двумя можно переключаться позже в разделе AI connections в Tera Ads.
- Задайте вопрос, который можно проверить. Начните с чего-то вроде «Сколько я вчера потратил на Meta?» и сверьте ответ с Ads Manager, прежде чем полагаться на что-то более серьёзное.

Вход использует OAuth 2.1 с PKCE, а сервер поддерживает динамическую регистрацию клиентов, поэтому редактор регистрируется сам, и вы никогда не имеете дела с идентификатором клиента или секретом. Tera Ads хранит токены только в виде односторонних хешей. Токены доступа живут час и обновляются за вас; подключение живёт 30 дней, после чего нужно войти снова.
Cursor
Cursor читает MCP-серверы из JSON-файла. В его документации сказано, что ~/.cursor/mcp.json в домашней папке делает инструменты доступными везде, а .cursor/mcp.json внутри проекта ограничивает их этим проектом (документация Cursor по MCP). Добавьте эту запись — ту же, что Tera Ads публикует как configs/cursor/mcp.json в своём репозитории на GitHub:
{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}
Если в файле уже перечислены другие серверы, добавьте запись "tera-ads" внутрь существующего объекта mcpServers, а не заменяйте его. Когда Cursor попросит, войдите в Tera Ads в браузере. Добавлять API-ключ или заголовок не нужно.
По умолчанию Cursor запрашивает одобрение перед использованием MCP-инструмента. В его документации описано также добавление инструментов в список разрешённых, чтобы они запускались без вопросов. Если вы так делаете, разрешайте только инструменты чтения, такие как get_insights и get_profit, а инструменты изменения (pause, resume, set_budget, duplicate и инструменты создания) оставьте за запросом подтверждения.
VS Code
В VS Code есть два пути:
- MCP: Add Server. Откройте палитру команд, выполните MCP: Add Server, выберите HTTP, вставьте
https://teraads.co/mcpи дайте серверу идентификаторtera-ads. - Файл рабочей области. Добавьте запись из
configs/vscode/mcp.jsonрепозитория в.vscode/mcp.json:{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code используетserversтам, где Cursor используетmcpServers, поэтому не копируйте файл одного редактора в другой.
Документация VS Code по MCP теперь направляет новые настройки через свой пошаговый процесс и сообщает, что файлы .vscode/mcp.json рабочей области остаются доступными для совместимости, так что подходят оба пути. Запустите сервер, войдите в Tera Ads, когда VS Code спросит, затем включите Tera Ads в Configure Tools во вводе чата. Документация VS Code советует одобрять только понятные вам действия, и это правильная привычка для любого запроса, затрагивающего бюджет.
Claude Code
Одна команда добавляет сервер:
claude mcp add --transport http tera-ads https://teraads.co/mcp
Запустите Claude Code, введите /mcp, выберите tera-ads и войдите в Tera Ads в браузере. В документации Claude Code сказано, что /mcp запускает вход через OAuth и что токены хранятся и обновляются автоматически; claude mcp list показывает, подключён ли каждый сервер или ему нужна аутентификация.
По умолчанию сервер добавляется на локальном уровне: только для вас и только в текущем проекте. Добавьте --scope user, чтобы он был во всех ваших проектах, или --scope project, чтобы записать его в файл .mcp.json, общий через систему контроля версий. Общий файл передаёт только адрес. Каждый входит отдельно, а подключить ИИ к бизнесу в Tera Ads может только владелец бизнеса.
Плагин с шестью навыками
Чтобы добавить сервер вместе с готовыми сценариями, установите Tera Ads как плагин. Выполните claude plugin marketplace add Teralabsx/meta-ads-mcp, затем claude plugin install tera-ads@tera-ads. В документации Claude Code по плагинам сказано, что плагин добавляет свои навыки, агентов, хуки и MCP-серверы и что его навыки выглядят как /<plugin>:<skill>, так что первый из перечисленных ниже — /tera-ads:profit-check.
| Навык | Что делает |
|---|---|
profit-check | Ставит цифры Meta рядом с прибылью вашего магазина после возвратов |
weekly-ads-review | Сравнивает эту неделю с прошлой и предлагает изменения, не внося никаких |
pause-wasted-spend | Находит объявления, тратящие деньги без продаж, и ставит на паузу выбранные вами |
scale-a-winner | Поднимает бюджет победителя безопасными шагами или копирует его как черновик на паузе |
launch-paused-campaign | Собирает целую кампанию, группу объявлений и объявление, всё на паузе, для вашей проверки |
refresh-ad-copy | Пишет новые версии уставшего объявления как объявления на паузе рядом с ним |
В той же документации сказано, что плагины из сторонних маркетплейсов по умолчанию не обновляются автоматически. Чтобы получить новую версию, выполните claude plugin update tera-ads@tera-ads.
Три редактора рядом
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| Куда идёт настройка | ~/.cursor/mcp.json или .cursor/mcp.json | MCP: Add Server или .vscode/mcp.json | claude mcp add на локальном, пользовательском или проектном уровне |
| Формат записи | mcpServers с url | servers с "type": "http" и url | Одна команда, редактировать файл не нужно |
| Вход | Браузер, когда Cursor спросит | Браузер, после запуска сервера | /mcp, затем браузер |
| Перед первым использованием | Больше ничего | Включите в Configure Tools | Больше ничего |
| Дополнительно | Нет | Нет | Плагин с шестью навыками |
| Документация редактора | Cursor | VS Code | Claude Code |
О чём спросить в первую очередь
Начните с вопросов, ответы на которые можно проверить в Ads Manager за минуту. Когда цифры совпадут, переходите к тем, которым нужны данные вашего магазина. Больше примеров в библиотеке запросов для анализа рекламы и в материале вопросы к ИИ о вашей рекламе.
| Спросите | Что ищет ваш ИИ |
|---|---|
| «Какие кампании потратили больше всего на этой неделе и что они принесли?» | get_insights |
| «Какой была моя прибыль после возвратов за последние 30 дней?» | get_profit |
| «Meta говорит, что мой ROAS равен 3. Что на самом деле заработал мой магазин?» | get_insights, get_profit |
| «Какие кампании теряют деньги после возвратов и что с ними делать?» | get_ads_review |
| «Какие объявления потратили деньги за последние 14 дней без продаж?» | get_insights на уровне объявлений |
| «Что изменилось в моей рекламе на этой неделе и можно ли это ещё отменить?» | list_recent_changes |
Две вещи стоит помнить при чтении ответов. Во-первых, покупки и выручка Meta — это атрибуция Meta, а не продажи вашего магазина; разрыв объясняет материал почему Meta Ads и Shopify расходятся. Во-вторых, get_ads_review оценивает каждую кампанию, которая тратила деньги, по прибыли после обычных возвратов вашего магазина, при ваших собственных затратах, относительно вашего безубыточного ROAS. Сама прибыль — оценка для всего магазина, построенная по вашим заказам при вашей настройке маржи, а не деньги на счёте.
Держите изменения рекламы под контролем
Изменения контролируются в двух местах: в вашем редакторе, который может спрашивать перед каждым запуском инструмента, и в Tera Ads, который решает, что подключению вообще разрешено.
- Только чтение, сначала спрашивать или вносить изменения. В режиме «сначала спрашивать» изменение ждёт в Tera Ads, пока вы не одобрите его там, а ваш ИИ не может одобрить его за вас.
- Новое начинается на паузе. Кампании, группы объявлений, объявления и копии ничего не тратят, пока что-то их не включит.
- Шаги бюджета ограничены. Одно изменение может максимум утроить бюджет или сократить его до десятой части.
- Суточный лимит. Ассистенты могут вносить не более 50 изменений в сутки в один бизнес.
- Нет инструмента удаления. Ваш ИИ может поставить на паузу, но ничего не может удалить.
- Отмена в течение 7 дней. Паузу, включение или изменение бюджета можно отменить в Tera Ads в течение 7 дней. Новые кампании, группы объявлений и объявления отменить нельзя, но они начинаются на паузе.
- Один бизнес на подключение. Подключение не может читать другой бизнес, даже если он тоже ваш.

Названия кампаний и текст объявлений попадают к вашему ИИ как данные, и Tera Ads велит ему не следовать инструкциям внутри них. Документация Claude Code тоже делает общее замечание: серверы, получающие внешнее содержимое, могут подвергнуть вас внедрению инструкций, поэтому подключайте только те серверы, которым доверяете. Если хотите видеть каждое изменение до того, как оно произойдёт, выберите «сначала спрашивать».
Если что-то не работает
Сервер сообщает, что нужен вход. В Claude Code выполните /mcp и выберите tera-ads; claude mcp list покажет, что нужна аутентификация, пока вы её не пройдёте. В Cursor и VS Code перезапустите сервер и завершите вход в браузере.
Инструменты не появляются в чате VS Code. Откройте Configure Tools во вводе чата и включите Tera Ads.
Ваш ИИ сообщает, что достигнут лимит. На бесплатном тарифе 30 вызовов в неделю, сброс раз в неделю по UTC. Попросите ИИ выполнить get_usage — он бесплатен и сообщает, сколько вызовов осталось и когда счёт обнулится.
Бюджеты выглядят в сто раз больше. list_campaigns показывает бюджеты в единицах Meta, то есть в сотых долях для большинства валют, так что 5000 означает $50. set_budget принимает целые единицы валюты вашего аккаунта.
Ответы про не тот магазин. Каждое подключение охватывает один бизнес. Подключитесь снова и выберите другой бизнес.
Tera Ads Connect — это MCP-сервер Tera Ads, дашборда прибыли для брендов на Shopify. Он даёт вашему редактору живое чтение Meta, продажи Shopify и прибыль после возвратов, а также ограниченные и журналируемые изменения рекламы. Бесплатный тариф включает 30 вызовов в неделю на одном рекламном аккаунте Meta, а Connect Pro стоит $15 в месяц за 3 000 вызовов в месяц на трёх рекламных аккаунтах; он входит в тарифы Growth и Scale. Шаги настройки для каждого клиента — на странице Connect.
Частые вопросы
Работает ли Meta Ads MCP в Cursor?
Да. Cursor поддерживает удалённые MCP-серверы со входом через OAuth. Добавьте запись Tera Ads в ~/.cursor/mcp.json или .cursor/mcp.json, затем войдите в Tera Ads, когда Cursor попросит.
Как добавить Meta Ads MCP в VS Code?
Выполните MCP: Add Server, выберите HTTP и вставьте https://teraads.co/mcp либо добавьте запись в .vscode/mcp.json. Запустите сервер, войдите, затем включите Tera Ads в Configure Tools в чате.
Какая команда Claude Code подключает Meta Ads MCP?
claude mcp add --transport http tera-ads https://teraads.co/mcp. Затем введите /mcp в Claude Code и войдите. Чтобы получить шесть готовых рекламных навыков, установите плагин командами claude plugin marketplace add Teralabsx/meta-ads-mcp и claude plugin install tera-ads@tera-ads.
Нужен ли API-ключ или приложение разработчика Meta?
Нет. Вы входите в Tera Ads в браузере, а изменения доходят до Meta через собственное одобренное приложение Meta Tera Ads. Ничего секретного в файл конфигурации не попадает.
Может ли ИИ в моём редакторе менять мою рекламу?
Только если вы разрешите это для данного подключения. Даже тогда новое начинается на паузе, одно изменение бюджета может максимум утроить его или сократить до десятой части, а паузу, включение или изменение бюджета можно отменить в Tera Ads в течение 7 дней.
Сколько это стоит?
Бесплатный тариф включает 30 вызовов в неделю на одном рекламном аккаунте Meta. Connect Pro стоит $15 в месяц за 3 000 вызовов в месяц. Вызов — это один запрос вашего ИИ в Tera Ads, и на один вопрос может уйти несколько.