Zum Inhalt springen
Daniel Gietmann
← Blog
KI

Einen Agent ins Werbekonto schauen lassen, ohne dass er Geld ausgibt

openai-ads-mcp gibt Agents Lesezugriff auf ein OpenAI-Ads-Konto und schaltet Schreiben nur auf ausdrückliche Ansage frei. Wie der Schalter funktioniert und wo die Absicherung aufhört.

Ich lasse meine Agents gern in Konten nachsehen: Wie viele Klicks hatte die Kampagne gestern, was hat sie gekostet, hängt eine Anzeige noch in der Prüfung? Bei einem Werbekonto kommt eine Bedingung dazu. Lesen darf der Agent alles. Geld ausgeben soll er nicht, schon gar nicht aus Versehen.

Dafür habe ich openai-ads-mcp geschrieben, einen inoffiziellen MCP-Server für die Advertiser API von OpenAI Ads. Er ist in Python gebaut, spricht MCP über Streamable HTTP unter /mcp und läuft als Container, bei mir auf Coolify. Mit OpenAI hat das Projekt nichts zu tun. Der Text bezieht sich auf den Stand von main vom 14. Oktober 2026 (Commit 3c7b794).

Zwei Schlüssel statt einem

Der Server braucht zwei Geheimnisse. OPENAI_ADS_API_KEY ist der Schlüssel aus dem Ads Manager, und der bleibt auf dem Server. MCP_AUTH_TOKEN denkst du dir selbst aus, eine lange Zufallszeichenkette. Nur dieses Token kommt in den MCP-Client. Taucht es irgendwo auf, wo es nicht hingehört, tauschst du es aus und fasst den Ads-Schlüssel nicht an.

Lokal startest du den Server so:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
cp .env.example .env
# OPENAI_ADS_API_KEY und MCP_AUTH_TOKEN in .env eintragen
set -a; source .env; set +a
openai-ads-mcp

Danach hört er auf Port 8000. /health antwortet ohne Token mit {"status":"ok"}, damit der Healthcheck des Containers funktioniert. Eine Anfrage an /mcp ohne Authorization: Bearer … bekommt eine 401. Den Vergleich macht der Server mit secrets.compare_digest, und beide Geheimnisse filtert er aus seinen Logs und Fehlermeldungen.

Im Client stehen dann nur Adresse und Token:

{
  "mcpServers": {
    "openai-ads": {
      "type": "streamable-http",
      "url": "https://<deine-domain>/mcp",
      "headers": {
        "Authorization": "Bearer <MCP_AUTH_TOKEN>"
      }
    }
  }
}

Schreiben gibt es nur auf Ansage

Ohne weitere Einstellung kann der Server nur lesen. Er kennt dann acht Werkzeuge: Konto, Kampagnen, Anzeigengruppen, Anzeigen, deren Status und einen Bericht mit Impressionen, Klicks, Kosten, CTR und CPC für einen Zeitraum. Die Schreibwerkzeuge sind in diesem Modus nicht gesperrt, sie werden gar nicht erst angemeldet. Der Agent findet sie nicht in der Werkzeugliste und kann sie deshalb auch nicht aufrufen, egal wie die Anfrage formuliert ist.

Freigeschaltet wird das Schreiben nur mit MCP_READ_ONLY=false. Groß- und Kleinschreibung spielen keine Rolle, Leerzeichen drumherum auch nicht. Jeder andere Wert lässt den Server lesend, auch 0, no oder off. Ich habe das gegen den Code geprüft: Mit true meldet der Server 8 Werkzeuge, mit false sind es 21. Die Richtung finde ich richtig. Ein Tippfehler in der Konfiguration ergibt einen Server, der weniger kann, nicht mehr.

Der Schalter wirkt erst beim nächsten Start. Nach dem Umstellen startest du den Container neu und verbindest den Client noch einmal, sonst sieht er die alte Werkzeugliste.

Was im Schreibmodus abgesichert ist

Mit false kommen Bild-Upload, Anlegen, Pausieren, Aktivieren und Bearbeiten dazu. Neue Kampagnen, Anzeigengruppen und Anzeigen schickt der Server immer mit status: paused an die API, das ist im Code fest eingetragen. Ausgeliefert wird erst, wenn jemand das passende activate_…-Werkzeug aufruft. Die Antwort auf das Anlegen sagt das auch dazu.

Eine Kampagne lässt sich außerdem nur mit Budget anlegen, als Gesamt- oder Tageslimit. Beide Werte sind Micros der Kontowährung, 1.000.000 Micros sind eine Einheit, und das ist auch das Minimum. Archivieren hat kein eigenes Werkzeug. Es geht nur über status: archived bei einem Update, und der Server lehnt das ab, solange nicht confirm=true mitkommt. Archivieren lässt sich nämlich nicht rückgängig machen.

Wo die Absicherung aufhört

confirm=true ist keine Rückfrage an dich. Das Feld ist ein Parameter wie jeder andere, und der Agent kann es selbst setzen. Es verhindert, dass beim Umbenennen einer Kampagne nebenbei archiviert wird. Mehr leistet es nicht. Ob vor dem Aufruf jemand gefragt wird, entscheidet dein Client.

Ähnlich ist es mit dem pausierten Anlegen. Sobald Schreiben an ist, gibt es auch activate_campaign, und in den MCP-Hinweisen steht dort destructiveHint=False. Ein Client, der nur bei destruktiven Werkzeugen nachfragt, lässt das Aktivieren also ohne Rückfrage durch, obwohl genau damit Geld ausgegeben wird. Wenn du Werkzeuge in deinem Client einzeln freigeben kannst, stell die drei activate_…-Werkzeuge auf „immer fragen“.

Eine Obergrenze für das Budget kennt der Server nicht, nur die Untergrenze. Wie hoch das Limit ist, bestimmt der Aufruf. Und im lesenden Modus fehlt auch das Pausieren. Läuft eine Kampagne aus dem Ruder, siehst du das im Bericht, anhalten musst du sie dann im Ads Manager.

Doppelt angelegt nach einem Timeout

Beim Anlegen schickt der Server einen Idempotency-Key mit. Gibst du keinen vor, erzeugt er für jeden Werkzeugaufruf eine neue UUID. Antwortet die API mit 429, wiederholt er die Anfrage mit demselben Schlüssel, standardmäßig bis zu fünf Mal, und wartet dazwischen so lange, wie Retry-After verlangt. Bis hierhin ist das sauber gelöst.

Bei einem Timeout, Standard sind 30 Sekunden, sieht es anders aus. Der Server meldet dann nur „The OpenAI Ads API request timed out.“ und versucht es nicht noch einmal. Ob die Kampagne angelegt wurde, weiß in dem Moment keiner. Ruft der Agent das Werkzeug erneut auf, bekommt der neue Aufruf eine neue UUID, und für die API ist das eine neue Anfrage. Das habe ich mit einer nachgebauten API getestet, die beim ersten Aufruf nicht antwortet: Der zweite Aufruf kam mit einem anderen Schlüssel an. Im schlechtesten Fall hast du die Kampagne dann zweimal, immerhin beide pausiert.

Die Werkzeugbeschreibung empfiehlt deshalb, idempotency_key selbst zu setzen und beim Wiederholen denselben Wert zu schicken. Dass ein Agent das von sich aus tut, würde ich nicht voraussetzen. Nach einem Timeout schaue ich lieber mit list_campaigns nach, bevor ich es noch einmal versuche.

Wofür es reicht

Für eine Instanz und ein Werbekonto ist das genug. Die Grenzen von 600 Anfragen pro Minute und Endpunkt und 1.200 insgesamt zählt jeder Prozess für sich. Laufen mehrere Instanzen, stimmen sie sich nicht ab. Dann schützen nur noch die Quoten der API selbst, und der Server wiederholt bei 429.

Wenn du nur Zahlen sehen willst, lass MCP_READ_ONLY einfach weg. Fragen und Fehler gehören in die Issues auf GitHub.