salesforce-marketing-mcp
salesforce-marketing-mcp
Ein produktionsreifer Model Context Protocol (MCP)-Server, der KI-Assistenten (Claude, Cursor usw.) direkten Zugriff auf Salesforce CRM-Daten ermöglicht. Entwickelt für Marketing-Ops, Revenue-Ops und B2B-Marketing-Teams, die KI-gestützten Zugriff auf Leads, Kontakte, Kampagnen, Kampagnenmitglieder, Aufgaben und 14 Reporting-Tools wünschen – alles ohne SOQL schreiben zu müssen.
Funktionen
Leads — Suchen, abrufen, erstellen, aktualisieren und konvertieren von Leads
Kontakte — Suchen, abrufen, erstellen, aktualisieren und nach E-Mail suchen
Accounts — Suchen, abrufen und Kontakte pro Account auflisten
Kampagnen — Kampagnen auflisten, abrufen, erstellen und aktualisieren
Kampagnenmitglieder — Mitglieder auflisten, Einzelpersonen hinzufügen, bis zu 200 Personen in Massen hinzufügen, Status aktualisieren
Aufgaben — Aufgaben erstellen; nach Lead, Kontakt oder Kampagne auflisten
Analytics-Berichte — Salesforce Analytics-Berichte auflisten, ausführen und beschreiben
Kampagnen-Analytics — ROI-Berechnung, Aufschlüsselung des Mitgliederstatus, Top-Kampagnen, Leistungstrends
Attribution — Aufschlüsselung der Lead-Quelle, Pipeline nach Kampagne, CampaignInfluence, gewonnener Umsatz nach Kampagne, Lead-Konvertierungsmetriken
Pipeline — Pipeline-Zusammenfassung, Pipeline nach Lead-Quelle, MQL-Trend, Prognosezusammenfassung
Aktivität — Aktivitätszusammenfassung nach Dimension, aktuelle Aktivitäten nach Lead oder Kontakt
Power-Tools — Rohes SOQL, SObject-Beschreibung, alle Objekte auflisten
Voraussetzungen
Eine Salesforce-Organisation (jede Edition mit API-Zugriff)
Ihr Salesforce-Benutzername, Passwort und Sicherheitstoken
So erhalten/zurücksetzen Sie Ihr Sicherheitstoken: Einstellungen > Persönliche Informationen > Mein Sicherheitstoken zurücksetzen
Node.js 20 oder höher
Keine Connected App oder OAuth-Einrichtung erforderlich.
Einrichtung
1. Installation
npm install -g salesforce-marketing-mcp
# or run directly with npx
npx salesforce-marketing-mcp2. Umgebungsvariablen
Variable | Erforderlich | Standard | Beschreibung |
| Ja | — | Salesforce-Anmelde-E-Mail |
| Ja | — | Salesforce-Passwort |
| Ja | — | Sicherheitstoken (wird bei der Anmeldung an das Passwort angehängt) |
| Nein |
| Verwenden Sie |
| Nein |
| Salesforce-API-Version |
Erstellen Sie eine .env-Datei oder setzen Sie diese in Ihrer Shell:
export SF_USERNAME="you@yourcompany.com"
export SF_PASSWORD="yourpassword"
export SF_SECURITY_TOKEN="yourtoken"
# For sandbox:
export SF_LOGIN_URL="https://test.salesforce.com"Verwendung
Claude Desktop
Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["salesforce-marketing-mcp"],
"env": {
"SF_USERNAME": "you@yourcompany.com",
"SF_PASSWORD": "yourpassword",
"SF_SECURITY_TOKEN": "yourtoken",
"SF_LOGIN_URL": "https://login.salesforce.com"
}
}
}
}Claude Code
claude mcp add salesforce-marketing-mcp \
-e SF_USERNAME=you@yourcompany.com \
-e SF_PASSWORD=yourpassword \
-e SF_SECURITY_TOKEN=yourtoken \
-- npx salesforce-marketing-mcpCursor
In .cursor/mcp.json:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["salesforce-marketing-mcp"],
"env": {
"SF_USERNAME": "you@yourcompany.com",
"SF_PASSWORD": "yourpassword",
"SF_SECURITY_TOKEN": "yourtoken"
}
}
}
}Tool-Referenz
Tool | Beschreibung |
| SOSL-Suche über Lead-Name, E-Mail und Unternehmen |
| Vollständiger Lead-Datensatz nach ID |
| Einen neuen Lead erstellen |
| Beliebige Lead-Felder aktualisieren |
| Lead in Account / Kontakt / Opportunity konvertieren |
| SOSL-Suche über Kontaktname und E-Mail |
| Vollständiger Kontaktdatensatz mit Account-Name |
| Einen neuen Kontakt erstellen |
| Beliebige Kontaktfelder aktualisieren |
| Kontakte nach E-Mail-Adresse finden (bis zu 10 Treffer) |
| SOSL-Suche nach Account-Name |
| Account-Datensatz mit Anzahl offener Opportunities und Leads |
| Mit einem Account verknüpfte Kontakte |
| Kampagnen mit optionalen Status-/Typ-/Aktiv-Filtern auflisten |
| Vollständiger Kampagnendatensatz mit allen Leistungskennzahlen |
| Eine neue Kampagne erstellen |
| Beliebige Kampagnenfelder aktualisieren |
| Kampagnenmitglieder mit Lead-/Kontakt-Details auflisten |
| Einen einzelnen Lead oder Kontakt zu einer Kampagne hinzufügen |
| Bis zu 200 Leads/Kontakte in einem Aufruf hinzufügen |
| Mitgliederstatus und HasResponded-Flag aktualisieren |
| Eine Aufgabe erstellen, die mit einem Lead, Kontakt oder einer Kampagne verknüpft ist |
| Mit einem Lead verknüpfte Aufgaben |
| Mit einem Kontakt verknüpfte Aufgaben |
| Mit einer Kampagne verknüpfte Aufgaben |
| Verfügbare Salesforce Analytics-Berichte auflisten |
| Einen Bericht ausführen und strukturierte Zeilen zurückgeben |
| Spaltendefinitionen und Gruppierungen für einen Bericht |
| ROI, CPL, CPO und Antwortrate pro Kampagne |
| Mitgliederstatus-Anzahl für eine Kampagne |
| Kampagnen nach Antworten, Opportunities oder gewonnenem Umsatz einstufen |
| Mitgliederzugänge im Zeitverlauf (Woche/Monat) |
| Lead-Volumen, Konvertierungen und Umsatz nach Lead-Quelle |
| Offene Pipeline, gruppiert nach Kampagne und Phase |
| CampaignInfluence-Datensätze, die Kampagnen mit Opportunities verknüpfen |
| Gewonnener Umsatz, gruppiert nach Primärkampagne |
| Konvertierungsraten nach Lead-Quelle oder Kampagne |
| Pipeline nach Phase: Anzahl, Betrag, Wahrscheinlichkeit, gewichtet |
| Pipeline, gruppiert nach Lead-Quelle |
| MQL-Volumen (oder ein beliebiger Status) im Zeitverlauf |
| Erwarteter Umsatz für Opportunities, die in einem Datumsbereich abgeschlossen werden |
| Aufgaben-/Ereignisanzahl nach Lead-Quelle, Kampagne oder Inhaber |
| Aufgaben und Ereignisse für einen bestimmten Lead |
| Aufgaben und Ereignisse für einen bestimmten Kontakt |
| Rohes SOQL ausführen (Notausgang für benutzerdefinierte Abfragen) |
| Vollständige Feld-Metadaten für jedes SObject |
| Alle abfragbaren SObjects mit optionalem Filter auflisten |
Beispiel-Prompts
Sobald die Verbindung hergestellt ist, stellen Sie Claude Fragen wie:
"Was sind meine Top 5 Kampagnen nach gewonnenem Umsatz in diesem Quartal?"
"Zeige mir die Aufschlüsselung der Lead-Quellen für die letzten 90 Tage – inklusive Konvertierungsraten."
"Erstelle eine Folgeaufgabe für Lead 00Q... fällig nächsten Freitag."
"Welche Kampagnen haben den höchsten ROI? Bitte Kosten pro Lead einbeziehen."
"Zeige mir den MQL-Trend nach Monat für dieses Jahr."
"Füge alle Leads aus dieser Liste zur Q2-Webinar-Kampagne mit dem Status 'Invited' hinzu."
"Wie sieht unsere aktuelle Pipeline-Zusammenfassung nach Phase mit gewichteten Werten aus?"
Funktionsweise
Authentifizierung: Verbindet sich über Salesforce-Benutzername + Passwort + Sicherheitstoken unter Verwendung von jsforce. Die Verbindung wird für 25 Minuten zwischengespeichert und bei
INVALID_SESSION_ID-Fehlern automatisch aktualisiert.Produktion und Sandbox: Setzen Sie
SF_LOGIN_URL=https://test.salesforce.com, um eine Sandbox anzusteuern.Ratenbegrenzungen: Alle Abfragen respektieren die Salesforce-API-Limits. Verwenden Sie
limit-Parameter, um die Ergebnisgrößen zu steuern.
Lizenz
MIT
Related MCP Connectors
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
Cloud MCP for project data, analytics, research, content planning, media generation, and growth.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/salesforce-marketing-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server