Yandex Direct über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Yandex Direct klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Yandex Direct + Cursor

Lass deine KI deine Werbung in Yandex Direct analysieren, nur lesend: Kampagnen, Anzeigengruppen, Anzeigen, Keywords und Gebote, Sitelinks und Callouts, Agenturkunden, Verzeichnisse, Änderungsverfolgung und Statistikberichte nach Tag, Kampagne, Anzeige oder Suchanfrage.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

YANDEX_DIRECT_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 10 Minuten, dazu kommt die Zeit, die Yandex für die Freigabe des API-Zugangs braucht (von einer Stunde bis zu einigen Werktagen). Du brauchst ein Yandex-Direct-Konto mit mindestens einer Kampagne und eine eigene App, registriert auf oauth.yandex.ru.

1. Registriere eine App auf oauth.yandex.ru: Plattform Webdienste, mit der Berechtigung Yandex Direct API (direct:api). Notier dir ihre ClientID.
2. Öffne in der Weboberfläche von Yandex Direct Tools → API, stell für diese ClientID einen Antrag auf API-Zugang und akzeptiere die API-Nutzungsvereinbarung. Bis Yandex den Antrag freigibt, scheitern Aufrufe mit Fehler 58.
3. Öffne, angemeldet mit dem Direct-Konto, https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID> mit deiner ClientID und kopiere das access_token (es beginnt mit y0_) in YANDEX_DIRECT_TOKEN, ohne Bearer oder OAuth davor. Das Token gilt etwa ein Jahr und verlängert sich, solange es benutzt wird.
4. Nur für Agenturen: Setz YANDEX_DIRECT_CLIENT_LOGIN auf den Yandex-Login des Werbetreibenden, den du lesen willst; yandex_direct_list_agency_clients listet diese Logins. Für dein eigenes Konto lässt du das Feld leer.
5. Installiere den Connector und rufe yandex_direct_get_client auf: Es zeigt das Konto, seinen Login und seine Währung.

Was er liest: Kampagnen mit Typ, Status, Zustand, Laufzeit, Guthaben und allen Klicks und Impressionen seit dem Start, dazu die Gebotsstrategie; Anzeigengruppen mit Regionen und negativen Keywords; Anzeigen mit Titel, Text und Link; Keywords und Autotargeting mit Geboten und Produktivität; Keyword-Gebote mit den Geboten und dem Traffic, die für jede Suchposition nötig sind; Sitelinks, Callouts, gemeinsame Sets negativer Keywords und Retargeting-Listen; Agenturkunden; Verzeichnisse wie Währungen und Regionen; welche Kampagnen sich seit einem Zeitpunkt geändert haben; und Statistikberichte nach Tag, Kampagne, Anzeige oder Suchanfrage.

Berichte: yandex_direct_get_report liefert tabulatorgetrennten Text mit den Spaltennamen in der ersten Zeile und Beträgen als Dezimalzahlen. Kleine Berichte kommen sofort. Größere werden offline erstellt: Die KI fragt nach der von Yandex genannten Wartezeit mit denselben Parametern erneut. Höchstens 5 Offline-Berichte können in der Warteschlange stehen, und Suchanfragenberichte gibt es nur offline und nur für die letzten 180 Tage.

Beträge und Seiten: Gebote, Budgets und Guthaben kommen als ganze Zahlen in Micros (2500000 = 2,50 in der Kontowährung). Listen liefern standardmäßig bis zu 500 Objekte und höchstens 10.000, und Anzeigengruppen, Anzeigen und Keywords werden für bis zu 10 Kampagnen pro Aufruf gelesen.

Bewusst nur lesend: Jedes Tool liest. Nichts legt etwas an, ändert, pausiert oder bezahlt etwas, deshalb gibt es nichts zu bestätigen und bei der Installation nichts abzuschalten.

Limits: Jeder Aufruf verbraucht API-Punkte aus dem Tageskontingent des Werbetreibenden, ein fehlgeschlagener Aufruf kostet 20 Punkte. Die KI macht lieber einen Aufruf mit mehreren IDs als viele einzelne und fragt nur die Felder ab, die sie braucht. Fehler 152 heißt, dass die Punkte für heute aufgebraucht sind; 506 heißt, dass zu viele Anfragen gleichzeitig laufen.

Häufige Fehler: 53 heißt, dass das Token ungültig oder abgelaufen ist: Hol dir wie in Schritt 3 ein neues. 58 heißt, dass der API-Zugang der App noch nicht freigegeben ist. 54, 3000 oder 3001 heißen kein API-Zugang oder keine Rechte, zum Beispiel für einen Kunden-Login, den das Token nicht lesen darf. 513 heißt, dass der Login nicht mit Direct verbunden ist. 8000 und 4000 bis 4006 heißen falscher Parameter, 8800 nicht gefunden und 9300 zu viele IDs in einem Aufruf.

Der Connector legt keine Kampagnen, Anzeigen, Keywords oder Gebote an und ändert sie nicht, kümmert sich nicht um Moderation, Budgets oder Zahlungen und nutzt weder die Sandbox noch Wordstat.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Yandex Direct-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie liefen meine Kampagnen letzte Woche? Zeig Impressionen, Klicks, CTR, Kosten und Conversions pro Kampagne.“
• „Welche Suchanfragen haben in den letzten 30 Tagen am meisten gekostet, ohne eine einzige Conversion?“
• „Liste die Keywords der Kampagne Winterreifen mit ihren Geboten auf und sag mir, was für die oberen Positionen nötig wäre.“
• „Welche meiner Anzeigen sind abgelehnt oder werden gerade nicht ausgespielt, und warum?“
• „Wir sind eine Agentur: Liste unsere Kunden auf und zeig mir die Ausgaben von gestern für den Kunden romashka-shop.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden