Der OpenAI Ads MCP-Server für ChatGPT Ads
OpenAI Ads ist neu, die API ist neu, und die meisten Teams finden gerade erst heraus, wie eine Kampagne dort überhaupt aussieht. Der OpenAI Ads MCP ist ein kostenloser Open-Source-Server, der dein ChatGPT-Ads-Konto in den KI-Assistenten bringt, den du schon nutzt. Fragen zu Kampagnen und Ergebnissen stellst du einfach in normaler Sprache.
Was du mit dem OpenAI Ads MCP machst
Der Server stellt die Lese-Endpunkte der OpenAI Ads API als 11 MCP-Tools bereit. Dein Assistent wählt das passende Tool, du stellst die Frage.
Konto und API-Key prüfen
Prüf, ob dein Key funktioniert und zu welchem Werbekonto er gehört. Jeder OpenAI-Ads-Key gilt für genau ein Werbekonto.
Frag zum BeispielFunktioniert mein OpenAI-Ads-API-Key, und zu welchem Werbekonto gehört er?
Kampagnen, Anzeigengruppen und Anzeigen lesen
Kampagnen mit Ziel, Budget und Länder-Targeting auflisten, Anzeigengruppen samt Gebotseinstellungen ansehen und für jede Anzeige Creative und Prüfstatus abrufen.
Frag zum BeispielZeig mir meine aktiven Kampagnen mit Budget und danach alle Anzeigen, die noch in Prüfung sind.
Reports in jeden MCP-Client holen
Performance-Daten für das ganze Konto, eine Kampagne, eine Anzeigengruppe oder eine einzelne Anzeige, für jeden Zeitraum, täglich oder als Summe.
Frag zum BeispielZeig mir Spend, Klicks und CTR pro Kampagne für die letzten 30 Tage, aufgeteilt nach Tagen.
Normale Sprache statt roher API
Keine Requests bauen, keine Pagination-Cursor, kein Umrechnen von Micros. Die Tool-Beschreibungen erklären die Konventionen der API, damit der Assistent mit lesbaren Beträgen antwortet.
Frag zum BeispielWelche Kampagne hat bisher den größten Anteil ihres Gesamtbudgets ausgegeben?
Aktuell nur lesend. Der Server legt nichts an, ändert oder pausiert nichts und gibt kein Budget aus. Schreibzugriffe stehen auf der Roadmap und brauchen dann eine ausdrückliche Freigabe.
In unter einer Minute installiert und live.
Der Server liegt auf npm, du musst also nichts klonen oder bauen. Dein MCP-Client startet ihn per npx und übergibt deinen API-Key als Umgebungsvariable.
Das brauchst du
- Node.js 20 oder neuer
- Ein OpenAI-Ads-Konto (derzeit nur in den USA) und einen API-Key, den du unter Settings auf ads.openai.com erstellst
- Einen MCP-Client, der lokale Server startet, zum Beispiel Claude Desktop, Cursor oder VS Code
Füg diesen Block in die claude_desktop_config.json ein und starte Claude Desktop neu:
{
"mcpServers": {
"openai-ads": {
"command": "npx",
"args": ["-y", "@hypd-ai/openai-ads-mcp"],
"env": {
"OPENAI_ADS_API_KEY": "your-openai-ads-api-key"
}
}
}
}Cursor nutzt denselben Block in ~/.cursor/mcp.json. Für VS Code und weitere Clients steht im README jeweils ein eigenes Snippet.
Zum Testen fragst du deinen Assistenten: „Nutze die openai-ads-Tools und zeig mir mein Werbekonto.“
Wenn es nicht klappt
- Die Tools tauchen nicht auf: Starte den Client komplett neu und prüf, ob die Konfigurationsdatei gültiges JSON ist.
- npx fehlt oder startet nicht: Installier Node.js 20 oder neuer und starte den Client neu.
- Die API antwortet mit 401 oder 403: Prüf, ob OPENAI_ADS_API_KEY einen gültigen Key für das gewünschte Werbekonto enthält.
- Immer noch nicht: Starte den Server im MCP Inspector, um jeden Tool-Aufruf zu sehen, oder eröffne ein Issue auf GitHub.
ChatGPT Ads und der Rest deines Stacks
Für sich allein liest dieser Server nur OpenAI Ads. Wer ChatGPT Ads testet, steckt den Großteil des Budgets meist weiter in Google und Meta, und die spannenden Fragen gehen über Kanäle hinweg: Ist der neue Kanal pro Conversion günstiger, und wohin sollte der nächste Euro fließen?
HYPD verbindet Google Ads, Meta Ads, Google Analytics und Merchant Center mit demselben KI-Assistenten. So läuft der OpenAI-Ads-Server neben HYPD, und du vergleichst die Kanäle in einem Gespräch.
Open Source, und warum das hier zählt
Wir entwickeln den OpenAI Ads MCP offen, aus zwei Gründen. MCP bringt am meisten, wenn das Ökosystem gemeinsam vorangeht, und ein geschlossener Referenz-Server bremst alle aus. Außerdem ist die OpenAI Ads API jung: Wer Agenten dagegen baut, stößt zuerst auf die Ecken und Kanten. Deshalb sollen Feedback und Fixes im selben Repository landen.
Der Code steht unter MIT-Lizenz und ist in TypeScript geschrieben. Pull Requests sind willkommen; bei größeren Änderungen eröffnest du am besten zuerst ein Issue, damit wir den Ansatz abstimmen. Jede Änderung muss Linting, Typprüfung und Tests bestehen.
Das ist ein Community-Projekt, nicht mit OpenAI verbunden und nicht von OpenAI unterstützt.
Open-Source-Server vs. der HYPD-Konnektor
Der Open-Source-Server ist für Entwickler:innen, die nur OpenAI Ads brauchen und alles selbst in der Hand haben wollen. HYPD ist für Teams, die mehrere Plattformen steuern, Zugriffe regeln müssen und keinen eigenen Server betreiben wollen.
| OpenAI Ads MCP (Open Source) | HYPD-Konnektor | |
|---|---|---|
| Plattformen | OpenAI Ads | Google Ads, Meta Ads, Google Analytics und Merchant Center. OpenAI Ads ist heute nicht Teil des HYPD-Konnektors. |
| Lesen / Schreiben | Aktuell nur lesend; Schreibzugriffe geplant, mit ausdrücklicher Freigabe | Standardmäßig nur lesend, mit Berechtigungen pro Kunde |
| Hosting | Läuft lokal auf deinem Rechner per npx | Von HYPD in der EU gehostet, du betreibst nichts selbst |
| Berechtigungen und Audit | Ein API-Key pro Werbekonto; Zugriffe regelst du selbst | Berechtigungen pro Person und pro Kunde, Audit-Log |
| Support | GitHub-Issues und Pull Requests | Support durch das HYPD-Team |
| Preis | Kostenlos, MIT-Lizenz | Kostenloser Plan; bezahlte Pläne ab 19,99 €/Monat |
| Für wen | Entwickler:innen, die nur OpenAI Ads brauchen und volle Kontrolle wollen | Teams und Agenturen mit mehreren Werbeplattformen |
OpenAI Ads MCP FAQ
Noch Fragen? Eröffne ein Issue auf GitHub oder sprich mit dem Team.