Skip to main content

​
Übersicht

Nudgen stellt unter dem Endpunkt /mcp Ihrer App-Origin einen MCP-Server bereit. Er verwendet MCP 2026-07-28 über Streamable HTTP und erfordert OAuth 2.1. Verbinden Sie einen Client, der diesen Transport unterstützt. Melden Sie sich im Browser bei Nudgen an, wählen Sie einen Workspace und genehmigen Sie die vom Client angeforderten Berechtigungen. Ihre Verbindung bleibt an diesen Workspace gebunden, auch wenn Sie später im Dashboard den Workspace wechseln.

​
Warum das wichtig ist

Ihr Assistent kann Kontakte und Kampagnen lesen, Unternehmen in der Nähe finden, Inhalte entwerfen und eine Kampagne für den Start vorbereiten, ohne eine Dashboard-Sitzung oder ein persönliches Zugriffstoken zu verwenden. Jeden echten Versand und jede Planung prüfen Sie vor der Ausführung im Browser.

​
Client verbinden

Der Produktionsendpunkt lautet:
Fügen Sie ihn in einem Client mit OAuth-Unterstützung als Remote-HTTP-MCP-Server hinzu. Der Client ermittelt den Autorisierungsserver von Nudgen über den Endpunkt und öffnet einen Anmelde- und Zustimmungsablauf im Browser. Wählen Sie den Workspace aus, auf den der Client zugreifen soll, und genehmigen Sie nur die benötigten Bereiche. Discovery-Dokumente: Der Autorisierungsserver verwendet den Authorization Code Flow mit PKCE S256, Ressourcenbindung und Refresh-Token-Rotation. Er akzeptiert Client-ID-Metadatendokumente und die dynamische Clientregistrierung. Verwenden Sie für Codex CLI:
Wenn bereits ein Client namens nudgen konfiguriert ist, aktualisieren Sie diesen Eintrag mit der URL /mcp. Wenn Sie Daten nur prüfen möchten, fordern Sie campaigns:read an. Fügen Sie campaigns:write hinzu, wenn der Client Kontakte, Entwürfe, Markeneinstellungen oder importierte Leads ändern soll. Fügen Sie campaigns:send nur hinzu, wenn der Client eine Startfreigabe anfordern muss.
Persönliche Zugriffstoken authentifizieren die Entwickler-API, aber nicht /mcp. Ein MCP-Client muss die OAuth-Anmeldung abschließen.

​
Verfügbare Tools

create_campaign speichert eine Kampagne als Entwurf (one-time, drip oder lifetime). Das Tool kann sie nicht direkt versenden oder planen. Mit get_campaign können Sie vor dem Start Betreff, Inhalt, Link, Zielgruppe und Absender prüfen. Der Server stellt außerdem schreibgeschützte Ressourcen unter campaigns:read bereit:

​
Karten-Leads finden und importieren

  1. Bitten Sie den Assistenten, search_map_leads mit einem Standort und Suchbegriffen für Unternehmen aufzurufen, beispielsweise mit einer Stadt und marketing agency.
  2. Optionale Filter sind radiusKm (1–100), lat und lng sowie emailOnly, um nur Unternehmen zu behalten, die eine E-Mail-Adresse veröffentlichen.
  3. Wenn das Ergebnis nextPageToken enthält, übergeben Sie es als pageToken, um eine weitere Seite zu laden.
  4. Bitten Sie den Assistenten, import_map_leads mit demselben Standort und denselben Suchbegriffen sowie den zu speichernden Lead-Objekten aufzurufen. Jeder Aufruf akzeptiert bis zu 200 Leads.
Beim Import werden Kontakte im verbundenen Workspace gespeichert. Leads ohne E-Mail-Adresse werden übersprungen. Ein bereits vorhandener Lead wird aktualisiert.

​
Kampagnenstart genehmigen

  1. Bitten Sie den Assistenten, den Entwurf mit get_campaign zu prüfen.
  2. Bitten Sie ihn, prepare_campaign_launch mit der Kampagnen-ID und dem gewünschten exakten Zeitpunkt für den sofortigen oder geplanten Versand aufzurufen. Dadurch wird eine einmalig verwendbare Freigabe-URL zurückgegeben; es wird noch keine E-Mail versendet.
  3. Öffnen Sie die URL, prüfen Sie Workspace, geschätzte Empfängerzahl, Inhalt, Absender und Zeitpunkt und klicken Sie dann auf Start genehmigen.
  4. Kehren Sie zum Client zurück, damit er launch_campaign mit derselben Kampagnen-ID, demselben Zeitpunkt und derselben approvalId aufrufen kann.
Eine Freigabe läuft nach 10 Minuten ab und kann nur einmal verwendet werden. Wenn sich die Kampagne oder der Absender ändert, fordern Sie eine neue Freigabe an. Nudgen prüft beim Start erneut die Absenderbereitschaft, berechtigte Empfänger, Abonnement, Kontingent und Verfügbarkeit der Warteschlange. Die Zustellung beginnt erst, nachdem der Kampagnen-Worker den Start verarbeitet hat.
Wenn Sie launch_campaign genehmigen und abschließen, können echte E-Mails versendet werden. Verwenden Sie den Testversand im Dashboard, um eine Posteingangsvorschau zu prüfen, bevor Sie den Versand an eine echte Zielgruppe genehmigen.

​
Zugriff verwalten

Öffnen Sie Einstellungen → API-Schlüssel → Verbundene MCP-Apps, um für jeden verbundenen Client den Workspace und die Bereiche anzuzeigen. Widerrufen Sie dort eine Verbindung, wenn sie keinen Zugriff mehr haben soll. Durch den Widerruf werden ihre Token und ausstehenden Startfreigaben deaktiviert. Sie können die Verbindung später erneut über OAuth herstellen. OAuth-Berechtigungen gelten höchstens 90 Tage. Wenn Sie den Zugriff auf einen Workspace verlieren, kann der Client die Verbindung dieses Workspace ebenfalls nicht mehr verwenden.

​
Fehlerbehebung

Informationen zu Skripten mit Bearer-Token und direkten REST-Endpunkten finden Sie in der Entwickler-API.

​
Suchradius und Anreicherung

API- und MCP-Suchen verwenden standardmäßig 5 km und akzeptieren eine ganze Zahl radiusKm von 1 bis 100, ohne Dashboard-Bestätigung. Behalten Sie die Suchparameter bei, wenn Sie nextPageToken als pageToken übergeben. Auch eine leere Seite kann eine Folgeseite haben. enrichmentPending kennzeichnet noch laufende Website-Recherche. Prüfen Sie verfügbare businessSummary und businessSources. Importierter Geschäftskontext kann personalisierte Kampagneneinleitungen unterstützen. Eine fehlende E-Mail kann noch recherchiert werden. Bei enrichmentRetryToken rufen Sie retry_map_leads_enrichment mit token und campaigns:read auf. Der Token gilt für den verbundenen Workspace, läuft nach 15 Minuten ab und ist einmal verwendbar. Ergebnisse vor dem Import anhand von placeId zusammenführen. emailOnly filtert die aktuelle Antwort; weitere Leads können nach dem Wiederholen erscheinen.

​
Entwürfe bearbeiten und Funktionsumfang

Mit update_campaign bearbeitest du einen vorhandenen Entwurf; mit delete_campaign löschst du ihn. Beide benötigen campaigns:write und versenden oder planen keine E-Mails. Neue Funktionsbereiche benötigen eigene OAuth-Berechtigungen. Verbinde dich erneut und bestätige diese Berechtigungen, wenn du dazu aufgefordert wirst. Die Werkzeugliste zeigt verfügbare Werkzeuge und Argumente. Browser-Übergaben führen keine Aktion aus: Schließe Zahlungen, Anbieterautorisierung, Einladungsversand, Workspace-Wechsel und vertrauliche Auszahlungseinstellungen im Browser ab. Deine MCP-Verbindung bleibt an den autorisierten Workspace gebunden. Administration, Zugangsdaten, Webhooks, Tracking-Callbacks und der interne Assistent sind ausgeschlossen. Mit get_api_capabilities prüfst du die API-Abdeckung. Fordere für Testsendungen, Lifetime-Aktivierung oder Lifetime-Ereignisse zuerst mit prepare_campaign_action eine Browserfreigabe an. Rufe danach send_test_email, activate_lifetime_campaign oder trigger_lifetime_campaign mit denselben Argumenten auf. Die Freigabe gilt zehn Minuten und nur einmal.