Zum Hauptinhalt springen

Übersicht

Nudgen stellt unter /mcp Ihrer App-Origin einen MCP-Server bereit. Er unterstützt MCP 2026-07-28 über Streamable HTTP und benötigt OAuth 2.1. Melden Sie sich im Browser an und bestätigen Sie die angeforderten Berechtigungen. Wenn verfügbar, wählen Sie einen Workspace oder erlauben ausdrücklich den Zugriff auf alle aktuellen und zukünftigen Workspaces, denen Sie angehören. Ein Wechsel im Dashboard ändert den MCP-Standard nicht.

Mit mehreren Workspaces arbeiten

Bestehende Verbindungen bleiben auf ihren ursprünglichen Workspace beschränkt, bis Sie sich erneut verbinden und den erweiterten Zugriff bestätigen. Bei Zugriff auf alle Workspaces werden neue Mitgliedschaften automatisch verfügbar. Nach Ende einer Mitgliedschaft werden weitere Aktionen dort blockiert. Rollen, Abonnements und Kontingente gelten weiterhin pro Workspace. Mit list_workspaces, page und pageSize erhalten Sie IDs, Namen, Slugs, Rollen und den Standard-Workspace. Dafür ist teams:read erforderlich. Geben Sie bei einem Workspace-Werkzeug workspaceId an, um nur diesen Aufruf auf einen anderen Workspace zu richten. Ohne Angabe gilt der Verbindungsstandard. Verwenden Sie beim Prüfen und Versenden einer Kampagne dieselbe explizite Workspace-ID. Wählen Sie den Standard bei der OAuth-Zustimmung. Ändern Sie ihn unter Einstellungen → API-Schlüssel → Verbundene MCP-Apps oder mit set_default_workspace, workspaceId und teams:write. Die Änderung gilt für alle Chats mit dieser Verbindung. Ein einzelner Aufruf mit anderer ID ändert den Standard nicht. Ist der Standard gelöscht oder nicht mehr zugänglich, geben Sie eine andere ID an oder aktualisieren Sie den Standard. Nudgen wählt nie stillschweigend einen Ersatz.
Bestehende Ressourcen-URIs verwenden den Standard-Workspace. Diese Vorlagen wählen einen Workspace ausdrücklich:

Warum das wichtig ist

Ihr Assistent kann Kontakte prüfen, Unternehmen finden und Kampagnenentwürfe erstellen. Geben Sie Versand oder Planung im Chat frei. Der Assistent führt die Aktion direkt ohne Freigabelink im Browser aus.

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. Nutzen Sie campaigns:read zum Lesen, campaigns:write für Entwürfe und Änderungen und campaigns:send für freigegebene E-Mail-Aktionen. OAuth-Zustimmung bleibt erforderlich.
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.

Kampagnenentwurf starten

  1. Prüfen Sie Kampagnenname, Betreff, Inhalt, tatsächlichen Absender, geschätzte Empfängerzahl und Zeitpunkt mit get_campaign.
  2. Geben Sie die Aktion im Chat frei. Der Assistent ruft launch_campaign direkt mit Kampagnen-ID und entweder sendNow: true oder scheduledAt mit einem zukünftigen Zeitstempel und Zeitzone auf. Widersprüchliche Zeitangaben sind unzulässig. Eine vorhandene Freigabe braucht keine erneute Bestätigung.
  3. Prüfen Sie Status, geplanten Zeitpunkt und Dashboard-Link im Ergebnis. Eingereiht oder geplant bedeutet noch nicht zugestellt. Prüfen Sie bei unklarem Ergebnis vor einem erneuten Versuch get_campaign und get_campaign_stats.
Nudgen prüft weiterhin Workspace-Berechtigungen, Absenderbereitschaft, geeignete Empfänger, Abonnement, Kontingent, Kampagnenversion und Warteschlange. Erstellung und Bearbeitung speichern nur Entwürfe; der Versand benötigt den Kampagnen-Worker.

Zugriff verwalten

Unter Einstellungen → API-Schlüssel → Verbundene MCP-Apps können Sie Zugriffe prüfen, den Standard ändern oder die Verbindung trennen. Das Trennen einer Verbindung für mehrere Workspaces widerruft deren Tokens und ausstehende Autorisierungscodes für alle Workspaces. Separate REST-Verbindungen bleiben bestehen. REST OAuth und der Assistent in der App behalten ihre bisherigen Workspace-Grenzen.

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. Nutzen Sie den Browser für Zahlungen, Anbieterautorisierung, Einladungen, das Erstellen/Löschen/Beitreten von Workspaces und vertrauliche Auszahlungseinstellungen. MCP-Zielauswahl und Standardänderungen wechseln den Dashboard-Workspace nicht. Administration, Zugangsdaten, Webhooks, Tracking-Callbacks und der interne Assistent sind ausgeschlossen. Prüfen Sie mit get_api_capabilities die API-Abdeckung. Rufen Sie nach Freigabe im Chat send_test_email, activate_lifetime_campaign oder trigger_lifetime_campaign direkt auf. Tests gehen nur an die Konto-E-Mail. Lifetime-Aktivierung ermöglicht künftigen automatischen Versand. Browserfreigabe und Freigabe-ID entfallen. Prüfen Sie bei unklarem Ergebnis vor einem erneuten Versuch Status oder Ausführungsverlauf.