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 след връщанията. За всяка връзка избирате дали вашият AI само чете, пита ви първо или прави промени.
Накратко
- Един адрес работи и в трите редактора:
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или плъгин, който добавя сървъра плюс шест готови умения за реклами. - Вашият AI получава 29 инструмента: четене на живо от Meta, печалба на магазина след връщанията и паузи, включвания и промени на бюджет в рамките на фиксирани лимити.
- Решете какво може да прави AI, преди да свържете: само четене, първо питай или правене на промени.
Защо да свържете Meta Ads с редактора си за код
Ако сами правите темата, скриптовете или вътрешните си инструменти за Shopify, редакторът ви вече е мястото, където прекарвате деня. AI агент там може да отговори на въпрос за реклами без обиколка до Ads Manager, да запише отговора във файл в хранилището ви или да провери дали целевата страница, която току-що променихте, е същата, към която водят най-добрите ви реклами.
MCP (Model Context Protocol) е отвореният стандарт, който прави това възможно: агентът на редактора вика инструменти, които сървърът предлага, а сървърът говори с рекламната платформа. MCP конекторите, обяснени показва как работи. Документацията на Cursor посочва stdio, SSE и Streamable HTTP като поддържани транспорти и казва, че поддържа OAuth за сървъри, които го изискват (MCP документация на Cursor). Claude Code влиза в отдалечени сървъри с OAuth през командата си /mcp (MCP документация на Claude Code). Така хостван сървър не изисква ключове, поставени в конфигурационен файл.
Tera Ads Connect е сървър от този вид, направен за марки в Shopify. Освен четене на живо от Meta, отговаря от вашия магазин: поръчки, връщания, себестойност, доставка, такси и възстановявания, минус разходите ви за Meta и Google реклами. Приписаните от Meta приходи са означени като на Meta, така че вашият AI да не ги бърка с продажби. Ако искате по-широка картина на сървърите, които можете да ползвате вместо това, опциите за Meta Ads MCP ги сравнява.
Преди да започнете
- Безплатен акаунт в Tera Ads. Регистрирайте се и свържете рекламния си акаунт в Meta. Свържете и Shopify, за да вижда вашият AI продажбите и печалбата на магазина.
- Достъп на собственик. Само собственикът на бизнеса може да свърже AI с бизнес в Tera Ads.
- Вашият редактор. Cursor, VS Code с чат изгледа си или Claude Code в терминала.
- Решение за промените. Решете дали AI само ще отчита, или и ще спира реклами и ще променя бюджети. Ръководството за безопасен AI достъп има кратка политика, която можете да копирате.
Настройка в пет стъпки
- Създайте безплатен акаунт в Tera Ads. Регистрирайте се, свържете рекламния си акаунт в Meta, после свържете Shopify, за да включват отговорите печалбата на магазина след връщанията.
- Добавете адреса на сървъра в редактора си. Поставете
https://teraads.co/mcpв MCP настройките на Cursor или VS Code или изпълнете една команда в Claude Code; разделите по-долу дават точния запис за всеки. - Влезте в Tera Ads през браузъра. Редакторът отваря Tera Ads, където влизате и избирате единствения бизнес за споделяне.
- Изберете какво може да прави вашият AI. Изберете само четене, първо ме питай или правене на промени за тази връзка; между последните две можете да превключвате по-късно под AI connections в Tera Ads.
- Задайте въпрос, който можете да проверите. Започнете с нещо като „Колко похарчих в Meta вчера?" и сравнете отговора с Ads Manager, преди да разчитате на нещо по-голямо.

Входът използва OAuth 2.1 с PKCE, а сървърът поддържа динамична регистрация на клиент, така че редакторът ви се регистрира сам и никога не работите с client ID или secret. Tera Ads съхранява токените само като еднопосочни хешове. Токените за достъп траят един час и се подновяват вместо вас; връзката трае 30 дни, преди да влезете отново.
Cursor
Cursor чете MCP сървърите от JSON файл. Документацията му казва, че ~/.cursor/mcp.json в домашната ви папка прави инструментите достъпни навсякъде, а .cursor/mcp.json в проект ги ограничава до този проект (MCP документация на Cursor). Добавете този запис, същият, който 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. Отворете Command Palette, изпълнете MCP: Add Server, изберете HTTP, поставете
https://teraads.co/mcpи дайте на сървъра IDtera-ads. - Файл на работното пространство. Добавете записа от
configs/vscode/mcp.jsonна хранилището в.vscode/mcp.json:{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code използваservers, където Cursor използваmcpServers, така че не копирайте файла на единия редактор в другия.
MCP документацията на VS Code вече насочва новите настройки през водения си процес и казва, че файловете .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, споделен през системата за версии. Споделеният файл споделя само адреса. Всеки влиза поотделно и само собственикът на бизнеса може да свърже AI с бизнес в Tera Ads.
Плъгинът, с шест умения
За да добавите сървъра заедно с готови работни процеси, инсталирайте Tera Ads като плъгин. Изпълнете claude plugin marketplace add Teralabsx/meta-ads-mcp, после claude plugin install tera-ads@tera-ads. Документацията за плъгини на Claude Code казва, че плъгинът добавя своите умения, агенти, hooks и 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 за минута. Щом числата съвпаднат, преминете към тези, които изискват данните на магазина ви. Библиотеката с подсказки за анализ на реклами и въпросите към AI за вашите реклами имат още.
| Питайте | Какво търси вашият AI |
|---|---|
| „Кои кампании похарчиха най-много тази седмица и какво донесоха?" | 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 преценява всяка кампания, която е харчила, по печалбата след обичайните връщания на магазина ви, при вашите собствени разходи, спрямо вашия break-even ROAS. Самата печалба е оценка за целия магазин, изградена от поръчките ви при вашата настройка за марж, не пари в банката.
Дръжте промените в рекламите под контрол
Промените се контролират на две места: редактора ви, който може да пита преди всеки инструмент, и Tera Ads, който решава какво изобщо може да прави връзката.
- Само четене, първо питай или правене на промени. При първо питай промяната чака в Tera Ads, докато я одобрите там, и вашият AI не може да я одобри вместо вас.
- Новото започва на пауза. Кампании, рекламни набори, реклами и копия не харчат нищо, докато нещо не ги включи.
- Стъпките на бюджета са ограничени. Една промяна може най-много да утрои бюджета или да го намали до една десета.
- Дневен лимит. Асистентите могат да правят най-много 50 промени на ден за един бизнес.
- Няма инструмент за изтриване. Вашият AI може да паузира, но не може да изтрива нищо.
- Отмяна за 7 дни. Пауза, включване или промяна на бюджет може да се отмени в Tera Ads в рамките на 7 дни. Нови кампании, рекламни набори и реклами не могат да се отменят, но започват на пауза.
- Един бизнес на връзка. Връзката не може да чете друг бизнес, дори такъв, който също притежавате.

Имената на кампании и текстът на реклами стигат до вашия AI като данни, а Tera Ads му казва да не следва инструкции в тях. Документацията на Claude Code също прави общото уточнение: сървъри, които извличат външно съдържание, могат да ви изложат на prompt injection, така че свързвайте само сървъри, на които вярвате. Ако искате да виждате всяка промяна, преди да се случи, изберете първо питай.
Когато нещо не работи
Сървърът казва, че се нуждае от вход. В Claude Code изпълнете /mcp и изберете tera-ads; claude mcp list показва, че се нуждае от удостоверяване, докато не го направите. В Cursor и VS Code рестартирайте сървъра и завършете входа през браузъра.
Инструментите не се появяват в чата на VS Code. Отворете Configure Tools в полето за чат и включете Tera Ads.
Вашият AI казва, че е достигнат лимит. Безплатният план има 30 извиквания седмично, нулирани седмично в UTC. Помолете AI да изпълни get_usage, което е безплатно и казва колко извиквания са останали и кога се нулира броячът.
Бюджетите изглеждат сто пъти по-големи. list_campaigns показва бюджетите в единиците на Meta, които са стотни за повечето валути, така че 5000 означава $50. set_budget приема цели единици от валутата на акаунта ви.
Отговорите са за грешния магазин. Всяка връзка покрива един бизнес. Свържете отново и изберете другия бизнес.
Tera Ads Connect е MCP сървърът на Tera Ads, таблото за печалба за марки в Shopify. Дава на редактора ви четене на живо от Meta, продажби от Shopify и печалба след връщанията, и ограничени, записвани промени на реклами. Безплатният план включва 30 извиквания седмично за един рекламен акаунт в Meta, а Connect Pro струва $15 месечно за 3000 извиквания месечно за до три рекламни акаунта; включен е в плановете 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 през собственото одобрено приложение на Tera Ads в Meta. Нищо тайно не влиза във вашия конфигурационен файл.
Може ли AI в редактора ми да променя рекламите ми?
Само ако го позволите за тази връзка. Дори тогава новото започва на пауза, една промяна на бюджета може най-много да го утрои или да го намали до една десета, а пауза, включване или промяна на бюджет може да се отмени в Tera Ads в рамките на 7 дни.
Колко струва?
Безплатният план включва 30 извиквания седмично за един рекламен акаунт в Meta. Connect Pro е $15 месечно за 3000 извиквания месечно. Извикването е едно търсене, което вашият AI прави в Tera Ads, а един въпрос може да изисква няколко.