Open SourceKostenlos · MITNur lesend

OpenAI Ads MCP: kostenloser Open-Source-Server für ChatGPT Ads

Lies deine ChatGPT-Ads-Kampagnen und Reports in Claude, Cursor oder VS Code, in normaler Sprache. 11 Tools, alle nur lesend, läuft per npx auf deinem Rechner.

Google Ads oder Meta laufen neben ChatGPT Ads? Zum HYPD-Konnektor

HYPD-AI / openai-ads-mcp

openai-ads-mcp

MCP-Server für die OpenAI Ads API. Kampagnen, Anzeigengruppen, Anzeigen und Performance-Daten aus jedem MCP-Client lesen.

6GitHub-SterneTypeScriptMIT
Auf GitHub ansehen

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 Tool, du stellst die Frage.

Konto und API-Key prüfen

Prüf, ob dein Key funktioniert und zu welchem Werbekonto er gehört.

Frag zum BeispielFunktioniert mein OpenAI-Ads-API-Key, und zu welchem Werbekonto gehört er?

Kampagnen, Anzeigengruppen und Anzeigen lesen

Ziele, Budgets, Targeting, Gebote, Creatives und Prüfstatus.

Frag zum BeispielZeig mir meine aktiven Kampagnen mit Budget und danach alle Anzeigen, die noch in Prüfung sind.

ChatGPT-Ads-Reports in jeden MCP-Client holen

Konto, Kampagne, Anzeigengruppe oder Anzeige. Jeder 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.

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 sind geplant und brauchen dann eine ausdrückliche Freigabe.

So funktioniert der OpenAI Ads MCP in 3 Schritten

Der Server liegt auf npm, du musst also nichts klonen oder bauen.

Die Hintergründe: Lies, wie wir ChatGPT Ads in Claude gebracht haben.

  1. 1

    API-Key erstellen

    Unter Settings auf ads.openai.com. Ein Key pro Werbekonto.

  2. 2

    Server in deinen Client eintragen

    Füg den Block auf dieser Seite in Claude Desktop, Cursor oder VS Code ein. Braucht Node.js 20 oder neuer.

  3. 3

    Deinen Assistenten fragen

    „Nutze die openai-ads-Tools und zeig mir mein Werbekonto.“

{
  "mcpServers": {
    "openai-ads": {
      "command": "npx",
      "args": ["-y", "@hypd-ai/openai-ads-mcp"],
      "env": {
        "OPENAI_ADS_API_KEY": "your-openai-ads-api-key"
      }
    }
  }
}

Gehört in die claude_desktop_config.json oder in ~/.cursor/mcp.json. Mehrere Werbekonten brauchen mehrere Einträge. VS Code und weitere Clients

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.

Für wen der ChatGPT Ads MCP gedacht ist

Such dir die Karte aus, die zu dir passt.

Entwickler:innen und Agent-Builder

Volle Kontrolle. MIT-Lizenz, TypeScript, Pull Requests willkommen.

  • Bau einen Agenten, der jeden Morgen über ChatGPT Ads berichtet.
  • Teste, wie deine eigenen Prompts die 11 Tools nutzen.
  • Fix oder erweitere den Server und gib es ans Repo zurück.
Mehr

Die OpenAI Ads API ist jung, und wer Agenten dagegen baut, stößt zuerst auf die Ecken und Kanten. Jede Änderung muss Linting, Typprüfung und Tests bestehen. Bei größeren Änderungen eröffnest du am besten zuerst ein Issue, damit wir den Ansatz abstimmen. Mit dem MCP Inspector siehst du beim Bauen jeden Tool-Aufruf.

Kleine Unternehmen

Sicheres Reporting. Der Server kann keine Kampagne ändern und keinen Cent ausgeben.

  • Frag, welche Anzeigen noch in Prüfung sind.
  • Prüf Spend und Klicks von gestern in einem Satz.
  • Finde die Kampagne, die ihr Budget am schnellsten verbraucht.
Mehr

Wenn du neu bei ChatGPT Ads bist, starte mit OpenAIs eigenem Ads Manager auf ads.openai.com oder dem offiziellen ChatGPT-Ads-Manager-Plugin. Diesen Server nimmst du später dazu, wenn du schnelle Antworten zu deinen Ergebnissen willst, ohne ein Dashboard zu öffnen.

Agenturen und Multi-Channel-Teams

Vergleiche ChatGPT Ads mit Google und Meta in einem Gespräch.

  • Stell den ChatGPT-Ads-Spend neben den von Google und Meta.
  • Gib jedem Kunden und jedem Teammitglied eigenen Zugriff.
  • Behalte ein Audit-Log für die Kanäle, die du schon steuerst.
Mehr

Dieser Server liest nur OpenAI Ads. Der HYPD-Konnektor deckt Google Ads, Meta Ads, Google Analytics und Merchant Center ab, mit Berechtigungen pro Person und pro Kunde und einem Audit-Log. OpenAI Ads ist heute nicht Teil des HYPD-Konnektors, also lass beide im selben Assistenten laufen.

Der OpenAI Ads Manager MCP im Vergleich mit den Alternativen

Einen offiziellen MCP-Server von OpenAI gibt es nicht. Die größte Schwäche des HYPD-Servers: Er liest nur.

Optionen für einen OpenAI Ads MCP im Vergleich
OptionTypKann es schreiben?PlattformenAm besten für
HYPD Open-Source-ServerLokal per npx. Kostenlos, MITNur lesendOpenAI AdsEntwickler:innen, die Kontrolle und sicheres Reporting wollen
HYPD-KonnektorZum Produkt In der EU gehostet. Kostenloser Plan, bezahlt ab 19,99 €/MonatStandardmäßig nur lesendGoogle Ads, Meta Ads, Google Analytics, Merchant Centernicht OpenAI AdsTeams und Agenturen mit mehreren Plattformen
ChatGPT-Ads-Manager-Pluginoffiziell von OpenAIPluginSchreibt, mit BestätigungChatGPT AdsWerbetreibende, die OpenAIs eigenes Tool wollen
OpenAI Ads ManagerWeb-OberflächeSchreibtChatGPT AdsAbrechnung, Verifizierung, Bulk-Upload, visuelle Kontrolle

Die Angaben zu den Zeilen, die nicht von HYPD sind, stammen von Anbieterseiten, wie KI-Assistenten sie wiedergeben. Prüf sie, bevor du kaufst. Weitere Vergleiche

Preise

Der Server ist kostenlos. Der HYPD-Konnektor hat einen kostenlosen Plan.

OpenAI Ads MCP-Server

0 €

Kostenlos, MIT-Lizenz.

HYPD-Konnektor

0 €

Kostenloser Plan, bezahlt ab 19,99 €/Monat.

Werbebudget bei OpenAI

—

Rechnet OpenAI ab. Der Server ändert daran nichts.

FAQ

Noch Fragen? Eröffne ein Issue auf GitHub oder sprich mit dem Team.

Mit dem Team sprechen

Diese Seite wird von der HYPD Advertising Intelligence GmbH betrieben. Der OpenAI Ads MCP ist ein Community-Projekt, nicht mit OpenAI verbunden und nicht von OpenAI unterstützt.

Bring Paid Media sicher in deine KI.

Installier den Server für dein ChatGPT-Ads-Reporting oder verbinde den Rest deines Stacks mit HYPD.