Synter Ads MCP Server

आधिकारिक

AI एजेंटों के लिए Google, Meta, LinkedIn, Reddit, TikTok और अन्य प्लेटफार्मों पर क्रॉस-प्लेटफॉर्म विज्ञापन अभियान प्रबंधन। पढ़ने/लिखने की पहुंच के साथ 140+ उपकरण।

दस्तावेज़

Synter MCP सर्वर

npm version License: MIT

MCP एक्सटेंशन जिसे Claude नहीं चाहता कि आप इस्तेमाल करें।

क्योंकि एक बार इंस्टॉल करने के बाद, आपका AI एजेंट असली पैसे खर्च कर सकता है।

अभियान बनाएँ। बजट समायोजित करें। खराब प्रदर्शन करने वालों को रोकें। क्रिएटिव जनरेट करें। प्रदर्शन डेटा खींचें। सब कुछ प्राकृतिक बातचीत के माध्यम से—Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, और अधिक पर।

यह पहला Model Context Protocol (MCP) सर्वर है जो AI एजेंटों को एक क्रेडिट कार्ड देता है।


Synter क्यों?

अधिकांश विज्ञापन MCP सर्वर केवल-पढ़ने और एकल-प्लेटफ़ॉर्म हैं। Synter पूर्ण पढ़ने + लिखने की क्षमताओं वाला एकमात्र क्रॉस-प्लेटफ़ॉर्म विज्ञापन प्रबंधन MCP सर्वर है:

सुविधाSynterGoogle Ads MCPAmazon Ads MCPअन्य
प्लेटफ़ॉर्म9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)केवल Googleकेवल Amazon1-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_campaignB2B के लिए एक 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_imageAI-जनरेट विज्ञापन छवियाँ (Imagen 4, Flux, SDXL)
generate_videoAI-जनरेट वीडियो विज्ञापन (Veo, Runway, Luma)
upload_imageविज्ञापन संपत्तियों के रूप में छवियाँ अपलोड करें

🔧 उपयोगिता

उपकरणविवरण
list_ad_accountsसभी जुड़े विज्ञापन खातों की सूची बनाएँ
run_tool140+ 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/दिन
LinkedInB2B, उद्यम, नौकरी चाहने वाले$25/दिन
Redditविशिष्ट समुदाय, तकनीक-प्रेमी उपयोगकर्ता$5/दिन
Microsoft (Bing)पुरानी जनसांख्यिकी, B2B$10/दिन
TikTokजेन Z, मनोरंजन, ई-कॉमर्स$20/दिन

अभियान प्रकार समझाए गए

सर्च अभियान — आपका विज्ञापन तब दिखता है जब कोई विशिष्ट कीवर्ड गूगल करता है।

  • उदाहरण: कोई "सर्वश्रेष्ठ CRM सॉफ़्टवेयर" खोजता है → आपका विज्ञापन दिखाई देता है

डिस्प्ले अभियान — वेबसाइटों और ऐप्स पर दिखाए जाने वाले छवि विज्ञापन।

  • उदाहरण: एक समाचार साइट पर बैनर विज्ञापन

परफॉरमेंस मैक्स (PMax) — Google का AI आपके विज्ञापन हर जगह दिखाता है (सर्च, YouTube, डिस्प्ले, Gmail, मैप्स)।

  • उदाहरण: Google आपके लिए सर्वोत्तम प्लेसमेंट का पता लगाता है

वीडियो अभियान — YouTube और भागीदार साइटों पर वीडियो विज्ञापन।

  • उदाहरण: YouTube वीडियो से पहले 15-सेकंड का विज्ञापन

सामान्य शब्द

शब्दइसका क्या अर्थ है
इंप्रेशनआपका विज्ञापन कितनी बार दिखाया गया
क्लिककितने लोगों ने आपके विज्ञापन पर क्लिक किया
CTRक्लिक-थ्रू दर (क्लिक ÷ इंप्रेशन × 100)
CPCप्रति क्लिक लागत
रूपांतरणवांछित कार्रवाइयाँ (साइनअप, खरीदारी, आदि)
ROASविज्ञापन खर्च पर रिटर्न (राजस्व ÷ खर्च)

पहला अभियान चेकलिस्ट

अपना पहला अभियान बनाने से पहले, आपको आवश्यकता होगी:

  1. ✅ एक लैंडिंग पेज URL जहाँ लोग क्लिक करने पर जाएंगे
  2. ✅ एक विचार कि आप किस तक पहुँचना चाहते हैं (स्थान, रुचियाँ)
  3. ✅ एक दैनिक बजट जिसके साथ आप सहज हैं (शुरू करने के लिए $10-50)
  4. ✅ आपके विज्ञापन के लिए कुछ शीर्षक और विवरण

प्रो टिप: Google पर एक सर्च अभियान से शुरू करें। इसे समझना सबसे आसान है और यह पहले से ही आपकी पेशकश की तलाश कर रहे लोगों को विज्ञापन दिखाता है।


उदाहरण वार्तालाप

अपना पहला अभियान बनाएँ

आप: मेरे SaaS उत्पाद के लिए एक Google सर्च अभियान बनाएँ। "टीम सहयोग सॉफ़्टवेयर" और "प्रोजेक्ट मैनेजमेंट टूल" खोजने वाले लोगों को लक्षित करें। बजट $25/दिन है। लैंडिंग पेज https://myapp.com/signup है

एजेंट: मैं उन कीवर्ड के साथ एक सर्च अभियान बनाऊंगा। मुझे कौन से शीर्षक उपयोग करने चाहिए? यहाँ कुछ सुझाव हैं:

  • "टीम सहयोग सरल बनाया गया"
  • "आधुनिक टीमों के लिए प्रोजेक्ट मैनेजमेंट"
  • "मुफ़्त शुरू करें - कोई क्रेडिट कार्ड नहीं"

प्रदर्शन जाँचें

आप: इस सप्ताह मेरे अभियान कैसे कर रहे हैं?

एजेंट: पिछले 7 दिनों का आपका प्रदर्शन यहाँ है:

अभियानखर्चक्लिकरूपांतरणROAS
ब्रांड सर्च$14289124.2x
प्रतियोगी कीवर्ड$984531.5x
डिस्प्ले रीटार्गेटिंग$6723482.8x

"प्रतियोगी कीवर्ड" अभियान खराब प्रदर्शन कर रहा है। क्या आप चाहते हैं कि मैं इसे रोक दूं या लक्ष्यीकरण समायोजित करूं?

नकारात्मक कीवर्ड जोड़ें

आप: मुझे "मुफ़्त प्रोजेक्ट मैनेजमेंट" के लिए क्लिक मिल रहे हैं लेकिन हमारे पास मुफ़्त स्तर नहीं है। उन्हें ब्लॉक करें।

एजेंट: आपके अभियान में "मुफ़्त" को एक नकारात्मक कीवर्ड के रूप में जोड़ा गया। यह आपके विज्ञापनों को "मुफ़्त" वाली किसी भी खोज के लिए दिखने से रोक देगा।

विज्ञापन क्रिएटिव जनरेट करें

आप: मुझे एक मार्केटिंग ऑटोमेशन उत्पाद के लिए एक डिस्प्ले विज्ञापन छवि चाहिए। डार्क थीम, पेशेवर, 1200x628।

एजेंट: Imagen 4 के साथ आपकी छवि जनरेट कर रहा हूँ...

बनाया गया: "डार्क बैकग्राउंड पर डेटा विज़ुअलाइज़ेशन के साथ मार्केटिंग ऑटोमेशन डैशबोर्ड" संपत्ति सहेजी गई और आपके अगले डिस्प्ले अभियान में उपयोग के लिए तैयार है।


अपने विज्ञापन खाते कनेक्ट करें

प्रत्येक प्लेटफ़ॉर्म पर विज्ञापन प्रबंधित करने के लिए, आपको Synter में अपने खाते कनेक्ट करने होंगे:

  1. syntermedia.ai/settings/credentials पर जाएँ
  2. प्रत्येक प्लेटफ़ॉर्म के बगल में "कनेक्ट" पर क्लिक करें
  3. OAuth प्रवाह पूरा करें
  4. आपका एजेंट अब उस प्लेटफ़ॉर्म का प्रबंधन कर सकता है

समर्थित प्लेटफ़ॉर्म:

  • 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 कुंजी"

  1. जाँचें कि आपने पूरी कुंजी कॉपी की है (वे लंबी होती हैं!)
  2. syntermedia.ai/developer पर सत्यापित करें कि कुंजी सक्रिय है
  3. सुनिश्चित करें कि कुंजी में tools:write स्कोप है

"कोई विज्ञापन खाता कनेक्ट नहीं है"

आपको कम से कम एक विज्ञापन प्लेटफ़ॉर्म कनेक्ट करना होगा:

  1. syntermedia.ai/settings/credentials पर जाएँ
  2. Google Ads (या किसी अन्य प्लेटफ़ॉर्म) के बगल में "कनेक्ट" पर क्लिक करें
  3. OAuth प्राधिकरण पूरा करें

उपकरण Claude/Cursor में नहीं दिख रहे हैं

  1. अपने AI क्लाइंट को पूरी तरह से पुनरारंभ करें (केवल रिफ्रेश नहीं)
  2. त्रुटियों के लिए MCP सर्वर लॉग जाँचें
  3. कॉन्फ़िग फ़ाइल पथ और JSON सिंटैक्स सत्यापित करें

संसाधन


लाइसेंस

MIT लाइसेंस - विवरण के लिए LICENSE देखें।


Synter
MCP एक्सटेंशन जिसे वे नहीं चाहते कि आप उपयोग करें।
क्योंकि विज्ञापन बजट वाले AI एजेंट सब कुछ बदल देते हैं।