Salesforce MCP-Integration

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server für die Salesforce-Integration, der es Ihnen ermöglicht, SOQL-Abfragen auszuführen, Metadaten abzurufen und über eine standardisierte Schnittstelle mit Salesforce-Daten zu interagieren.

Merkmale

Herstellen einer Verbindung mit Salesforce-Organisationen mithilfe von Umgebungsvariablen
Führen Sie SOQL-Abfragen für Salesforce-Daten aus
Abrufen und Verarbeiten von Salesforce-Datensätzen und Metadaten
Auflisten und Verwalten von Salesforce Flows
Sichere Anmeldeinformationsverwaltung mithilfe von Umgebungsvariablen

Voraussetzungen

Node.js (v14 oder höher)
npm (Node-Paketmanager)
Salesforce-Organisation mit API-Zugriff
Salesforce-Anmeldeinformationen (Benutzername und Passwort)

Installation

Klonen Sie dieses Repository:
git clone <repository-url> cd <repository-directory>
Installieren Sie Abhängigkeiten:
npm install
Erstellen Sie im Stammverzeichnis eine .env Datei mit Ihren Salesforce-Anmeldeinformationen und der API-Version:
SF_LOGIN_URL=https://your-instance.salesforce.com/ SF_USERNAME=your_username SF_PASSWORD=your_password SF_API_VERSION=58.0
- Verwenden Sie für Sandbox-Umgebungen https://test.salesforce.com/ als Anmelde-URL.
- Die Variable SF_API_VERSION steuert die von der Integration verwendete Salesforce-API-Version. Aktualisieren Sie sie bei Bedarf für Ihre Organisation.

Verwendung

Starten des MCP-Servers

Führen Sie den Server mit Node.js aus:

node server.js

Der Server stellt mithilfe der Anmeldeinformationen in Ihrer .env Datei eine Verbindung zu Salesforce her und beginnt, auf MCP-Anfragen zu warten.

Ausführen von SOQL-Abfragen

Sobald der Server läuft, können Sie SOQL-Abfragen über die MCP-Schnittstelle ausführen. Der Server stellt ein soqlQuery Tool bereit, das SOQL-Abfragen entgegennimmt und die Ergebnisse zurückgibt.

Beispiel einer SOQL-Abfrage:

SELECT Id, Name, Status FROM Account LIMIT 5

Auflisten von Salesforce-Flows

Sie können alle Flows in Ihrer Salesforce-Organisation mithilfe des Tools retrieveMetadata mit dem Metadatentyp Flow auflisten. Dadurch werden alle verfügbaren Flows und deren Metadaten zurückgegeben.

Konfigurieren von mcpServers im Cursor

Um diesen Salesforce MCP-Server mit Cursor zu verwenden, fügen Sie Ihrer mcp.json Datei in Cursor die folgende Konfiguration hinzu:

"mcpServers": {
  "mcp-salesforce": {
    "command": "node /absolute/path/to/your/project/root/server.js",
    "transport": "stdio",
    "args": []
  }
}

Ersetzen Sie /absolute/path/to/your/project/root/server.js durch den absoluten Pfad zu Ihrer Datei server.js .
Stellen Sie sicher, dass der Server aus dem richtigen Verzeichnis gestartet wird, damit er die .env Datei und Abhängigkeiten finden kann.

Nachdem Sie diese Konfiguration zu Ihrer mcp.json hinzugefügt haben, können Sie von Cursor aus eine Verbindung zum Salesforce MCP-Server herstellen und alle verfügbaren Tools verwenden.

Projektstruktur

server.js – Implementierung des Haupt-MCP-Servers und Einrichtung der Salesforce-Verbindung
tools.js – Alle MCP-Tooldefinitionen (SOQL, Metadaten, Flows usw.)
.env – Umgebungsvariablen für Salesforce-Anmeldeinformationen und API-Version
package.json – Projektabhängigkeiten und Skripte

Sicherheitsüberlegungen

Übergeben Sie Ihre .env Datei niemals der Versionskontrolle
Fügen Sie .env zu Ihrer .gitignore Datei hinzu
Verwenden Sie Umgebungsvariablen für alle vertraulichen Informationen
Erwägen Sie die Verwendung einer sichereren Authentifizierungsmethode für Produktionsumgebungen

Fehlerbehebung

Verbindungsprobleme

Wenn Verbindungsprobleme auftreten:

Überprüfen Sie Ihre Salesforce-Anmeldeinformationen in der .env Datei
Überprüfen Sie, ob Ihre Salesforce-Organisation erreichbar ist
Stellen Sie sicher, dass Ihre IP-Adresse in Salesforce auf der Whitelist steht (falls erforderlich).
Überprüfen Sie, ob Ihr Salesforce-Benutzer über API-Zugriff verfügt

Abfragefehler

Wenn Ihre SOQL-Abfragen fehlschlagen:

Überprüfen der SOQL-Syntax
Überprüfen Sie, ob die Objekte und Felder in Ihrer Organisation vorhanden sind
Stellen Sie sicher, dass Ihr Benutzer über die Berechtigung zum Zugriff auf die Objekte und Felder verfügt

Lizenz

MIT-Lizenz

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein Model Context Protocol-Server, der die Ausführung von SOQL-Abfragen und die Interaktion mit Salesforce-Daten über eine standardisierte Schnittstelle ermöglicht.

Related MCP Servers

salesforce-mcp-server
kablewy
A
security
F
license
A
quality
A Model Context Protocol server implementation for interacting with Salesforce through its REST API.
Last updated -
4
10
TypeScript
MySQL-MCP
zajTools
-
security
F
license
-
quality
A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
Last updated -
JavaScript
Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MSSQL MCP Server
knight0zh
-
security
A
license
-
quality
A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
Last updated -
3
TypeScript
MIT License

View all related MCP servers

Salesforce MCP Integration