MCP Salesforce-Connector

Eine Model Context Protocol (MCP)-Serverimplementierung für die Salesforce-Integration, die es LLMs ermöglicht, über SOQL-Abfragen und SOSL-Suchen mit Salesforce-Daten zu interagieren.

Funktionen

• Ausführen von SOQL-Abfragen (Salesforce Object Query Language)

• Durchführen von SOSL-Suchen (Salesforce Object Search Language)

• Abrufen von Metadaten für Salesforce-Objekte, einschließlich Feldnamen, Bezeichnungen und Typen

• Auflisten aller verfügbaren SObjects – Entdecken von Standard- und benutzerdefinierten Objekten

• Abrufen, Erstellen, Aktualisieren und Löschen von Datensätzen

• Ausführen von Tooling API-Anfragen

• Ausführen von Apex REST-Anfragen

• Durchführen direkter REST-API-Aufrufe an Salesforce

Related MCP server: Salesforce MCP Integration

Konfiguration

Model Context Protocol

Um diesen Server mit dem Model Context Protocol zu verwenden, müssen Sie ihn in Ihrer claude_desktop_config.json-Datei konfigurieren. Fügen Sie den folgenden Eintrag zum Abschnitt mcpServers hinzu:

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

Verfügbare Tools

Abfrage- und Such-Tools

• run_soql_query – Ausführen von SOQL-Abfragen gegen Salesforce

• run_sosl_search – Durchführen von SOSL-Suchen über Objekte hinweg

Metadaten-Tools

• get_object_fields – Abrufen von Feldmetadaten für bestimmte Objekte

• list_sobjects – Auflisten aller verfügbaren SObjects (Standard und benutzerdefiniert)

Einzeldatensatz-Operationen

• get_record – Abrufen eines bestimmten Datensatzes nach ID

• create_record – Erstellen eines neuen Datensatzes

• update_record – Aktualisieren eines bestehenden Datensatzes

• delete_record – Löschen eines Datensatzes

Massenoperationen

• bulk_create_records – Erstellen mehrerer Datensätze in einer einzigen Operation

• bulk_update_records – Aktualisieren mehrerer Datensätze (muss das Feld Id enthalten)

• bulk_delete_records – Löschen mehrerer Datensätze unter Verwendung von Datensatz-IDs

Erweiterte API-Tools

• tooling_execute – Ausführen von Tooling API-Anfragen

• apex_execute – Ausführen von Apex REST-Anfragen

• restful – Durchführen direkter REST-API-Aufrufe an Salesforce

Hinweis zu Salesforce-Authentifizierungsmethoden

Dieser Server unterstützt vier Authentifizierungsmethoden:

• OAuth (Empfohlen): Setzen Sie SALESFORCE_ACCESS_TOKEN und SALESFORCE_INSTANCE_URL als Umgebungsvariablen.

• Client Credentials: Setzen Sie SALESFORCE_CLIENT_ID und SALESFORCE_CLIENT_SECRET für den OAuth 2.0 Client Credentials-Flow. Dies ist nützlich für Server-zu-Server-Integrationen.

• Salesforce CLI (Standard-Org): Wenn keine OAuth-Umgebungsvariablen gesetzt sind, versucht der Server, die aktive Salesforce CLI-Standard-Org aus dem aktuellen Arbeitsbereich zu verwenden (via sf org display --json oder sfdx force:org:display --json). Optional kann SALESFORCE_CLI_TARGET_ORG gesetzt werden, um eine bestimmte Org anzusprechen.

• Benutzername/Passwort (Legacy): Wenn SALESFORCE_ACCESS_TOKEN und SALESFORCE_INSTANCE_URL nicht gesetzt sind, greift der Server auf SALESFORCE_USERNAME, SALESFORCE_PASSWORD und SALESFORCE_SECURITY_TOKEN zurück.

Umgebungskonfiguration

• SALESFORCE_DOMAIN (Optional): Auf test setzen, um eine Verbindung zu einer Salesforce-Sandbox-Umgebung herzustellen. Wenn nicht gesetzt oder leer gelassen, verbindet sich der Server mit der Produktionsumgebung.

• SALESFORCE_CLI_TARGET_ORG (Optional): Bei Verwendung der Salesforce CLI-Authentifizierungsmethode setzen Sie dies, um einen bestimmten Org-Alias oder Benutzernamen anstelle der Standard-Org anzusprechen.