simple-salesforce-mcp

軽量なSalesforce MCPサーバー。stdio経由でSalesforce REST APIと直接通信し、ランタイム依存関係は2つ（mcp、httpx）のみです。依存関係ツリーがサンドボックス環境には重すぎる公式の@salesforce/mcp DXサーバーに代わる、コールドスタートが高速な代替として構築されました。

ツール

すべてのツールにはMCPアノテーション（readOnlyHint / destructiveHint / idempotentHint）が付いています。update_recordとdelete_recordは、呼び出しにconfirm: trueが含まれない限り動作を拒否し、拒否メッセージはモデルに対して、正確な変更内容をユーザーに提示して先に承認を得るよう指示します。SOQL自体はデータを変更できないため、エスケープ ハッチは読み取り専用のままです。

Related MCP server: Salesforce MCP Server

認証

サーバー自体はOAuthフローを実行せず、既存のアクセス トークンを使用します。トークンはツール呼び出しのたびに解決されるため、外部プロセスがいつでもトークンをローテーションできます：

1. Salesforce CLI認証ストア（$HOME配下）：

   • ~/.sf/config.json → {"target-org": "<username>"}（またはレガシーの~/.sfdx/sfdx-config.json → {"defaultusername": ...}）

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

   これはsf org loginが書き込む形式であり、JustParentプラットフォームがサンドボックスに実体化する形式です（プラットフォームは各呼び出しの前にアクセス トークンを更新します）。これらのファイル内のリフレッシュ トークンとクライアント シークレットは無視されます。メモリに読み込まれることも、保存されることも、ログに記録されることもありません。

2. 環境変数（ローカル/スタンドアロン使用時のフォールバック）： SALESFORCE_ACCESS_TOKENとSALESFORCE_INSTANCE_URL。

トークンが拒否された場合（HTTP 401 / INVALID_SESSION_ID）、サーバーは認証ストアを一度再読み込みして再試行し、その後、接続を再確立する必要があることを報告します。

REST APIバージョンはデフォルトで62.0です。SALESFORCE_API_VERSIONで上書きできます。

実行

# 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 / 汎用MCPクライアント設定：

{
  "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"
      }
    }
  }
}

スモーク テスト（ネットワーク不要。バージョン、認証情報の状態、ツールを出力し、終了コード0で終了）：

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

開発

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）は、すべてのプッシュとプル リクエストで実行されます：Python 3.10～3.13でのテスト スイート、ruffによるlintおよびフォーマットのチェックに加えてmypy、そしてサンドボックスと同じ方法でパッケージをインストールする（uvx --from .）パッケージング ジョブが含まれ、パッケージングの破損を検出します。

セキュリティに関する注意事項

• アクセス トークンのみ：サーバーはリフレッシュ トークンを要求、読み取り、永続化することはありません。

• 破壊的操作（update/delete）は、明示的なconfirm=true引数によってゲートされており、モデルに対してユーザーの承認を先に得るようガイダンスが提供されます。

• SOQLページネーション カーソル（next_url）は/services/data/...パスであることが検証され、オブジェクト/レコード識別子はURLに配置される前に検証されます。

• レスポンスにはサイズ上限が設定され、明示的な切り詰め通知が含まれます。