Яндекс Директ MCP

Яндекс Директ MCP verbindet eine KI-Anwendung mit dem Werbekonto von Яндекс Директ. Fragen Sie in natürlicher Sprache, wohin das Werbebudget fließt, gleichen Sie Kampagnen, Anzeigen und Schlüsselphrasen ab und bereiten Sie dann Änderungen vor oder führen Sie sie durch, ohne zwischen den Bereichen des Kontos wechseln zu müssen. Die Verbindung beginnt direkt im Dialog: Sie müssen keinen Token im Voraus erstellen oder die Konfiguration bearbeiten.

• 44 Werkzeuge. Kampagnen, Gruppen, Anzeigen, Schlüsselphrasen, Gebote, Anpassungen, Erweiterungen, Statistiken, Kontostand, Verzeichnisse und Kontoverbindung direkt im Dialog.

• Zwei Verbindungsmöglichkeiten. Ein entfernter Server per URL erfordert kein manuelles Abrufen eines Tokens und liest nur Daten; ein lokaler über npx bietet vollen Zugriff auf das Konto.

• Verbindung im Chat. Яндекс öffnet die Anmeldeseite; nach dem Code aus dem Chat können Sie sofort mit der Werbung arbeiten, und der Zugriff wird automatisch verlängert.

• Geld in verständlicher Form. In praktischen Werkzeugen werden Budgets, Gebote und Kontostand in der Kontowährung angezeigt, nicht in Mikroeinheiten der API.

• Echte Werbung. Lokale Änderungen werden im Live-Konto angewendet und können den Verbrauch beeinflussen. Für die Arbeit in einer Testumgebung gibt es die Sandbox von Яндекс Директ.

Versuchen Sie es mit der ersten Nachricht:

Zeig mir die Kampagnen meines Kontos und die Ausgaben der letzten Woche nach Anzeigengruppen.

Server verbinden · Szenarien ansehen · Technische Dokumentation öffnen

In einer Minute die Arbeit sehen

Sie: Verbinde Яндекс Директ.

Assistent: Gibt einen Link zur Anmeldung bei Яндекс. Öffnen Sie ihn mit einem Konto, das Zugriff auf das gewünschte Werbekonto hat, bestätigen Sie den Zugriff und senden Sie den angezeigten Code.

Sie: Senden Sie den Code von der Яндекс-Seite.

Assistent: Verbindet Директ und zeigt das Konto. Ein Neustart der Anwendung ist nicht erforderlich.

Sie: Zeig mir die Kampagnen meines Kontos und die Ausgaben der letzten Woche nach Anzeigengruppen.

Assistent: Findet Kampagnen, erstellt einen Bericht nach Anzeigengruppen und zeigt die Ausgaben in der Kontowährung.

Related MCP server: Yandex Direct MCP Server

Inhalt

• Schnellstart

• Was kann man beauftragen

• Wie es funktioniert

• Was Daten ändern kann

• Verbindung und Einrichtung

• Daten und Telemetrie

• Einschränkungen

• Technische Dokumentation

• Support

Schnellstart

1. Wählen Sie eine Verbindungsmethode und fügen Sie den Server gemäß der Anleitung unten in die KI-Anwendung ein.

2. Öffnen Sie einen neuen Dialog und fragen Sie: „Zeig mir die Kampagnen meines Kontos und die Ausgaben der letzten Woche nach Anzeigengruppen“.

Analyse ohne eigenständiges Abrufen eines Tokens — per URL

Der entfernte Server https://mcp.askads.ru/mcp wird über eine Anwendung verbunden, die MCP per URL unterstützt. Melden Sie sich im Browser bei Яндекс an und bestätigen Sie den Zugriff: Der Token muss nicht in die Konfiguration übertragen werden. Diese Variante ist nur zum Lesen gedacht — für Statistiken, Audits und das Anzeigen von Objekten; sie ändert keine Werbeeinstellungen.

In Claude Code kann man ihn mit dem Befehl hinzufügen:

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

Nach der Verbindung öffnen Sie /mcp und führen die Autorisierung durch. In anderen Anwendungen, die HTTP MCP unterstützen, fügen Sie dieselbe URL über die Anwendungsoberfläche hinzu.

Voller Zugriff — lokal über npx

Für das Erstellen und Ändern von Objekten ist Node.js 20+ erforderlich. npx lädt den Server beim ersten Start herunter — eine separate Installation des Pakets ist nicht nötig. Einen Token im Voraus zu erhalten ist nicht erforderlich — die Verbindung beginnt direkt im Dialog:

1. Fügen Sie den Server in die KI-Anwendung ein — unten ist ein Beispiel für Codex geöffnet, die anderen Anwendungen sind in aufklappbaren Anleitungen zusammengefasst.

2. Schreiben Sie: „Verbinde Яндекс Директ“ — der Assistent führt Sie durch die Anmeldung bei Яндекс und zeigt das Konto.

Für CI- und Agenteninstallationen — fertiger Token und YANDEX_DIRECT_LOGIN, siehe Verbindung und Einrichtung.

Über die Anwendungsoberfläche:

1. Öffnen Sie Settings → Plugins → MCP servers.

2. Klicken Sie auf Add server.

3. Fügen Sie den Startbefehl npx -y mcp-yandex-direct@latest hinzu.

Über die Befehlszeile:

codex mcp add yandex-direct -- npx -y mcp-yandex-direct@latest

Überprüfen Sie die Verbindung:

codex mcp list

Offizielle Codex-Anleitung

claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest

Verbindung prüfen: claude mcp list.

Öffnen Sie Settings → Developer → Edit Config und fügen Sie in claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

Wenn der Bereich Developer nicht vorhanden ist, öffnen Sie die Datei manuell: macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, Windows — %APPDATA%\Claude\claude_desktop_config.json. Starten Sie Claude Desktop neu.

Öffnen Sie ~/.cursor/mcp.json, um den Server in allen Projekten zu verbinden, oder .cursor/mcp.json in einem bestimmten Projekt. Fügen Sie hinzu:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

Führen Sie in der Befehlspalette MCP: Open User Configuration aus. Fügen Sie in der geöffneten mcp.json den Server hinzu:

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

Nach dem Speichern führen Sie MCP: List Servers aus und starten Sie den Server aus der Liste.

Was kann man beauftragen

Prüfen, wie das Budget verbraucht wird

• „Welche Kampagnen haben in der letzten Woche am meisten ausgegeben?“

• „Welche Anzeigen erhalten Impressionen und Klicks, bringen aber keine Conversions?“

• „Vergleiche Ausgaben, CTR und durchschnittlichen Klickpreis nach Kampagnen für den Monat.“

• „Zeig mir den Kontostand und den Rest des täglichen API-Kontingents.“

Verbesserungspunkte finden

• „Welche Schlüsselphrasen verbrauchen Budget, bringen aber keine Klicks?“

• „Welche Gruppen und Anzeigen sind derzeit pausiert oder bestehen die Moderation nicht?“

• „Prüfe, welche Gebotsanpassungen für mobile Geräte aktiv sind.“

• „Welche Schnelllinks und Verfeinerungen hat diese Kampagne?“

Änderungen vorbereiten

• „Schlage neue Gebote für Phrasen mit hohem CTR vor und zeige die Änderungen vor der Anwendung.“

• „Prüfe, ob es in der Kampagne Minuswörter für dieses Thema gibt, und bereite eine Liste vor.“

• „Sammle Parameter für eine neue Textkampagne für Moskau: Budget, Gruppen, Schlüsselphrasen und Anzeigen.“

Eine explizite Aktion ausführen

• „Füge diese Schlüsselphrasen zur Gruppe 123 hinzu und setze das Gebot auf 45 ₽.“

• „Pausiere Anzeige 456.“

• „Sende die Seite mit dem Bild an die Anzeigenbibliothek.“

Wie es funktioniert

Werbung besteht normalerweise aus drei Ebenen: Kampagne → Anzeigengruppe → Anzeige. In der Gruppe befinden sich Schlüsselphrasen, Anzeigeneinstellungen und Gebotsanpassungen. Anzeigen können Schnelllinks, Verfeinerungen, Visitenkarten und Bilder haben.

Der Server hilft, diese Objekte gemeinsam zu betrachten: die Ausgaben der Kampagne mit der Statistik der Gruppen, Schlüsselphrasen und Anzeigen zu verknüpfen. Er kann neue Kampagnen und Anzeigen nur vom Texttyp erstellen. Kampagnen anderer Typen können gelesen, umbenannt, ihr Budget geändert, pausiert, archiviert und per Identifikator gelöscht werden.

Statistiken werden nicht sofort erstellt: get_statistics startet einen Bericht im Reports-Dienst und wartet auf dessen Fertigstellung. Große Listen durchläuft autoPaginate automatisch über die Ausgabeseiten.

Was Daten ändern kann

Der entfernte Server per URL liest nur Daten. Der lokale Server über npx kann ein Live-Werbekonto ändern:

Die Werkzeuge übermitteln der KI-Anwendung Lese-, Schreib- und potenziell unumkehrbare Aktionskennzeichnungen. Die Anwendung kann eine Bestätigung anzeigen, aber ihr Verhalten hängt vom Client ab. Ein direkter API-Aufruf führt ohne confirmWrite=true keine Schreiboperation aus; für Werbeänderungen ist eine explizite Anfrage erforderlich.

Verbindung und Einrichtung

Für die normale Nutzung ist kein Token im Voraus erforderlich:

1. Bitten Sie im Chat, Яндекс Директ zu verbinden.

2. Öffnen Sie den Link zu Яндекс OAuth mit einem Konto, das Zugriff auf das gewünschte Werbekonto hat.

3. Bestätigen Sie den Zugriff und senden Sie den angezeigten Code in den Chat. Das war's, Sie können mit der Werbung arbeiten: Der Client muss nicht neu gestartet werden, die Konfiguration muss auch nicht bearbeitet werden.

Danach lebt die Verbindung von selbst: Der Zugriff wird automatisch verlängert und fällt nicht nach einem Jahr aus. Den Status prüfen — bitten Sie „zeig den Verbindungsstatus“, deaktivieren — „deaktiviere Директ“. Der erteilte Zugriff wird in Яндекс ID widerrufen.

Für CI- und automatische Installationen, bei denen es keinen Dialog gibt, ist die Einrichtung über Umgebungsvariablen verfügbar:

Einen fertigen Token für YANDEX_DIRECT_TOKEN erhalten Sie über den Link, indem Sie sich mit einem Konto anmelden, das Zugriff auf das gewünschte Konto hat:

Token für Яндекс Директ erhalten

Veröffentlichen Sie das Token nicht in Chats, Repositories und Screenshots: Es gewährt Zugriff auf das Werbekonto, einschließlich Aktionen, die das Budget beeinflussen können.

Daten und Telemetrie

Standardmäßig sendet der Server anonyme technische Ereignisse: eine zufällige Installations-ID, den Namen des aufgerufenen Tools, die Versionen von Server, KI-Anwendung, Node.js und Betriebssystem. Dies dient dazu zu verstehen, welche Teile des Servers verwendet werden und ob beim Start Probleme auftreten. Das Yandex-Token, Daten des Werbekontos, Tool-Argumente, Anfragetexte, Werte und Namen von Umgebungsvariablen werden nicht gesendet.

Um die Telemetrie für Ask Ads MCP-Server zu deaktivieren, legen Sie die Umgebungsvariable fest:

ASKADS_TELEMETRY=0

Einschränkungen

• Tägliches API-Kontingent. Jeder Aufruf verbraucht Units. Das Tool get_quota zeigt an, wie viel verbraucht wurde, wie viel übrig ist und wie viel heute verfügbar ist.

• Berichtslimits. Yandex-Berichte haben eigene Beschränkungen für Umfang und Anzahl pro Tag, und die Fertigstellung eines Berichts im Reports-Dienst muss abgewartet werden.

• Große Listen. Wenn bei automatischer Paginierung die interne Grenze erreicht wird, markiert der Server das Ergebnis ausdrücklich als unvollständig, anstatt dies zu verbergen.

• Temporäre Fehler. Der Server unternimmt bis zu drei Wiederholungsversuche bei Ratenbegrenzungen. Netzwerk- und Serverfehler werden nur bei Lesevorgängen automatisch wiederholt, um keine Änderung zu duplizieren.

• Produktionskonto. Lokale Änderungen werden im echten Werbekonto angewendet und können den Verbrauch beeinflussen. Verwenden Sie für Tests die Sandbox (YANDEX_DIRECT_SANDBOX=true).

• Keine dauerhafte Überwachung. Der Server läuft während des Aufrufs aus der KI-Anwendung. Wenn die Anwendung regelmäßige Aufgaben unterstützt, kann eine periodische Abfrage zur Prüfung der gewünschten Kennzahlen eingerichtet werden.

Technische Dokumentation

• Katalog der MCP-Funktionen — Seiten zu Benutzeraufgaben für jedes Tool.

• Alle Tools — Parameter, Antworten und Grenzen jedes Tools.

• Entwicklung — Aufbau des Projekts und Arbeit mit dem Quellcode.

• Yandex Direct API — Primärquelle zu API und ihren Einschränkungen.

• npm-Paket — veröffentlichte Versionen des Servers.

Support

Einen Fehler gefunden oder ein Szenario fehlt? Erstellen Sie ein Issue oder schreiben Sie an Telegram.