salesforce

salesforce プラグインは、Salesforce CLI を Claude Code と統合し、組織認証と、SOQLクエリを含む任意の sf コマンドを実行できる汎用CLIエージェントを提供します。 JWT、アクセストークン、SFDX URLの認証フローによるヘッドレスコンテナ環境をサポートします。以下の使用ガイドでは、CLIエージェントを通じて自然言語でアカウント、商談、ケース、コンタクトをクエリする方法を説明します。

v1.0.0 Development

インストール

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

前提条件

Salesforce CLI (@salesforce/cli)
Salesforce組織（APIアクセス権限付き）
オブジェクト（ケース、商談、アカウント、コンタクト）をクエリする権限を持つユーザーアカウント

ワークステーションにSalesforce CLIをインストールします：

brew install sf

インストールを確認します：

sf --version

@salesforce/cli/2.x.x のような出力が表示されるはずです。

認証のセットアップ

ステップ1: Salesforceドメインを確認する

ブラウザでSalesforceのURLを確認してください。https://acme.lightning.force.com でSalesforceにアクセスしている場合、ログインドメインは https://acme.my.salesforce.com です。

ステップ2: ブラウザで認証する

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

YOUR-DOMAIN をステップ1の会社ドメインに置き換えてください。ブラウザが開きます — SSOまたはログインフローを完了してアプリを承認してください。次のように表示されるはずです：

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

ステップ3: 接続を確認する

sf org display --target-org my-org

出力に Connected Status: Connected とユーザー名およびインスタンスURLが表示されていることを確認してください。

ステップ4: コンテナ用のポータブル認証（オプション）

ヘッドレス環境（CI/CD、コンテナ、リモートセッション）で認証が必要な場合は、ワークステーションからSFDX認証URLをエクスポートします：

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

Sfdx Auth Url の値（force:// で始まる）をコピーします。コンテナ内で次を実行します：

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

認証方法のリファレンス

方法	最適な用途	必要なもの
Webログイン	ブラウザを持つワークステーション	ブラウザ + SSO
SFDX URL	コンテナ、CI/CD、ポータブル認証	認証済みセッションからの認証URL
JWTベアラー	自動化パイプライン	コネクテッドアプリ + 秘密鍵 + コンシューマーキー
アクセストークン	環境変数認証	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

注記: デバイスフロー（sf org login device）は2025年8月以降ブロックされており、サポートされていません。

環境変数

変数	目的
`SF_ACCESS_TOKEN`	アクセストークン認証用のベアラートークン
`SFDX_AUTH_URL`	SFDX URL認証用のForce認証URL
`SF_ORG_INSTANCE_URL`	組織インスタンスURL
`SF_JWT_KEY_FILE`	JWT秘密鍵へのパス
`SF_CLIENT_ID`	コネクテッドアプリのコンシューマーキー
`SF_USERNAME`	JWT用のSalesforceユーザー名

コマンド

/salesforce:sf-status

Salesforce組織の接続ステータス、CLIバージョン、および認証済み組織を確認します。

/salesforce:sf-status

期待される結果: sf CLIバージョン、認証済み組織エイリアス、ユーザー名、インスタンスURL、接続ステータス、およびAPIバージョンを示すテーブルが表示されます。

/salesforce:sf-login

Salesforce組織に認証します。オプションでエイリアスを指定できます。

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

期待される結果: そのエイリアスを持つ組織がすでに認証されている場合は接続詳細を報告します。認証されていない場合は、利用可能なクレデンシャル（環境変数）を確認し、最初に完全に満たされる方法を使用して認証します。

スキル

salesforce-index

トップレベルのインテントルーター。Salesforce、組織管理、またはデータクエリについて自然言語で言及すると自動的に起動します。

発言内容	ルーティング先
”login to salesforce”, “authenticate org”	`salesforce-auth` スキル
”check org status”, “list orgs”	`cli-operator` エージェント
”show me opportunities”, “look up case”	`cli-operator` エージェント（SOQLクエリ）
“generate Apex class”, “create Flow”	afv-library 開発スキル

salesforce-auth

コンテナ対応の認証スキル。4つの認証方法をサポートし、利用可能なクレデンシャルを自動的に検出します。優先順位は次の通りです：アクセストークン、JWT、SFDX URL、Webログイン。

エージェント

cli-operator

安全ガードレール付きで sf コマンドを実行する自律型Salesforce CLIエージェント。すべてのSalesforce操作はこのエージェントに委任され、メインセッションのコンテキストを軽量に保ちます。

安全ルール:

デフォルトで読み取り専用 — 書き込み操作には明示的な承認が必要
プレビューと確認ステップなしではデプロイしない
アクセストークン、認証URL、またはクレデンシャルを出力にエコーしない
ユーザー提供のすべての値をサニタイズする（シェルメタキャラクターを拒否）
構造化された解析可能な結果のために --json 出力を使用する

レスポンス形式:

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

使用ガイド: アカウント管理

これらのプロンプトはどのSalesforce組織でも機能します。プレースホルダーの値をご自身の情報に置き換えてください。各プロンプトは、あなたの役割、アカウント、テリトリーに固有の結果を生成します。

はじめに

認証後、すべてが正常に機能することを確認します：

/salesforce:sf-status

次に、シンプルな自然言語クエリを試してみます：

list my authenticated salesforce orgs

期待される結果: エイリアス、ユーザー名、インスタンスURL、および接続ステータスを含むすべての接続済み組織を示すテーブルが表示されます。

アカウントを検索する

自分が割り当てられているアカウントを確認します：

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

期待される結果: アカウントオーナー別にグループ化されたアカウントのリストが表示され、各アカウントでのチームメンバーの役割が示されます。ほとんどの役割が空の場合は、よくあるデータ品質の問題です — アカウントチームメンバーシップは存在しますが、役割が入力されていません。

同僚とのカバレッジの相互参照

チームメートとのアカウントカバレッジを比較してギャップを見つけます：

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.

期待される結果: 重複数とギャップ数を示すサマリーテーブルと、2つのリストが表示されます。最近役割が変わった場合は、重複がゼロになる可能性があります — これにより、追加が必要なアカウントが明らかになります。

テリトリーパイプラインの概要

アカウント全体のすべてのオープン商談を確認します：

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

期待される結果: 商談の総数、生のパイプライン、および加重パイプラインを含むサマリーが表示されます。次にステージ分布テーブルと、金額別のトップ商談のリストが表示されます。出力は、期日超過のクローズ日や金額がnullといったデータ品質の問題にフラグを立てます。

商談の詳細調査

特定の案件の全体像を把握します：

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

期待される結果: 商談の概要（ステージ、金額、クローズ日、確率、予測カテゴリ、オーナー）、役割付きの商談チームメンバー、タグ付けされたコンタクト、最近のタスクとイベント、および案件の金額とクローズ日がどのように変化したかを示すフィールド変更履歴が表示されます。

テリトリー全体のサポートケース

アカウントのオープンサポートケースを確認します：

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

期待される結果: 優先度とステータスの内訳を含むオープンケース数が表示され、次にアカウント別にグループ化されたケースの詳細が表示されます。アクティビティのない古いケース（数ヶ月または数年前）はデータ品質の候補としてフラグが立てられます。

四半期パイプライン予測

パイプラインの予測対応ビューを取得します：

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

期待される結果: 商談数、パイプライン合計、および加重パイプラインを示す四半期ごとの行を含むテーブルが表示されます。四半期ごとのステージ構成の内訳と、加重上位の商談がハイライトされます。期日超過の商談は別にグループ化されます。

アカウントの完全な概要

特定の顧客を詳細に調査します：

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

期待される結果: 会社プロファイル（業種、収益、従業員数、所在地）、役職とメールを含む主要コンタクト、ステージと金額を含むオープン商談、および最近のサポートケースとステータスが表示されます。

ケースの検索

ケース番号で特定のサポートケースを検索します：

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

期待される結果: ケースの件名、ステータス、優先度、説明、顧客アカウントプロファイル、および連絡先情報を含むケースオーナーが表示されます。

使用ガイド: データクエリ

パワーユーザーには、自然言語で特定のSOQLスタイルのクエリを要求することができます。プラグインはリクエストを適切なSOQLに変換して実行します。

特定のフィールド

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

日付フィルタリング

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

集計

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

カスタムオブジェクト

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

開発スキル

forcedotcom/afv-library の 30のSalesforce開発スキルは、Apex、Flow、LWC、SOQL、メタデータ、Agentforce、およびデプロイメントタスクに対して自動的に起動します。別途インストールします：

npx skills add forcedotcom/afv-library

トピック	スキル
Apexクラスとサービス	`generating-apex`
Apexテスト	`generating-apex-test`
フロー	`generating-flow`
LWCおよびUIバンドル	`building-ui-bundle-app`
カスタムオブジェクト	`generating-custom-object`
カスタムフィールド	`generating-custom-field`
入力規則	`generating-validation-rule`
権限セット	`generating-permission-set`
FlexiPage	`generating-flexipage`
Agentforceエージェント	`developing-agentforce`
Agentforceテスト	`testing-agentforce`
デプロイメント	`deploying-ui-bundle`
SLDS2移行	`uplifting-components-to-slds2`
トリガーリファクタリング	`trigger-refactor-pipeline`