Synter Ads MCP Server
आधिकारिकAI एजेंटों के लिए Google, Meta, LinkedIn, Reddit, TikTok और अन्य प्लेटफार्मों पर क्रॉस-प्लेटफॉर्म विज्ञापन अभियान प्रबंधन। पढ़ने/लिखने की पहुंच के साथ 140+ उपकरण।
दस्तावेज़
Synter MCP सर्वर
MCP एक्सटेंशन जिसे Claude नहीं चाहता कि आप इस्तेमाल करें।
क्योंकि एक बार इंस्टॉल करने के बाद, आपका AI एजेंट असली पैसे खर्च कर सकता है।
अभियान बनाएँ। बजट समायोजित करें। खराब प्रदर्शन करने वालों को रोकें। क्रिएटिव जनरेट करें। प्रदर्शन डेटा खींचें। सब कुछ प्राकृतिक बातचीत के माध्यम से—Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, और अधिक पर।
यह पहला Model Context Protocol (MCP) सर्वर है जो AI एजेंटों को एक क्रेडिट कार्ड देता है।
Synter क्यों?
अधिकांश विज्ञापन MCP सर्वर केवल-पढ़ने और एकल-प्लेटफ़ॉर्म हैं। Synter पूर्ण पढ़ने + लिखने की क्षमताओं वाला एकमात्र क्रॉस-प्लेटफ़ॉर्म विज्ञापन प्रबंधन MCP सर्वर है:
| सुविधा | Synter | Google Ads MCP | Amazon Ads MCP | अन्य |
|---|---|---|---|---|
| प्लेटफ़ॉर्म | 9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD) | केवल Google | केवल Amazon | 1-2 |
| अभियान बनाएँ | ✅ | ❌ केवल-पढ़ने | ✅ केवल Amazon | ❌ |
| बजट समायोजित करें | ✅ | ❌ | ✅ | ❌ |
| अभियान रोकें | ✅ | ❌ | ✅ | ❌ |
| AI क्रिएटिव जनरेशन | ✅ (Imagen 4, Veo, Flux) | ❌ | ❌ | ❌ |
| बोली अनुकूलन | ✅ | ❌ | ❌ | ❌ |
| AI रणनीतिकार | ✅ | ❌ | ❌ | ❌ |
| ओपन सोर्स | ✅ | ✅ | ❌ | भिन्न |
एक MCP सर्वर। हर विज्ञापन प्लेटफ़ॉर्म। पढ़ें और लिखें।
⚠️ निष्पक्ष चेतावनी
आपका AI एजेंट यह करने में सक्षम होगा:
- अभियान बनाएँ जो तुरंत आपका बजट खर्च करना शुरू कर दें
- बोलियाँ समायोजित करें जो प्रभावित करती हैं कि आप प्रति क्लिक कितना भुगतान करते हैं
- अभियान रोकें (कभी-कभी यह एक अच्छी बात है)
- कीवर्ड जोड़ें जो बदलते हैं कि आपके विज्ञापन कौन देखता है
- क्रिएटिव जनरेट करें और उन्हें अपने खातों में अपलोड करें
हमने विनाशकारी कार्यों के लिए पुष्टिकरण बनाए हैं। लेकिन फिर भी—शायद इसे किसी ऐसे एजेंट को न दें जिससे आप अभी-अभी मिले हैं।
त्वरित शुरुआत
1. अपनी API कुंजी प्राप्त करें
syntermedia.ai पर साइन अप करें और डेवलपर सेटिंग्स में एक API कुंजी बनाएँ।
2. अपने AI क्लाइंट को कॉन्फ़िगर करें
Claude Desktop के लिए — ~/Library/Application Support/Claude/claude_desktop_config.json में जोड़ें:
{
"mcpServers": {
"synter": {
"command": "npx",
"args": ["@synterai/mcp-server"],
"env": {
"SYNTER_API_KEY": "syn_your_api_key_here"
}
}
}
}
Cursor के लिए — अपने प्रोजेक्ट में .cursor/mcp.json में जोड़ें:
{
"mcpServers": {
"synter": {
"command": "npx",
"args": ["@synterai/mcp-server"],
"env": {
"SYNTER_API_KEY": "syn_your_api_key_here"
}
}
}
}
Amp के लिए — .amp/settings.json में जोड़ें:
{
"mcpServers": {
"synter": {
"command": "npx",
"args": ["@synterai/mcp-server"],
"env": {
"SYNTER_API_KEY": "syn_your_api_key_here"
}
}
}
}
रिमोट (स्ट्रीमेबल HTTP) — ChatGPT, n8n, Zapier, या किसी भी MCP क्लाइंट के लिए जो HTTP ट्रांसपोर्ट का समर्थन करता है:
URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here
कोई स्थानीय इंस्टॉल आवश्यक नहीं। किसी भी MCP क्लाइंट के साथ काम करता है जो स्ट्रीमेबल HTTP ट्रांसपोर्ट का समर्थन करता है।
3. इसका उपयोग शुरू करें
अपने AI क्लाइंट को पुनरारंभ करें और चैट करना शुरू करें:
"मुझे मेरे सभी Google Ads अभियान दिखाओ"
"'प्रोजेक्ट मैनेजमेंट सॉफ़्टवेयर' के लिए $50/दिन के बजट के साथ एक सर्च अभियान बनाएँ"
"उस अभियान को रोकें जो अधिक खर्च कर रहा है"
एक पूर्ण प्लगइन पसंद करते हैं? (Claude Code / Claude Desktop)
यह पैकेज कच्चा MCP सर्वर है। यदि आप Claude Code या Claude Desktop का उपयोग करते हैं, तो Synter प्लगइन इसी सर्वर को तैयार कौशल (/synter:launch, /synter:audience, /synter:optimize, …), विशेष एजेंटों, और खर्च-से-पहले-अनुमोदन सुरक्षा हुक के साथ लपेटता है:
/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter
यह स्वचालन के लिए एक हेडलेस Claude Agent SDK रनर भी भेजता है। प्लगइन रेपो या Claude प्लगइन गाइड देखें। इस MCP पैकेज का सीधे उपयोग करें जब आप केवल उपकरण चाहते हैं, या किसी अन्य क्लाइंट को वायर कर रहे हैं।
आपका एजेंट क्या कर सकता है?
📊 अभियान प्रबंधन
| उपकरण | विवरण |
|---|---|
list_campaigns | सभी जुड़े प्लेटफ़ॉर्म पर अभियानों की सूची बनाएँ |
create_search_campaign | कीवर्ड और विज्ञापनों के साथ एक Google सर्च अभियान बनाएँ |
create_display_campaign | छवियों के साथ एक Google डिस्प्ले अभियान बनाएँ |
create_pmax_campaign | एक परफॉरमेंस मैक्स अभियान बनाएँ |
create_meta_campaign | एक Facebook/Instagram अभियान बनाएँ |
create_linkedin_campaign | B2B के लिए एक LinkedIn अभियान बनाएँ |
create_reddit_campaign | एक Reddit अभियान बनाएँ |
pause_campaign | किसी भी अभियान को रोकें |
update_campaign_budget | दैनिक बजट बदलें |
📈 प्रदर्शन और विश्लेषण
| उपकरण | विवरण |
|---|---|
get_performance | इंप्रेशन, क्लिक, खर्च, रूपांतरण, ROAS प्राप्त करें |
get_daily_spend | प्लेटफ़ॉर्म द्वारा दैनिक खर्च विवरण |
🎯 कीवर्ड और लक्ष्यीकरण
| उपकरण | विवरण |
|---|---|
add_keywords | किसी अभियान या विज्ञापन समूह में कीवर्ड जोड़ें |
add_negative_keywords | अवांछित खोज शब्दों को ब्लॉक करें |
🔄 रूपांतरण ट्रैकिंग
| उपकरण | विवरण |
|---|---|
create_conversion | एक रूपांतरण कार्रवाई सेट करें |
list_conversions | मौजूदा रूपांतरण कार्रवाइयों की सूची बनाएँ |
diagnose_tracking | जाँचें कि ट्रैकिंग सही ढंग से स्थापित है या नहीं |
🎨 क्रिएटिव जनरेशन
| उपकरण | विवरण |
|---|---|
generate_image | AI-जनरेट विज्ञापन छवियाँ (Imagen 4, Flux, SDXL) |
generate_video | AI-जनरेट वीडियो विज्ञापन (Veo, Runway, Luma) |
upload_image | विज्ञापन संपत्तियों के रूप में छवियाँ अपलोड करें |
🔧 उपयोगिता
| उपकरण | विवरण |
|---|---|
list_ad_accounts | सभी जुड़े विज्ञापन खातों की सूची बनाएँ |
run_tool | 140+ Synter उपकरणों में से कोई भी सीधे चलाएँ |
कोई विज्ञापन अनुभव नहीं? कोई समस्या नहीं।
यदि आपने पहले कभी विज्ञापन नहीं चलाए हैं, तो यहाँ आपको जानना आवश्यक है:
अभियान क्या है?
एक अभियान एक प्रोजेक्ट फ़ोल्डर की तरह है। इसमें आपके विज्ञापन, उन्हें कौन देखता है, और आप कितना खर्च करते हैं, शामिल हैं।
Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images
मैं कौन से प्लेटफ़ॉर्म उपयोग कर सकता हूँ?
| प्लेटफ़ॉर्म | सर्वोत्तम के लिए | न्यूनतम बजट |
|---|---|---|
| Google Ads | आपके उत्पाद के लिए सक्रिय रूप से खोज करने वाले लोग | $10/दिन |
| Meta (Facebook/Instagram) | दृश्य उत्पाद, व्यापक दर्शक | $5/दिन |
| B2B, उद्यम, नौकरी चाहने वाले | $25/दिन | |
| विशिष्ट समुदाय, तकनीक-प्रेमी उपयोगकर्ता | $5/दिन | |
| Microsoft (Bing) | पुरानी जनसांख्यिकी, B2B | $10/दिन |
| TikTok | जेन Z, मनोरंजन, ई-कॉमर्स | $20/दिन |
अभियान प्रकार समझाए गए
सर्च अभियान — आपका विज्ञापन तब दिखता है जब कोई विशिष्ट कीवर्ड गूगल करता है।
- उदाहरण: कोई "सर्वश्रेष्ठ CRM सॉफ़्टवेयर" खोजता है → आपका विज्ञापन दिखाई देता है
डिस्प्ले अभियान — वेबसाइटों और ऐप्स पर दिखाए जाने वाले छवि विज्ञापन।
- उदाहरण: एक समाचार साइट पर बैनर विज्ञापन
परफॉरमेंस मैक्स (PMax) — Google का AI आपके विज्ञापन हर जगह दिखाता है (सर्च, YouTube, डिस्प्ले, Gmail, मैप्स)।
- उदाहरण: Google आपके लिए सर्वोत्तम प्लेसमेंट का पता लगाता है
वीडियो अभियान — YouTube और भागीदार साइटों पर वीडियो विज्ञापन।
- उदाहरण: YouTube वीडियो से पहले 15-सेकंड का विज्ञापन
सामान्य शब्द
| शब्द | इसका क्या अर्थ है |
|---|---|
| इंप्रेशन | आपका विज्ञापन कितनी बार दिखाया गया |
| क्लिक | कितने लोगों ने आपके विज्ञापन पर क्लिक किया |
| CTR | क्लिक-थ्रू दर (क्लिक ÷ इंप्रेशन × 100) |
| CPC | प्रति क्लिक लागत |
| रूपांतरण | वांछित कार्रवाइयाँ (साइनअप, खरीदारी, आदि) |
| ROAS | विज्ञापन खर्च पर रिटर्न (राजस्व ÷ खर्च) |
पहला अभियान चेकलिस्ट
अपना पहला अभियान बनाने से पहले, आपको आवश्यकता होगी:
- ✅ एक लैंडिंग पेज URL जहाँ लोग क्लिक करने पर जाएंगे
- ✅ एक विचार कि आप किस तक पहुँचना चाहते हैं (स्थान, रुचियाँ)
- ✅ एक दैनिक बजट जिसके साथ आप सहज हैं (शुरू करने के लिए $10-50)
- ✅ आपके विज्ञापन के लिए कुछ शीर्षक और विवरण
प्रो टिप: Google पर एक सर्च अभियान से शुरू करें। इसे समझना सबसे आसान है और यह पहले से ही आपकी पेशकश की तलाश कर रहे लोगों को विज्ञापन दिखाता है।
उदाहरण वार्तालाप
अपना पहला अभियान बनाएँ
आप: मेरे SaaS उत्पाद के लिए एक Google सर्च अभियान बनाएँ। "टीम सहयोग सॉफ़्टवेयर" और "प्रोजेक्ट मैनेजमेंट टूल" खोजने वाले लोगों को लक्षित करें। बजट $25/दिन है। लैंडिंग पेज https://myapp.com/signup है
एजेंट: मैं उन कीवर्ड के साथ एक सर्च अभियान बनाऊंगा। मुझे कौन से शीर्षक उपयोग करने चाहिए? यहाँ कुछ सुझाव हैं:
- "टीम सहयोग सरल बनाया गया"
- "आधुनिक टीमों के लिए प्रोजेक्ट मैनेजमेंट"
- "मुफ़्त शुरू करें - कोई क्रेडिट कार्ड नहीं"
प्रदर्शन जाँचें
आप: इस सप्ताह मेरे अभियान कैसे कर रहे हैं?
एजेंट: पिछले 7 दिनों का आपका प्रदर्शन यहाँ है:
अभियान खर्च क्लिक रूपांतरण ROAS ब्रांड सर्च $142 89 12 4.2x प्रतियोगी कीवर्ड $98 45 3 1.5x डिस्प्ले रीटार्गेटिंग $67 234 8 2.8x "प्रतियोगी कीवर्ड" अभियान खराब प्रदर्शन कर रहा है। क्या आप चाहते हैं कि मैं इसे रोक दूं या लक्ष्यीकरण समायोजित करूं?
नकारात्मक कीवर्ड जोड़ें
आप: मुझे "मुफ़्त प्रोजेक्ट मैनेजमेंट" के लिए क्लिक मिल रहे हैं लेकिन हमारे पास मुफ़्त स्तर नहीं है। उन्हें ब्लॉक करें।
एजेंट: आपके अभियान में "मुफ़्त" को एक नकारात्मक कीवर्ड के रूप में जोड़ा गया। यह आपके विज्ञापनों को "मुफ़्त" वाली किसी भी खोज के लिए दिखने से रोक देगा।
विज्ञापन क्रिएटिव जनरेट करें
आप: मुझे एक मार्केटिंग ऑटोमेशन उत्पाद के लिए एक डिस्प्ले विज्ञापन छवि चाहिए। डार्क थीम, पेशेवर, 1200x628।
एजेंट: Imagen 4 के साथ आपकी छवि जनरेट कर रहा हूँ...
बनाया गया: "डार्क बैकग्राउंड पर डेटा विज़ुअलाइज़ेशन के साथ मार्केटिंग ऑटोमेशन डैशबोर्ड" संपत्ति सहेजी गई और आपके अगले डिस्प्ले अभियान में उपयोग के लिए तैयार है।
अपने विज्ञापन खाते कनेक्ट करें
प्रत्येक प्लेटफ़ॉर्म पर विज्ञापन प्रबंधित करने के लिए, आपको Synter में अपने खाते कनेक्ट करने होंगे:
- syntermedia.ai/settings/credentials पर जाएँ
- प्रत्येक प्लेटफ़ॉर्म के बगल में "कनेक्ट" पर क्लिक करें
- OAuth प्रवाह पूरा करें
- आपका एजेंट अब उस प्लेटफ़ॉर्म का प्रबंधन कर सकता है
समर्थित प्लेटफ़ॉर्म:
- Google Ads ✅
- Meta (Facebook/Instagram) ✅
- LinkedIn Ads ✅
- Microsoft Ads (Bing) ✅
- Reddit Ads ✅
- TikTok Ads ✅
- X (Twitter) Ads ✅
- StackAdapt ✅
- The Trade Desk ✅
उन्नत: प्रत्यक्ष उपकरण पहुँच
पावर उपयोगकर्ताओं के लिए, आप 140+ Synter उपकरणों में से किसी को भी सीधे कॉल कर सकते हैं:
> Use run_tool to call google_ads_list_audiences
docs.syntermedia.ai/tools पर पूर्ण उपकरण सूची देखें या अपने एजेंट से पूछें:
> What tools are available for LinkedIn Ads?
पर्यावरण चर
| चर | आवश्यक | विवरण |
|---|---|---|
SYNTER_API_KEY | हाँ | आपकी Synter API कुंजी |
SYNTER_API_URL | नहीं | API URL ओवरराइड (डिफ़ॉल्ट: https://syntermedia.ai) |
स्थानीय विकास
# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install
# Build
npm run build
# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js
समस्या निवारण
"SYNTER_API_KEY सेट नहीं है"
सुनिश्चित करें कि आपकी API कुंजी आपके MCP कॉन्फ़िग के env अनुभाग में है। कुंजी syn_ से शुरू होनी चाहिए।
"अमान्य या समाप्त API कुंजी"
- जाँचें कि आपने पूरी कुंजी कॉपी की है (वे लंबी होती हैं!)
- syntermedia.ai/developer पर सत्यापित करें कि कुंजी सक्रिय है
- सुनिश्चित करें कि कुंजी में
tools:writeस्कोप है
"कोई विज्ञापन खाता कनेक्ट नहीं है"
आपको कम से कम एक विज्ञापन प्लेटफ़ॉर्म कनेक्ट करना होगा:
- syntermedia.ai/settings/credentials पर जाएँ
- Google Ads (या किसी अन्य प्लेटफ़ॉर्म) के बगल में "कनेक्ट" पर क्लिक करें
- OAuth प्राधिकरण पूरा करें
उपकरण Claude/Cursor में नहीं दिख रहे हैं
- अपने AI क्लाइंट को पूरी तरह से पुनरारंभ करें (केवल रिफ्रेश नहीं)
- त्रुटियों के लिए MCP सर्वर लॉग जाँचें
- कॉन्फ़िग फ़ाइल पथ और JSON सिंटैक्स सत्यापित करें
संसाधन
- Synter मैनुअल: syntermedia.ai/manual
- API दस्तावेज़ीकरण: docs.syntermedia.ai
- Claude प्लगइन: github.com/Synter-Media-AI/plugin — Claude Code / Desktop के लिए कौशल, एजेंट और यह MCP
- उपकरण संदर्भ: docs.syntermedia.ai/tools
- MCP सर्वर तुलना: syntermedia.ai/blog/best-ad-platform-mcp-servers
- मुफ़्त एजेंट कौशल (47 ओपन-सोर्स): github.com/Synter-Media-AI/free-skills — skills.sh पर भी
- समर्थन: [email protected]
लाइसेंस
MIT लाइसेंस - विवरण के लिए LICENSE देखें।
MCP एक्सटेंशन जिसे वे नहीं चाहते कि आप उपयोग करें।
क्योंकि विज्ञापन बजट वाले AI एजेंट सब कुछ बदल देते हैं।