Synter Ads MCP Server

offiziell

Plattformübergreifendes Anzeigenkampagnen-Management für KI-Agenten auf Google, Meta, LinkedIn, Reddit, TikTok und mehr. 140+ Tools mit Lese-/Schreibzugriff.

Dokumentation

Synter MCP Server

npm version License: MIT

Die MCP-Erweiterung, von der Claude nicht will, dass du sie nutzt.

Denn sobald du sie installierst, kann dein KI-Agent echtes Geld ausgeben.

Erstelle Kampagnen. Passe Budgets an. Pausiere leistungsschwache Kampagnen. Generiere Werbemittel. Rufe Leistungsdaten ab. Alles durch natürliche Konversation – über Google, Meta, LinkedIn, Microsoft, Reddit, TikTok und mehr.

Dies ist der erste Model Context Protocol (MCP) Server, der KI-Agenten eine Kreditkarte gibt.


Warum Synter?

Die meisten Werbe-MCP-Server sind schreibgeschützt und plattformgebunden. Synter ist der einzige plattformübergreifende Anzeigenverwaltungs-MCP-Server mit vollständigen Lese- und Schreibfähigkeiten:

FunktionSynterGoogle Ads MCPAmazon Ads MCPAndere
Plattformen9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)Nur GoogleNur Amazon1-2
Kampagnen erstellen❌ Schreibgeschützt✅ Nur Amazon
Budgets anpassen
Kampagnen pausieren
KI-Werbemittelerstellung✅ (Imagen 4, Veo, Flux)
Gebotsoptimierung
KI-Stratege
Open SourceUnterschiedlich

Ein MCP-Server. Jede Werbeplattform. Lesen und schreiben.


⚠️ Faire Warnung

Ihr KI-Agent wird in der Lage sein:

  • Kampagnen zu erstellen, die sofort Ihr Budget ausgeben
  • Gebote anzupassen, die beeinflussen, wie viel Sie pro Klick zahlen
  • Kampagnen zu pausieren (manchmal ist das eine gute Sache)
  • Keywords hinzuzufügen, die ändern, wer Ihre Anzeigen sieht
  • Werbemittel zu generieren und auf Ihre Konten hochzuladen

Wir haben Bestätigungen für destruktive Aktionen eingebaut. Aber trotzdem – geben Sie dies vielleicht nicht einem Agenten, den Sie gerade erst kennengelernt haben.


Schnellstart

1. API-Schlüssel erhalten

Registrieren Sie sich auf syntermedia.ai und erstellen Sie einen API-Schlüssel in den Entwicklereinstellungen.

2. KI-Client konfigurieren

Für Claude Desktop – Zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzufügen:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Für Cursor – Zu .cursor/mcp.json in Ihrem Projekt hinzufügen:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Für Amp – Zu .amp/settings.json hinzufügen:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Remote (Streamable HTTP) – Für ChatGPT, n8n, Zapier oder jeden MCP-Client, der HTTP-Transport unterstützt:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

Keine lokale Installation erforderlich. Funktioniert mit jedem MCP-Client, der Streamable HTTP-Transport unterstützt.

3. Nutzung starten

Starten Sie Ihren KI-Client neu und beginnen Sie zu chatten:

"Zeig mir alle meine Google Ads Kampagnen"

"Erstelle eine Suchkampagne für 'Projektmanagement-Software' mit einem Budget von 50 $/Tag"

"Pausiere die Kampagne, die zu viel ausgibt"


Bevorzugen Sie ein vollständiges Plugin? (Claude Code / Claude Desktop)

Dieses Paket ist der reine MCP-Server. Wenn Sie Claude Code oder Claude Desktop verwenden, umschließt das Synter-Plugin denselben Server mit vorgefertigten Skills (/synter:launch, /synter:audience, /synter:optimize, …), spezialisierten Agenten und einem Genehmigungs-vor-Ausgabe-Sicherheits-Hook:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

Es enthält auch einen headless Claude Agent SDK-Runner für Automatisierung. Siehe das Plugin-Repo oder den Claude-Plugin-Leitfaden. Verwenden Sie dieses MCP-Paket direkt, wenn Sie nur die Tools benötigen oder einen anderen Client anbinden.


Was kann Ihr Agent tun?

📊 Kampagnenverwaltung

ToolBeschreibung
list_campaignsKampagnen über alle verbundenen Plattformen auflisten
create_search_campaignEine Google-Suchkampagne mit Keywords und Anzeigen erstellen
create_display_campaignEine Google-Display-Kampagne mit Bildern erstellen
create_pmax_campaignEine Performance-Max-Kampagne erstellen
create_meta_campaignEine Facebook/Instagram-Kampagne erstellen
create_linkedin_campaignEine LinkedIn-Kampagne für B2B erstellen
create_reddit_campaignEine Reddit-Kampagne erstellen
pause_campaignJede Kampagne pausieren
update_campaign_budgetTagesbudget ändern

📈 Leistung & Analyse

ToolBeschreibung
get_performanceImpressionen, Klicks, Ausgaben, Conversions, ROAS abrufen
get_daily_spendTägliche Ausgabenaufschlüsselung nach Plattform

🎯 Keywords & Targeting

ToolBeschreibung
add_keywordsKeywords zu einer Kampagne oder Anzeigengruppe hinzufügen
add_negative_keywordsUnerwünschte Suchbegriffe blockieren

🔄 Conversion-Tracking

ToolBeschreibung
create_conversionEine Conversion-Aktion einrichten
list_conversionsBestehende Conversion-Aktionen auflisten
diagnose_trackingPrüfen, ob das Tracking korrekt installiert ist

🎨 Werbemittelerstellung

ToolBeschreibung
generate_imageKI-generierte Anzeigenbilder (Imagen 4, Flux, SDXL)
generate_videoKI-generierte Videoanzeigen (Veo, Runway, Luma)
upload_imageBilder als Anzeigen-Assets hochladen

🔧 Dienstprogramme

ToolBeschreibung
list_ad_accountsAlle verbundenen Werbekonten auflisten
run_toolJedes der über 140 Synter-Tools direkt ausführen

Keine Werbeerfahrung? Kein Problem.

Wenn Sie noch nie Anzeigen geschaltet haben, hier ist, was Sie wissen müssen:

Was ist eine Kampagne?

Eine Kampagne ist wie ein Projektordner. Sie enthält Ihre Anzeigen, wer sie sieht und wie viel Sie ausgeben.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

Welche Plattformen kann ich nutzen?

PlattformAm besten fürMindestbudget
Google AdsPersonen, die aktiv nach Ihrem Produkt suchen10 $/Tag
Meta (Facebook/Instagram)Visuelle Produkte, breite Zielgruppen5 $/Tag
LinkedInB2B, Unternehmen, Arbeitssuchende25 $/Tag
RedditNischen-Communitys, technikaffine Nutzer5 $/Tag
Microsoft (Bing)Ältere Zielgruppen, B2B10 $/Tag
TikTokGen Z, Unterhaltung, E-Commerce20 $/Tag

Kampagnentypen erklärt

Suchkampagnen – Ihre Anzeige erscheint, wenn jemand bestimmte Keywords googelt.

  • Beispiel: Jemand sucht "beste CRM-Software" → Ihre Anzeige erscheint

Display-Kampagnen – Bildanzeigen, die auf Websites und in Apps geschaltet werden.

  • Beispiel: Bannerwerbung auf einer Nachrichtenseite

Performance Max (PMax) – Googles KI zeigt Ihre Anzeigen überall (Suche, YouTube, Display, Gmail, Maps).

  • Beispiel: Google findet die besten Platzierungen für Sie

Videokampagnen – Videoanzeigen auf YouTube und Partnerseiten.

  • Beispiel: 15-sekündige Anzeige vor einem YouTube-Video

Häufige Begriffe

BegriffBedeutung
ImpressionenWie oft Ihre Anzeige gezeigt wurde
KlicksWie viele Personen auf Ihre Anzeige geklickt haben
CTRClick-Through-Rate (Klicks ÷ Impressionen × 100)
CPCKosten pro Klick
ConversionsGewünschte Aktionen (Anmeldungen, Käufe usw.)
ROASReturn on Ad Spend (Umsatz ÷ Ausgaben)

Checkliste für die erste Kampagne

Bevor Sie Ihre erste Kampagne erstellen, benötigen Sie:

  1. ✅ Eine Landingpage-URL, auf die Personen nach einem Klick gelangen
  2. ✅ Eine Vorstellung, wen Sie erreichen möchten (Standort, Interessen)
  3. ✅ Ein Tagesbudget, mit dem Sie sich wohlfühlen (10–50 $ zum Start)
  4. ✅ Einige Überschriften und Beschreibungen für Ihre Anzeige

Profi-Tipp: Beginnen Sie mit einer Suchkampagne auf Google. Sie ist am einfachsten zu verstehen und zeigt Anzeigen Personen, die bereits nach Ihrem Angebot suchen.


Beispielkonversationen

Erste Kampagne erstellen

Sie: Erstelle eine Google-Suchkampagne für mein SaaS-Produkt. Zielgruppe: Personen, die nach "Team-Collaboration-Software" und "Projektmanagement-Tools" suchen. Budget: 25 $/Tag. Landingpage: https://myapp.com/signup

Agent: Ich erstelle eine Suchkampagne mit diesen Keywords. Welche Überschriften soll ich verwenden? Hier einige Vorschläge:

  • "Team-Collaboration leicht gemacht"
  • "Projektmanagement für moderne Teams"
  • "Kostenlos starten – Keine Kreditkarte"

Leistung prüfen

Sie: Wie laufen meine Kampagnen diese Woche?

Agent: Hier Ihre Leistung der letzten 7 Tage:

KampagneAusgabenKlicksConversionsROAS
Markensuche142 $89124,2x
Wettbewerber-Keywords98 $4531,5x
Display-Retargeting67 $23482,8x

Die Kampagne "Wettbewerber-Keywords" ist leistungsschwach. Soll ich sie pausieren oder das Targeting anpassen?

Negative Keywords hinzufügen

Sie: Ich bekomme Klicks für "kostenloses Projektmanagement", aber wir haben keine kostenlose Version. Blockiere diese.

Agent: "Kostenlos" wurde als negatives Keyword zu Ihrer Kampagne hinzugefügt. Dadurch werden Ihre Anzeigen nicht mehr für Suchanfragen mit "kostenlos" ausgespielt.

Werbemittel generieren

Sie: Ich brauche ein Display-Anzeigenbild für ein Marketing-Automation-Produkt. Dunkles Design, professionell, 1200x628.

Agent: Generiere Ihr Bild mit Imagen 4...

Erstellt: "Marketing-Automation-Dashboard mit Datenvisualisierung auf dunklem Hintergrund" Asset gespeichert und bereit für Ihre nächste Display-Kampagne.


Werbekonten verbinden

Um Anzeigen auf jeder Plattform zu verwalten, müssen Sie Ihre Konten in Synter verbinden:

  1. Gehen Sie zu syntermedia.ai/settings/credentials
  2. Klicken Sie neben jeder Plattform auf "Verbinden"
  3. Schließen Sie den OAuth-Flow ab
  4. Ihr Agent kann diese Plattform jetzt verwalten

Unterstützte Plattformen:

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • StackAdapt ✅
  • The Trade Desk ✅

Erweitert: Direkter Tool-Zugriff

Für Power-User können Sie jedes der über 140 Synter-Tools direkt aufrufen:

> Use run_tool to call google_ads_list_audiences

Die vollständige Tool-Liste finden Sie unter docs.syntermedia.ai/tools oder fragen Sie Ihren Agenten:

> What tools are available for LinkedIn Ads?

Umgebungsvariablen

VariableErforderlichBeschreibung
SYNTER_API_KEYJaIhr Synter-API-Schlüssel
SYNTER_API_URLNeinAPI-URL-Override (Standard: https://syntermedia.ai)

Lokale Entwicklung

# 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

Fehlerbehebung

"SYNTER_API_KEY nicht gesetzt"

Stellen Sie sicher, dass Ihr API-Schlüssel im env-Abschnitt Ihrer MCP-Konfiguration enthalten ist. Der Schlüssel sollte mit syn_ beginnen.

"Ungültiger oder abgelaufener API-Schlüssel"

  1. Prüfen Sie, ob Sie den vollständigen Schlüssel kopiert haben (er ist lang!)
  2. Überprüfen Sie, ob der Schlüssel unter syntermedia.ai/developer aktiv ist
  3. Stellen Sie sicher, dass der Schlüssel den tools:write-Bereich hat

"Keine Werbekonten verbunden"

Sie müssen mindestens eine Werbeplattform verbinden:

  1. Gehen Sie zu syntermedia.ai/settings/credentials
  2. Klicken Sie neben Google Ads (oder einer anderen Plattform) auf "Verbinden"
  3. Schließen Sie die OAuth-Autorisierung ab

Tools werden in Claude/Cursor nicht angezeigt

  1. Starten Sie Ihren KI-Client vollständig neu (nicht nur aktualisieren)
  2. Überprüfen Sie die MCP-Server-Logs auf Fehler
  3. Überprüfen Sie den Konfigurationsdateipfad und die JSON-Syntax

Ressourcen


Lizenz

MIT-Lizenz – siehe LICENSE für Details.


Synter
Die MCP-Erweiterung, von der sie nicht wollen, dass du sie nutzt.
Weil KI-Agenten mit Werbebudgets alles verändern.