simple-salesforce-mcp

Ein leichtgewichtiger Salesforce-MCP-Server. Er spricht direkt über stdio mit der Salesforce-REST-API und hat nur zwei Laufzeitabhängigkeiten (mcp, httpx) – gebaut als schneller Kaltstart-Ersatz für den offiziellen @salesforce/mcp-DX-Server, dessen Abhängigkeitsbaum für Sandbox-Umgebungen zu schwer ist.

Tools

Jedes Tool trägt MCP-Annotationen (readOnlyHint / destructiveHint / idempotentHint). update_record und delete_record verweigern die Aktion, es sei denn, der Aufruf enthält confirm: true, und die Verweigerungsmeldung weist das Modell an, dem Benutzer die genaue Änderung zu präsentieren und zuerst die Genehmigung einzuholen. SOQL selbst kann keine Daten ändern, daher bleibt der Notausgang schreibgeschützt.

Related MCP server: Salesforce MCP Server

Authentifizierung

Der Server führt selbst keinen OAuth-Flow durch; er konsumiert ein vorhandenes Zugriffstoken, das bei jedem Tool-Aufruf aufgelöst wird (so kann ein externer Prozess das Token jederzeit rotieren):

1. Salesforce-CLI-Authentifizierungsspeicher unter $HOME:

   • ~/.sf/config.json → {"target-org": "<username>"} (oder veraltet ~/.sfdx/sfdx-config.json → {"defaultusername": ...})

   • ~/.sfdx/<username>.json → {"accessToken": "...", "instanceUrl": "https://..."}

   Dies ist die Form, die sf org login schreibt, und die Form, die die JustParent-Plattform in Sandboxes materialisiert (wobei die Plattform das Zugriffstoken vor jedem Aufruf aktualisiert). Refresh-Tokens und Client-Secrets in diesen Dateien werden ignoriert – nie in den Speicher gelesen, gespeichert oder protokolliert.

2. Umgebungsvariablen (Fallback, für lokale/standalone Nutzung): SALESFORCE_ACCESS_TOKEN und SALESFORCE_INSTANCE_URL.

Bei einem abgelehnten Token (HTTP 401 / INVALID_SESSION_ID) liest der Server den Authentifizierungsspeicher einmal neu und versucht es erneut, dann meldet er, dass die Verbindung neu hergestellt werden muss.

Die REST-API-Version ist standardmäßig 62.0; überschreibbar mit SALESFORCE_API_VERSION.

Ausführen

# Standalone with env vars (get a token via: sf org display --json)
SALESFORCE_ACCESS_TOKEN=... \
SALESFORCE_INSTANCE_URL=https://yourorg.my.salesforce.com \
uvx --from git+https://github.com/JustParent/simple-salesforce-mcp simple-salesforce-mcp

Claude-Desktop-/generische-MCP-Client-Konfiguration:

{
  "mcpServers": {
    "salesforce": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/JustParent/simple-salesforce-mcp", "simple-salesforce-mcp"],
      "env": {
        "SALESFORCE_ACCESS_TOKEN": "...",
        "SALESFORCE_INSTANCE_URL": "https://yourorg.my.salesforce.com"
      }
    }
  }
}

Smoke-Test (ohne Netzwerk, gibt Version, Anmeldeinformationen-Status und Tools aus; beendet mit 0):

uvx --from . simple-salesforce-mcp --test

Entwicklung

uv run pytest                    # unit tests, no network needed
uv run ruff check .              # lint
uv run ruff format .             # format (--check to verify only)
uv run mypy                      # type check (src and tests)
uv run simple-salesforce-mcp --test
npx @modelcontextprotocol/inspector uv run simple-salesforce-mcp   # interactive

CI (.github/workflows/tests.yml) läuft bei jedem Push und Pull-Request: die Testsuite auf Python 3.10–3.13, ruff-Lint- und Format-Checks plus mypy, sowie ein Packaging-Job, der das Paket so installiert, wie es Sandboxes tun (uvx --from .), um Packaging-Brüche zu erkennen.

Sicherheitshinweise

• Nur Zugriffstoken: Der Server fordert, liest oder speichert niemals Refresh-Tokens.

• Destruktive Operationen (update/delete) sind hinter einem expliziten confirm=true-Argument mit modellseitiger Anleitung zur vorherigen Benutzerfreigabe abgesichert.

• SOQL-Paginierungs-Cursor (next_url) werden als /services/data/...-Pfade validiert, und Objekt-/Datensatz-Identifikatoren werden validiert, bevor sie in URLs eingefügt werden.

• Antworten sind größenbegrenzt mit expliziten Kürzungshinweisen.