salesforce

Das salesforce-Plugin integriert die Salesforce CLI mit Claude Code, bietet Org-Authentifizierung und einen universellen CLI-Agenten, der beliebige sf-Befehle einschließlich SOQL-Abfragen ausführen kann. Es unterstützt Container-Umgebungen ohne Browser-Zugriff mit JWT-, Access-Token- und SFDX-URL-Authentifizierungsverfahren. Die folgende Gebrauchsanleitung zeigt, wie Sie natürliche Sprache verwenden können, um Konten, Opportunities, Fälle und Kontakte über den CLI-Agenten abzufragen.

v1.0.0 Development

Installation

/plugin install salesforce@f5-sales-demo-marketplace

Voraussetzungen

• Salesforce CLI (@salesforce/cli)
• Salesforce-Org mit API-Zugriff
• Ein Benutzerkonto mit Berechtigungen zur Abfrage von Objekten (Fälle, Opportunities, Konten, Kontakte)

Installieren Sie die Salesforce CLI auf Ihrer Workstation:

brew install sf

Überprüfen Sie die Installation:

sf --version

Sie sollten eine Ausgabe wie @salesforce/cli/2.x.x sehen.

Authentifizierungseinrichtung

Schritt 1: Ihre Salesforce-Domain finden

Schauen Sie sich Ihre Salesforce-URL im Browser an. Wenn Sie Salesforce unter https://acme.lightning.force.com aufrufen, lautet Ihre Login-Domain https://acme.my.salesforce.com.

Tipp

Wenn Ihr Unternehmen SSO verwendet, müssen Sie Ihre benutzerdefinierte Domain mit --instance-url angeben, damit der Login über Ihren SSO-Anbieter statt über die generische Salesforce-Anmeldeseite weitergeleitet wird.

Schritt 2: Authentifizierung über den Browser

sf org login web --alias my-org --set-default --instance-url https://YOUR-DOMAIN.my.salesforce.com

Ersetzen Sie YOUR-DOMAIN durch Ihre Unternehmens-Domain aus Schritt 1. Ihr Browser öffnet sich — schließen Sie den SSO- oder Login-Vorgang ab und autorisieren Sie die App. Sie sollten Folgendes sehen:

Successfully authorized your-email@company.com with org ID 00DXXXXXXXXXXXXXXX

Schritt 3: Die Verbindung überprüfen

sf org display --target-org my-org

Bestätigen Sie, dass die Ausgabe Connected Status: Connected mit Ihrem Benutzernamen und der Instanz-URL anzeigt.

Schritt 4: Portable Authentifizierung für Container (optional)

Wenn Sie sich in einer Umgebung ohne Browser-Zugriff authentifizieren müssen (CI/CD, Container, Remote-Sitzung), exportieren Sie die SFDX-Auth-URL von Ihrer Workstation:

sf org display --verbose --target-org my-org

Kopieren Sie den Wert der Sfdx Auth Url (beginnt mit force://). Führen Sie im Container Folgendes aus:

export SFDX_AUTH_URL="force://PlatformCLI::YOUR_AUTH_TOKEN@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

Achtung

Die SFDX-Auth-URL ist ein Zugangsdatum — behandeln Sie sie wie ein Passwort. Übertragen Sie sie nicht in Dateien und fügen Sie sie nicht in Chats ein. Verwenden Sie ausschließlich Umgebungsvariablen und stdin-Pipes.

Referenz der Authentifizierungsmethoden

Methode	Am besten geeignet für	Erfordert
Web-Login	Workstations mit Browser	Browser + SSO
SFDX-URL	Container, CI/CD, portable Authentifizierung	Auth-URL aus einer authentifizierten Sitzung
JWT Bearer	Automatisierte Pipelines	Connected App + privater Schlüssel + Consumer Key
Access Token	Authentifizierung über Umgebungsvariable	SF_ACCESS_TOKEN + SF_ORG_INSTANCE_URL

Hinweis: Der Gerätefluss (sf org login device) ist seit August 2025 gesperrt und wird nicht unterstützt.

Umgebungsvariablen

Variable	Zweck
SF_ACCESS_TOKEN	Bearer-Token für die Access-Token-Authentifizierung
SFDX_AUTH_URL	Force-Auth-URL für die SFDX-URL-Authentifizierung
SF_ORG_INSTANCE_URL	Org-Instanz-URL
SF_JWT_KEY_FILE	Pfad zum privaten JWT-Schlüssel
SF_CLIENT_ID	Consumer Key der Connected App
SF_USERNAME	Salesforce-Benutzername für JWT

Befehle

/salesforce:sf-status

Überprüfen Sie den Verbindungsstatus Ihrer Salesforce-Org, die CLI-Version und authentifizierte Orgs.

/salesforce:sf-status

Was Sie erwarten können: Eine Tabelle mit Ihrer sf-CLI-Version, dem authentifizierten Org-Alias, Benutzernamen, der Instanz-URL, dem Verbindungsstatus und der API-Version.

/salesforce:sf-login

Bei einer Salesforce-Org authentifizieren. Optional kann ein Alias angegeben werden.

/salesforce:sf-login
/salesforce:sf-login my-org

Was Sie erwarten können: Wenn eine Org mit diesem Alias bereits authentifiziert ist, werden die Verbindungsdetails gemeldet. Andernfalls wird nach verfügbaren Zugangsdaten (Umgebungsvariablen) gesucht und die Authentifizierung mit der ersten vollständig erfüllten Methode durchgeführt.

Skills

salesforce-index

Übergeordneter Intent-Router. Wird automatisch aktiviert, wenn Sie Salesforce, Org-Verwaltung oder Datenabfragen in natürlicher Sprache erwähnen.

Sie sagen	Weiterleitung an
„login to salesforce”, „authenticate org”	salesforce-auth-Skill
„check org status”, „list orgs”	cli-operator-Agent
„show me opportunities”, „look up case”	cli-operator-Agent (SOQL-Abfrage)
„generate Apex class”, „create Flow”	afv-library Entwicklungs-Skills

salesforce-auth

Container-angepasster Authentifizierungs-Skill. Unterstützt vier Authentifizierungsmethoden und erkennt automatisch, welche Zugangsdaten verfügbar sind. Priorität: Access-Token, dann JWT, dann SFDX-URL, dann Web-Login.

Agenten

cli-operator

Autonomer Salesforce-CLI-Agent, der sf-Befehle mit Sicherheitsschranken ausführt. Alle Salesforce-Operationen werden an diesen Agenten delegiert, um den Kontext der Hauptsitzung schlank zu halten.

Sicherheitsregeln:

• Standardmäßig nur lesend — Schreiboperationen erfordern ausdrückliche Genehmigung
• Kein Deployment ohne Vorschau und Bestätigungsschritt
• Gibt keine Access-Token, Auth-URLs oder Zugangsdaten in der Ausgabe aus
• Bereinigt alle vom Benutzer angegebenen Werte (lehnt Shell-Metazeichen ab)
• Verwendet --json-Ausgabe für strukturierte, parsierbare Ergebnisse

Antwortformat:

## Result: [SUCCESS | FAILURE | PARTIAL]
### Command Executed
### Output Summary
### Issues

Gebrauchsanleitung: Kontoverwaltung

Hinweis

Die nachfolgenden Eingabeaufforderungen sind keine fest codierten Funktionen des Plugins. Sie funktionieren, weil der cli-operator-Agent beliebige sf-CLI-Befehle ausführen kann, einschließlich beliebiger SOQL-Abfragen. Die Ergebnisse hängen vom Datenmodell Ihrer Org und Ihren Benutzerberechtigungen ab. Die hier aufgeführten Eingabeaufforderungen wurden getestet und für die Verwendung mit Standard-Salesforce-Objekten (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember) verifiziert.

Diese Eingabeaufforderungen funktionieren mit jeder Salesforce-Org. Ersetzen Sie die Platzhalterwerte durch Ihre eigenen Informationen. Jede Eingabeaufforderung liefert Ergebnisse, die spezifisch für Ihre Rolle, Konten und Ihr Gebiet sind.

Tipp

Für beste Ergebnisse geben Sie Ihre E-Mail-Adresse in Eingabeaufforderungen an, die Ihren Benutzerdatensatz identifizieren müssen. Salesforce-Orgs können mehrere Benutzer mit ähnlichen Namen haben.

Erste Schritte

Überprüfen Sie nach der Authentifizierung, ob alles funktioniert:

/salesforce:sf-status

Versuchen Sie dann eine einfache Abfrage in natürlicher Sprache:

list my authenticated salesforce orgs

Was Sie erwarten können: Eine Tabelle mit allen verbundenen Orgs mit Alias, Benutzername, Instanz-URL und Verbindungsstatus.

Ihre Konten finden

Ermitteln Sie, welchen Konten Sie im Account-Team zugewiesen sind:

what salesforce accounts am I on the account team for? My email is your-email@company.com

Was Sie erwarten können: Eine Liste der Konten, gruppiert nach Kontoinhaber, mit Ihrer Team-Mitglieder-Rolle für jedes Konto. Wenn die meisten Rollen leer erscheinen, ist das eine häufige Datenqualitätslücke — die Account-Team-Mitgliedschaften existieren, aber die Rollen wurden nicht befüllt.

Abdeckung mit einem Kollegen vergleichen

Vergleichen Sie Ihre Kontoabdeckung mit einem Teamkollegen, um Lücken zu finden:

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@company.com is also on the account team. Show me two lists: accounts where we are BOTH tagged, and accounts where only my colleague is tagged but I am missing.

Was Sie erwarten können: Eine Übersichtstabelle mit der Anzahl der Überschneidungen und Lücken, gefolgt von zwei Listen. Wenn Sie kürzlich die Rolle gewechselt haben, finden Sie möglicherweise keine Überschneidungen — dies zeigt, welchen Konten Sie hinzugefügt werden müssen.

Hinweis

Sie können auch nach einem Vorgänger suchen, indem Sie Folgendes hinzufügen: „Also check if Previous Person Name appears on any of those accounts.” Dies hilft, Übergabelücken beim Wechsel einer Person in einem Gebiet zu identifizieren.

Pipeline-Übersicht nach Gebiet

Zeigen Sie alle offenen Opportunities in Ihren Konten an:

show me all open salesforce opportunities on Colleague Name's account team accounts, sorted by close date, include the stage, amount, and probability

Was Sie erwarten können: Eine Zusammenfassung mit der Gesamtanzahl der Opportunities, der Brutto-Pipeline und der gewichteten Pipeline. Dann eine Tabelle zur Stufenverteilung und eine Liste der Top- Opportunities nach Betrag. Die Ausgabe kennzeichnet Datenqualitätsprobleme wie überfällige Abschlussdaten oder Null-Beträge.

Detailanalyse einer Opportunity

Erhalten Sie ein vollständiges Bild eines bestimmten Deals:

show me a detailed view of the OPPORTUNITY NAME opportunity in salesforce - include the opportunity team members, any activities or tasks, and the account contacts

Was Sie erwarten können: Die Opportunity-Übersicht (Stufe, Betrag, Abschlussdatum, Wahrscheinlichkeit, Prognosekategorie, Inhaber), Opportunity-Team-Mitglieder mit Rollen, zugeordnete Kontakte, aktuelle Aufgaben und Ereignisse sowie den Feldänderungsverlauf, der zeigt, wie sich der Deal-Betrag und das Abschlussdatum im Laufe der Zeit verändert haben.

Support-Fälle im Gebiet

Überprüfen Sie offene Support-Fälle in Ihren Konten:

show me all open salesforce cases across Colleague Name's account team accounts, grouped by account, sorted by most recent first

Was Sie erwarten können: Eine Anzahl offener Fälle mit Prioritäts- und Statusaufschlüsselung, dann Falldetails gruppiert nach Konto. Veraltete Fälle (Monate oder Jahre alt ohne Aktivität) werden als Datenqualitätskandidaten gekennzeichnet.

Quartalspipeline-Prognose

Erhalten Sie eine prognosetaugliche Ansicht Ihrer Pipeline:

for Colleague Name's accounts, show me a quarterly pipeline summary - group the open opportunities by close date quarter with count, total amount, and weighted amount for each quarter

Was Sie erwarten können: Eine Tabelle mit einer Zeile pro Quartal, die die Anzahl der Opportunities, die Gesamtpipeline und die gewichtete Pipeline anzeigt. Enthält eine Stufenmix-Aufschlüsselung pro Quartal und hebt die am höchsten gewichteten Deals hervor. Überfällige Opportunities werden separat gruppiert.

Vollständige Kontoübersicht

Detaillierte Analyse eines bestimmten Kunden:

give me a full account overview for ACCOUNT NAME in salesforce including contacts, open opportunities, and recent cases

Was Sie erwarten können: Unternehmensprofil (Branche, Umsatz, Mitarbeiterzahl, Standort), wichtige Kontakte mit Titeln und E-Mail, offene Opportunities mit Stufen und Beträgen sowie aktuelle Support-Fälle mit Status.

Fall-Suche

Einen bestimmten Support-Fall nach Nummer suchen:

look up salesforce case CASE-NUMBER and show me the case details, the customer account, and who owns it

Was Sie erwarten können: Fallbetreff, Status, Priorität, Beschreibung, das Kundenkontoprofil und der Fallinhaber mit Kontaktinformationen.

Gebrauchsanleitung: Datenabfragen

Für erfahrene Benutzer können Sie spezifische SOQL-ähnliche Abfragen in natürlicher Sprache anfordern. Das Plugin übersetzt Ihre Anfrage in die entsprechende SOQL und führt sie aus.

Bestimmte Felder

query salesforce for all Contacts at ACCOUNT NAME - show Name, Title, Email, Phone, and Department

Datumsfilterung

show me all salesforce opportunities that closed won in the last 90 days on ACCOUNT NAME

Aggregation

count all open salesforce cases grouped by priority and status across my accounts

Benutzerdefinierte Objekte

query the CUSTOM_OBJECT__c object in salesforce for records where Status__c = 'Active'

Tipp

Wenn eine Abfrage fehlschlägt, weil ein Feld nicht existiert, wiederholt das Plugin die Abfrage automatisch ohne dieses Feld. Benutzerdefinierte Felder in Ihrer Org können unterschiedliche Namen verwenden — überprüfen Sie Ihr Salesforce-Setup, wenn ein Feld nicht gefunden wird.

Entwicklungs-Skills

Die 30 Salesforce-Entwicklungs-Skills aus der forcedotcom/afv-library werden automatisch für Apex, Flow, LWC, SOQL, Metadaten, Agentforce und Deployment-Aufgaben aktiviert. Installieren Sie sie separat:

npx skills add forcedotcom/afv-library

Thema	Skill
Apex-Klassen und -Dienste	generating-apex
Apex-Tests	generating-apex-test
Flows	generating-flow
LWC- und UI-Bundles	building-ui-bundle-app
Benutzerdefinierte Objekte	generating-custom-object
Benutzerdefinierte Felder	generating-custom-field
Validierungsregeln	generating-validation-rule
Berechtigungssätze	generating-permission-set
FlexiPages	generating-flexipage
Agentforce-Agenten	developing-agentforce
Agentforce-Tests	testing-agentforce
Deployment	deploying-ui-bundle
SLDS2-Migration	uplifting-components-to-slds2
Trigger-Refactoring	trigger-refactor-pipeline