MCP & API

Ihre Zahlen für KI-Assistenten und eigene Tools

Sie müssen dafür kein Entwickler sein: Einen KI-Assistenten wie Claude verbinden Sie per Anmeldung im Browser. Wer eigene Tools baut, nutzt die REST-API. Beide liefern dieselben Daten mit denselben Rechten.

Der Weg einer Anfrage

Vom KI-Assistenten bis zu Ihren Konten

Der MCP-Server speichert keine Anbieter-Token. Rechte, Projekte und Limits prüft ausschließlich die WOODNIO-API.

Alle Quellen, Endpunkte und Exporte finden Sie auf der Seite Schnittstellen.

REST-API

Klare Ressourcen, stabile Version

Basis-URL: https://api.woodnio.de/api/v1

  • OpenAPI 3.1 als Referenz der Schnittstelle.
  • Projektbezogene API-Schlüssel mit eigenen Scopes, Ablaufdatum und Widerruf.
  • Cursor-Pagination und Fehler im Format application/problem+json (RFC 9457).
  • Rate-Limits je Schlüssel und Organisation, sichtbar in den RateLimit-*-Headern.
  • Idempotenz über den Header Idempotency-Key bei allen schreibenden Aktionen.
  • Stabile Version. /v1 ändert sich nur additiv, Abkündigungen kommen über Deprecation- und Sunset-Header.
GET  /projects
GET  /projects/{id}/campaigns?provider=google_ads
GET  /projects/{id}/reports/performance?from=2026-10-01&to=2026-10-31
GET  /providers
GET  /providers/{provider}/fields
POST /projects/{id}/query
POST /projects/{id}/exports
GET  /usage
GET  /audit-logs
curl https://api.woodnio.de/api/v1/projects \
  -H "Authorization: Bearer $WOODNIO_API_KEY"
Remote-MCP

Ihren KI-Assistenten mit Ihren Werbedaten verbinden

Der MCP-Server unter mcp.woodnio.de läuft remote, Sie installieren nichts lokal. Die Anmeldung erfolgt im Browser, dort wählen Sie Organisation, Projekte und Rechte, die Ihr KI-Assistent erhält.

Lesende Werkzeuge

  • list_projects – Projekte Ihrer Organisation
  • list_connected_accounts – zugeordnete Konten je Projekt
  • get_connectors und get_fields – verfügbare Quellen, Metriken und Dimensionen
  • get_data – validierte freie Abfrage
  • get_campaigns, get_campaign_performance, get_ga4_report – häufige Fälle direkt

Werkzeuge mit Freigabe (ab Pro)

  • preview_campaign_budget_change
  • preview_pause_campaign und preview_resume_campaign
  • list_pending_actions – offene Freigaben

Diese Werkzeuge erzeugen nur Entwürfe. Die Freigabe erteilt ein Mensch im Portal.

Sicher angebunden

OAuth 2.1 mit PKCE, kurzlebige Zugriffstoken, Widerruf im Portal. Token gelten nur für den WOODNIO-MCP-Server und werden nicht an Dritte weitergereicht.

Gehärtet gegen Prompt Injection

Kampagnennamen und Anzeigentexte können von Dritten stammen. WOODNIO liefert sie in festen Schemata, kürzt Freitext und kennzeichnet ihn als Daten.

Beispiel

Fragen, die Sie Ihrer KI stellen können

  • „Wie hoch waren die Werbekosten von shop-a.de in den letzten 7 Tagen?“
  • „Welche Meta-Kampagnen haben diesen Monat mehr als 20 % über dem Budget gelegen?“
  • „Vergleiche Conversions aus Google Ads und GA4 für landingpage.de.“
  • „Schlage vor, welche Kampagne pausiert werden sollte, und erstelle die Vorschau.“

Antworten stammen aus Ihren verbundenen Konten. Aktionen werden nie ohne Ihre Freigabe ausgeführt.

Bereit, Ihre Werbedaten zentral zu nutzen?

Wählen Sie Ihren Tarif ab 9 € netto im Monat. Ein Wechsel ist jederzeit möglich.