Salesforce MCPサーバー

セットアップ

uv venv .venv
uv pip install --python .venv/bin/python -e .

設定

認証用の環境変数を設定します：

ユーザー名/パスワード (デフォルト):

SALESFORCE_USERNAME=your-username
SALESFORCE_PASSWORD=your-password
SALESFORCE_SECURITY_TOKEN=your-token
SALESFORCE_DOMAIN=login          # or "test" for sandbox

注: 新しいSalesforce組織では、SOAP APIログインはデフォルトで無効になっています。有効にするには：
設定 → クイック検索 → ユーザーインターフェース に移動します
API設定 の下にある SOAP API login() を有効にする にチェックを入れます
保存をクリックします

OAuth (代替手段、エンタープライズ向けに推奨):

SALESFORCE_ACCESS_TOKEN=your-token
SALESFORCE_INSTANCE_URL=https://your-instance.salesforce.com

アクセスモード

SALESFORCE_ACCESS_MODE を設定して、利用可能なツールを制御します：

値	利用可能なツール	ユースケース
`read`	list_objects, describe_object, run_soql_query, run_sosl_search, get_record, get_report_metadata, get_report_type_fields	安全な探索、レポート作成、読み取り専用の統合
`read_write`	すべての読み取りツール + create_record, update_record	日常的なCRM操作
`all` (デフォルト)	delete_record, tooling_execute, apex_execute, restful を含むすべてのツール	完全なAPIアクセス

推奨されるセキュリティレベル

環境	推奨モード	根拠
本番環境 (エンドユーザー)	`read`	誤ったデータ変更を防止
本番環境 (信頼された運用者)	`read_write`	CRMデータ入力を許可し、削除と生のAPIをブロック
サンドボックス / 開発	`all`	テストおよび開発のためのフルアクセス
デモ / 探索	`read`	組織構造とデータの探索に安全

環境変数またはMCPサーバー設定で設定します：

SALESFORCE_ACCESS_MODE=read

ヒント: MintMCP でこのサーバーを使用する場合、環境変数を使用する代わりに、MintMCPで直接ツールごとの詳細な権限を設定できます。これにより、サーバーを再起動することなく、よりきめ細かい制御（例：作成は許可するが更新は許可しないなど）が可能になります。

アクセスモード別のツール権限

MCPツールのアノテーション (readOnlyHint, destructiveHint) は各ツールに設定されているため、MCPクライアントは追加のポリシーを強制できます：

ツール	アクセスモード	readOnlyHint	destructiveHint	openWorldHint
`list_objects`	read	true	—	—
`describe_object`	read	true	—	—
`run_soql_query`	read	true	—	—
`run_sosl_search`	read	true	—	—
`get_record`	read	true	—	—
`get_report_metadata`	read	true	—	—
`get_report_type_fields`	read	true	—	—
`create_record`	read_write	false	—	—
`update_record`	read_write	false	—	—
`delete_record`	all	false	true	—
`tooling_execute`	all	false	—	true
`apex_execute`	all	false	—	true
`restful`	all	false	—	true

実行

.venv/bin/python -m salesforce_mcp

ツール

ツール	説明
`list_objects`	組織内のすべてのSalesforceオブジェクトを一覧表示 (オプションの検索フィルター付き)
`describe_object`	オブジェクトの項目、リレーション、選択リスト値、レコードタイプを取得
`run_soql_query`	SOQLクエリを実行
`run_sosl_search`	SOSLによるオブジェクト横断的な全文検索
`get_record`	IDで単一のレコードを取得
`get_report_metadata`	レポートの詳細メタデータ（列、フィルター、グループ化、レポートタイプ）を取得
`get_report_type_fields`	レポートタイプの項目カタログを掘り下げる — カテゴリを一覧表示、または1つのカテゴリの項目を取得
`create_record`	新しいレコードを作成
`update_record`	既存のレコードの項目を更新
`delete_record`	レコードを完全に削除
`tooling_execute`	Salesforce Tooling API (メタデータ、Apexクラス、カスタム項目)
`apex_execute`	カスタムApex RESTエンドポイントを呼び出し
`restful`	汎用的なSalesforce REST API呼び出し