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

Related MCP server: MCP Salesforce Connector

Voraussetzungen

• Node.js (v14 oder höher)

• npm (Node-Paketmanager)

• Salesforce-Organisation mit API-Zugriff

• Salesforce-Anmeldeinformationen (Benutzername und Passwort)

Installation

1. Klonen Sie dieses Repository:

   git clone <repository-url>
   cd <repository-directory>

2. Installieren Sie Abhängigkeiten:

   npm install

3. 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:

1. Überprüfen Sie Ihre Salesforce-Anmeldeinformationen in der .env Datei

2. Überprüfen Sie, ob Ihre Salesforce-Organisation erreichbar ist

3. Stellen Sie sicher, dass Ihre IP-Adresse in Salesforce auf der Whitelist steht (falls erforderlich).

4. Überprüfen Sie, ob Ihr Salesforce-Benutzer über API-Zugriff verfügt

Abfragefehler

Wenn Ihre SOQL-Abfragen fehlschlagen:

1. Überprüfen der SOQL-Syntax

2. Überprüfen Sie, ob die Objekte und Felder in Ihrer Organisation vorhanden sind

3. 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.