gravity-ads-mcp

Lokaler MCP-Server für die Gravity-Advertiser-Dashboard-API. Erstelle, bearbeite, pausiere und archiviere Kampagnen – und hole alle Store-Reporte ab – über jeden MCP-fähigen Agenten, ohne dass dein API-Schlüssel deinen Computer verlässt.

Gravity stellt zwar einen gehosteten MCP-Server unter https://platform.trygravity.ai/mcp bereit, der ist jedoch nur lesend. Dieses Paket kapselt die vollständige Gravity-Dashboard-API (inklusive Erstellen/Bearbeiten) als lokalen stdio-MCP-Server, der über npx läuft. So gehen die Anfragen direkt von deinem Computer an platform.trygravity.ai – nichts wird über einen Dritten geleitet.

Voraussetzungen

• Node.js ≥ 18 (node --version zur Überprüfung)

• npx (mit npm gebündelt; in Node.js enthalten)

• Ein Gravity-Advertiser-API-Schlüssel – den bekommst du unter https://app.trygravity.ai im Bereich Einstellungen → API-Schlüssel

Related MCP server: Google Ads MCP Worker

Schnellstart

Füge Folgendes zur Konfigurationsdatei deines MCP-Clients hinzu. Ersetze your-gravity-api-key durch deinen echten Schlüssel.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Windows-Benutzer: Falls npx nicht gefunden wird, versuche "command": "cmd" mit "args": ["/c", "npx", "-y", "gravity-ads-mcp"].

Claude Code

Erstelle eine .mcp.json-Datei im Projektstammverzeichnis (oder fügen sie zu ~/.claude/mcp.json für die globale Konfiguration hinzu):

{
  "mcpServers": {
    "gravity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Oder über die CLI hinzufügen:

claude mcp add gravity --env GRAVITY_API_KEY=your-gravity-api-key -- npx -y gravity-ads-mcp

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

opencode

opencode.json im Projektstammverzeichnis:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gravity": {
      "type": "local",
      "command": ["npx", "-y", "gravity-ads-mcp"],
      "environment": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Hinweis: opencode verwendet "environment" (nicht "env").

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Andere Clients

Jeder MCP-Client, der das mcpServers-JSON-Format unterstützt (gleiche Form wie Claude Desktop), kann diesen Server verwenden. Füge der MCP-Konfigurationsdatei deines Clients Folgendes hinzu:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Umgebungsvariablen

Tools

Account

Kampagnen

Anzeigengruppen & Anzeigen

Reporting

Beispiel-Prompts

Sobald eingerichtet, kannst du deinen Agenten zum Beispiel bitten:

• „Liste meine aktiven Kampagnen auf“

• „Wie hoch ist mein ROAS in den letzten 14 Tagen?“

• „Erstelle eine Kampagne mit dem Namen ‚Summer Sale‘ mit einem Tagesbudget von 100 $, Targeting auf US and CA, mit generativer Ad-Group für Laufschuhe“

• „Pauuuusiiere alle Kampagnen mit mehr als 500 $ Ausgaben“

• „Zeig mir die Anzeigengruppen-Performance der Kampagne 456 für die letzten 7 Tage in America/New_York“

• „Erstelle eine manuelle Anzeigengruppe mit diesen Anzeigen: Überschrift ‚50% auf Laufschuhe‘, Text ‚Sommer-Schlussverkauf auf alle Laufschuhe‘, CTA ‚Jetzt einkaufen‘“

• „Welche Conversions kamen gestern rein?“

• „Erstelle einen Pixel für https://acme.com“

Sicherheit & Datenschutz

• Ihr GRAVITY_API_KEY wird als Prozess-Umgebungsvariable übergeben und niемals geloggt oder an einen anderen Server als platform.trygravity.ai übertragen.

• Alle Anfragen gehen direkt von Ihrem Rechner an die Gravity-API – ohne Zwischenservice.

• npx bedeutet: keine globale Installation; der Server startet jede Sitzung neu.

• Deinen Schlüssel kannst du jederzeit unter https://app.trygravity.ai im Bereich Einstellungen → API-Schlüssel neu generieren.

Fehlerbehebung

Mitwirkende

Für lokale Einrichtung, Build, Testing- und Publishing-Anweisungen siehe DEVELOPMENT.md.

Lizenz

MIT