X Ads MCP
Offizieller Remote-MCP-Server von X für kampagnenbezogene Ads-API-Lese-, Analyse- und Schreibvorgänge.
- Skill Road
- X Ads MCP
Kategorien
Beschreibung
X Ads MCP ist der offizielle, remote betriebene Model-Context-Protocol-Server von X für die X Ads API. Der Streamable-HTTP-Endpunkt lautet https://ads-api.x.com/mcp. Laut X kann ein MCP-fähiger Client die angebotenen Werkzeuge automatisch entdecken und damit Kampagnenkonten lesen, Kampagnen- und Reichweitenanalysen abrufen sowie Anzeigenkampagnen verwalten. Die primäre Dokumentation ist https://docs.x.com/x-ads-api/mcp. Das ist kein allgemeiner Server für Timeline-, Such-, Direktnachrichten- oder sonstige Standardzugriffe auf X: Er ist auf die Werbeplattform, Ads-Konten, Kampagnen, Creatives, Targeting und Ads-Analytics begrenzt.
Was der Ads-Server kann – und was nicht
Die X-Dokumentation führt Werkzeuge für Ads-Konten und Lesedaten auf, darunter Kampagnen, Line Items, Finanzierungsinstrumente, promotete Posts, Targeting-Kriterien und aktive Entitäten. Analytics-Werkzeuge liefern Account-Statistiken und Kampagnen-Reichweitenschätzungen. Für die Vorbereitung von Zielgruppen gibt es Suchen nach Interessen und Orten. Schreibwerkzeuge können Kampagnen und Line Items anlegen oder aktualisieren, Targeting hinzufügen oder entfernen, Nullcast-Ad-Posts erzeugen und Posts promoten.
Das bedeutet nicht, dass ein KI-Client damit beliebig auf X zugreift. Der Server ersetzt keine allgemeine X API, verwaltet keine privaten Nachrichten und erweitert keine Rechte außerhalb der Ads API. Auch der eigentliche Zugriff richtet sich nach der jeweiligen App-Freigabe und den Rollen im Ads-Konto. X unterscheidet etwa Account Administrator, Ad Manager, Campaign Analyst, Organic Analyst und Creative Manager. Ein Agent erhält nur die Funktionen, die der angemeldete Nutzer, die autorisierte App und das konkrete Ads-Konto zulassen.
OAuth, Scopes und Account-Grenzen
Für die MCP-Verbindung wird laut X eine eigene App in der X Developer Console benötigt, mit Ads-Projektzugriff und Read-and-Write-App-Berechtigung. Der Nutzer authentifiziert sich mit seinem eigenen OAuth-2-Token; für den Remote-MCP nennt X die Scopes ads.read, ads.write und offline.access. ads.read schaltet Lesen und Analytics frei. Wer nur analysieren möchte, sollte ads.write weglassen: Schreibwerkzeuge scheitern dann autorisiert statt versehentlich Änderungen vorzunehmen. offline.access erlaubt das Aktualisieren des Tokens; ohne diesen Scope laufen Zugriffstoken laut X nach kurzer Zeit ab und können nicht automatisch erneuert werden.
Die OAuth-Grenze ist relevant für Agenten: Der Server sieht nur Ads-Konten, auf die dieser Nutzer Zugriff hat. Eine einzelne X-App kann nach der X-Dokumentation nur einen aktiven OAuth-Grant pro App-und-Nutzer-Kombination halten; eine Anmeldung in einem zweiten Client kann den ersten Token-Satz widerrufen. Für mehrere Clients ist deshalb je Client eine eigene App sinnvoll. Zugangstoken, Refresh-Tokens, Client-Secrets und Callback-Codes gehören nie in Prompts, Versionskontrolle oder Screenshots. Native Clients verwenden PKCE und benötigen kein Secret; bei vertraulichen Clients gelten die von X dokumentierten Authentifizierungsanforderungen.
Kampagnenänderungen und menschliche Freigabe
Der MCP-Server kann externe Werbeobjekte verändern. X reduziert einen Teil des Risikos, indem neu erstellte Kampagnen und Line Items immer PAUSED starten; Geld wird laut Anbieter erst ausgegeben, wenn ein Nutzer sie ausdrücklich aktiviert. Das ist eine sinnvolle Schutzschicht, aber keine vollständige Genehmigungsstrecke. Die Tools activate_campaign und activate_line_item können diese letzte Aktivierung ausführen. Bei Budget, Targeting, Creatives, Audience-Änderungen oder Promotion sollte deshalb eine Person die beabsichtigten Parameter, Kontozuordnung und Freigabe vor dem Aktivieren prüfen. Ein separater Analyse-Client ohne ads.write ist für Reporting und Planung die sicherere Grundeinstellung.
Ads- und Kundendaten, Modellpfad und Prompt Injection
Werkzeugantworten können Kampagnenleistung, Reichweitenwerte, Finanzierungsinformationen, Zielgruppen- oder Standortkriterien sowie promotete Inhalte enthalten. Die Ads API kann außerdem Custom Audiences mit X-, Web- oder Mobile-Daten verwalten; diese Daten sind besonders schutzbedürftig. Der Datenpfad ist nicht nur „X zu X“: X liefert Resultate an den MCP-Client, und der Client entscheidet, welche Tool-Resultate er an das verbundene Sprachmodell weitergibt. Bei einem gehosteten Modell können diese Inhalte somit zusätzlich zum Client und zu X beim Modellanbieter verarbeitet werden. Vorher müssen Datenschutzvorgaben, Auftragsverarbeitung, Aufbewahrung und die Client- bzw. Modellkonfiguration geprüft werden.
Unvertraute Namen, Posts, Zielgruppenbezeichnungen oder Analysefelder können Text enthalten, der wie Handlungsanweisungen wirkt. Das ist Prompt Injection, nicht eine vertrauenswürdige Anweisung des Nutzers. Der Agent sollte Tool-Daten als Daten behandeln, Schreibaktionen niemals allein aus solchen Inhalten ableiten und Aktivierungen manuell bestätigen lassen. Verwende nach Möglichkeit getrennte Lese- und Schreibsitzungen und ein Ads-Testkonto für erste Versuche.
Limits, Betrieb und Quellcode
X dokumentiert für die Ads API Token- und teilweise Ads-Konto-bezogene Rate Limits. Die aktuell maßgeblichen Limits und Reset-Zeitpunkte stehen in HTTP-Response-Headern; Client oder Agent sollte diese auswerten, Abrufe bündeln, nur seit der letzten Synchronisierung aktualisierte Daten anfragen und bei 429 bzw. erschöpften Kontingenten warten statt aggressiv zu wiederholen. Schreiboperationen sind nicht automatisch durch die gleichen konto-bezogenen Limits abgedeckt wie Leseoperationen.
X veröffentlicht für X Ads MCP eine offizielle Remote-Dokumentation und einen Gateway-Endpunkt, aber zum Review am 2026-09-08 kein öffentliches, X-betriebenes Quellcode-Repository dieses Ads-spezifischen Servers. repo_url und GitHub-Sterne sind daher absichtlich leer. Das öffentliche Repository xdevplatform/xMCP betrifft einen separaten allgemeinen X-API-MCP-Server und darf nicht als Quellcode oder Popularitätswert für X Ads MCP ausgegeben werden. Social Media und Automatisierung passen, weil der Server Werbeaktivitäten auf X kontrolliert lesbar, analysierbar und automatisierbar macht.
Voraussetzungen
Eigene X-Developer-App mit Ads-Projektzugriff, ein X-Nutzer mit Zugriff auf mindestens ein Ads-Konto sowie ein MCP-Client mit Streamable-HTTP- und OAuth-2-Unterstützung.
Installationsanleitung
Dieser Ratgeber bezieht sich ausschließlich auf den offiziellen X Ads MCP unter https://ads-api.x.com/mcp und die Dokumentation https://docs.x.com/x-ads-api/mcp. Er ist nicht die Einrichtung eines allgemeinen X-API-Servers. Plane vor dem Verbinden, ob der Agent nur Kampagnen analysieren soll oder nach einer menschlichen Freigabe auch Änderungen vorbereiten darf. Für den ersten Test ist ein separates Ads-Testkonto oder eine eng begrenzte Kampagne sinnvoll.
X-App und Ads-Zugriff vorbereiten
Lege in der X Developer Console eine neue oder vorhandene App an. Aktiviere laut X die App-Berechtigung Read and Write, wähle für den üblichen PKCE-Weg eine Native App und registriere genau die Callback-URI des verwendeten Clients. Für Claude Code nennt X http://localhost:8080/callback; andere Clients können andere, in der Dokumentation genannte Callback-URIs benötigen. Aktiviere unter Project Access das Ads Project. Prüfe außerdem, dass dein X-Nutzer tatsächlich Zugriff auf mindestens ein Ads-Konto hat. Ein vorhandenes X-Profil genügt nicht ohne Ads-Konto- oder Rollenfreigabe.
Eine App-und-Nutzer-Kombination hält laut X nur einen aktiven OAuth-Grant. Wenn du denselben Nutzer in einem zweiten Client anmeldest, kann der erste Client seine Tokens verlieren. Nutze deshalb pro dauerhaftem Client eine eigene X-App und dokumentiere, wem diese App und das zugehörige Ads-Konto gehören.
Schritt 1: Mit kleinsten Scopes verbinden
Starte mit den OAuth-Scopes ads.read offline.access. Damit kann der Agent Konten auflisten und Analytics lesen, aber keine Kampagnen, Line Items, Creatives oder Targeting verändern. offline.access ermöglicht Token-Refresh; ohne diesen Scope musst du nach Ablauf des Zugriffstokens erneut interaktiv anmelden. Ergänze ads.write erst, wenn es einen klaren Änderungsauftrag und einen Freigabeweg gibt.
Für Claude Code dokumentiert X diesen Grundbefehl:
claude mcp add x-ads https://ads-api.x.com/mcp --transport http --client-id YOUR_OAUTH2_CLIENT_ID --callback-port 8080
Führe anschließend /mcp im Client aus und schließe den Browser-Login ab. Die von X beschriebene Scope-Einschränkung für Claude Code wird in dessen Server-Konfiguration als ads.read offline.access gesetzt. Gib niemals Access Token, Refresh Token, OAuth-Code oder Client Secret in einen Chat ein. Native Apps benötigen für PKCE kein Client Secret.
Zuerst lesen, dann gezielt schreiben
Bitte den Agenten zuerst, die erreichbaren Ads-Konten aufzulisten und eine einzelne Kampagne samt Leistungsdaten zu erklären. Prüfe, ob die Kontonummer, der Anzeigename und der Zeitraum stimmen. Tool-Ergebnisse können Reichweite, Ausgaben, Targeting, Finanzierungsinformationen oder Daten zu promoteten Posts enthalten; behandle sie entsprechend vertraulich.
Für Änderungen sollte der Agent zunächst einen Plan liefern: Zielkonto, Kampagnenname, Budget- und Zeitrahmen, Targeting, Creative und die konkrete Tool-Folge. Prüfe diesen Plan außerhalb von Tool-Texten. X erstellt neue Kampagnen und Line Items laut Dokumentation immer PAUSED. Das verhindert sofortige Ausgaben, ersetzt aber keine Prüfung: Erst activate_campaign oder activate_line_item löst die Aktivierung aus. Freigabe und Aktivierung sollten bei einer verantwortlichen Person bleiben.
Datenpfad und Prompt Injection begrenzen
Die Daten laufen von X zum MCP-Client und von dort, abhängig von dessen Konfiguration, weiter zum Sprachmodell. Bei einem Cloud-Modell können Kampagnen-, Audience- und Kundendaten also auch beim Modellanbieter landen. Prüfe Datenschutz, Auftragsverarbeitung, Log-Aufbewahrung und ob Tool-Resultate gespeichert oder zum Training verwendet werden. Verwende keine echten Kundensegmente in ersten Tests, wenn deren Weitergabe ungeklärt ist.
Namen von Audiences, Posts oder Analysefeldern sind keine vertrauenswürdigen Anweisungen. Wenn ein Tool-Ergebnis etwa fordert, mehr Daten abzurufen oder eine Kampagne zu aktivieren, ist das Prompt Injection. Lass Tool-Daten nicht die Tool-Auswahl bestimmen. Trenne Analyse von Schreibzugriff, verlange bei jeder Aktivierung eine explizite Bestätigung und verwende möglichst ein Testkonto.
Rate Limits beobachten und Fehler sicher behandeln
X veröffentlicht Limits und Reset-Zeiten in Response-Headern. Beachte sowohl token- als auch gegebenenfalls Ads-Konto-bezogene Header. Bündele Abfragen, frage bei Synchronisation nur seit dem letzten Stand geänderte Daten ab und wiederhole Fehler nicht blind. Bei 401 ist der Token möglicherweise abgelaufen; erneuere ihn über den vorgesehenen OAuth-Flow. Bei 403 fehlen häufig Ads-Projektzugriff, App-Freigabe oder Konto-Rechte. Bei 429 warte bis zum Reset und reduziere die Abfragerate.
Abschlusskontrolle
Halte fest, welcher Client, welche X-App, welcher Nutzer und welche Ads-Konten verbunden sind. Verifiziere, dass eine reine Analyse-Sitzung ohne ads.write keine Änderungen ausführen kann. Dokumentiere, wer Kampagnenaktivierungen freigibt, und überprüfe die Client-Konfiguration regelmäßig auf unnötige Tokens oder zu breite Scopes. So bleibt X Ads MCP ein kontrolliertes Werkzeug für Ads-Analysen und vorbereitete Kampagnenarbeit statt eines unüberwachten Schreibzugangs.
claude mcp add x-ads https://ads-api.x.com/mcp --transport http --client-id YOUR_OAUTH2_CLIENT_ID --callback-port 8080
Authentifizierung
OAuth 2 mit dem eigenen X-Nutzer und den Scopes ads.read, optional ads.write sowie offline.access. Native Clients nutzen PKCE; Tokens und Callback-Codes geheim halten.
Benötigte Zugriffsrechte
Nur die Ads-Konten und Ads-API-Funktionen, die für den OAuth-Nutzer, die X-App und die jeweilige Ads-Konto-Rolle freigegeben sind. ads.write erlaubt verändernde Werkzeuge.
Übertragene oder gespeicherte Daten
X übermittelt Ads-API-Ergebnisse an den MCP-Client. Der Client bestimmt, welche Tool-Ergebnisse an das verbundene Modell weitergereicht werden; bei gehosteten Modellen können Ads- und Kundendaten daher zusätzlich beim Modellanbieter verarbeitet werden.
Sicherheitsrisiken
ads.write kann Kampagnen, Targeting, Creatives und Aktivierungen verändern. Prompt Injection in Tool-Daten, Token-Diebstahl, Weitergabe von Audience-/Leistungsdaten und übersehene Rate Limits sind relevante Risiken. Mit ads.read beginnen, Secrets schützen und Aktivierungen manuell prüfen.
Lizenz und Kosten
- Lizenz
- Noch nicht erfasst.
- Kosten
- kostenlos
Der Remote-Server wird von X bereitgestellt. Für Ads-API-Zugriff, Ads-Konto und KI-Client gelten die aktuellen Bedingungen der jeweiligen Anbieter; dieser Eintrag nennt keine festen Preise.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- X
- Status
- Offizieller Server
- Betriebsart
- Remote
- Aktuelle Version
- Noch nicht erfasst.
- Zuletzt geprüft
- 08.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.
Noch keine passenden Ratgeber vorhanden.