Salesforce

@mindstone/mcp-server-salesforce

Salesforce CRM MCP サーバー — Salesforce API を通じて、アカウント、連絡先、商談、リード、タスク、ユーザー、カスタムオブジェクトを扱います。

MCP ホストが、Salesforce がホストするエンドポイントではなく、日常的な営業業務のためにローカルでインストールして実行できる CRM コネクターを必要とする場合に最適です。

ステータス

• バージョン： 0.2.3 · npm
• 認証： OAuth（ローカルの 127.0.0.1 コールバック）または静的アクセストークン（SALESFORCE_CLIENT_SECRET、SALESFORCE_ACCESS_TOKEN）
• ツール： 37（アカウント、連絡先、商談、リード、タスク、ケース、イベント、検索、メモ、キャンペーン、レポート、クエリ）
• 対象： cloud-api
• 機械可読情報： STATUS.json

このパッケージについて

Salesforce 独自の MCP オプションは、多くのチームにとって適切な出発点です。このパッケージは、一般的な npm MCP サーバーを使い、任意の stdio ホスト上でローカル実行したいチーム向けです。

アシスタントが、アカウントや連絡先の検索、リードの更新、商談やタスクの作成、CRM 検索の実行、カスタムオブジェクトの操作など、実際によく依頼される CRM 業務に集中してアクセスできるようにします。自然言語での営業依頼から適切な Salesforce レコードにたどり着くまでの道のりが短く、書き込み操作はホストから確認できる状態に保たれます。

やり取りの例

「Salesforce で Acme Corp を見つけて、第 3 四半期の 75,000 ドルの拡大商談を作成し、来週の金曜日にフォローアップタスクを追加してください。」

ホストが呼び出すツール：

1. salesforce_get_accounts — 名前でアカウントを検索し、一致するアカウント ID を返します。
2. salesforce_create_opportunity — そのアカウントに商談を作成します。
3. salesforce_create_task — 新しい商談に関連付けてフォローアップタスクを追加します。

応答（一部省略）：

{
  "account": { "id": "001xx000003DGbYAAW", "name": "Acme Corp" },
  "opportunity": {
    "id": "006xx000004TmiYAAS",
    "name": "Q3 expansion",
    "amount": 75000,
    "stage": "Prospecting"
  },
  "task": {
    "id": "00Txx000006rYxDEAU",
    "subject": "Follow up on Q3 expansion"
  }
}

要件

• Node.js 20+
• npm
• OAuth を使用する場合は Salesforce Connected App、手動トークンモードの場合は有効なアクセストークンとインスタンス URL が必要です。

ワンクリックインストール

ボタンをクリックすると、ホストから次の項目の入力を求められます：SALESFORCE_CLIENT_ID、SALESFORCE_CLIENT_SECRET、SALESFORCE_ACCESS_TOKEN、SALESFORCE_CONFIG_DIR、SALESFORCE_OAUTH_PORT。

{
  "mcpServers": {
    "Salesforce": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-salesforce"
      ],
      "env": {
        "SALESFORCE_CLIENT_ID": "",
        "SALESFORCE_CLIENT_SECRET": "",
        "SALESFORCE_ACCESS_TOKEN": "",
        "SALESFORCE_CONFIG_DIR": "~/.mcp/salesforce",
        "SALESFORCE_OAUTH_PORT": "0"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/salesforce
npm install
npm run build

npx

npx -y @mindstone/mcp-server-salesforce

ローカル

node dist/index.js

設定

OAuth（推奨）

次の環境変数を設定します：

• SALESFORCE_CLIENT_ID — Salesforce Connected App のクライアント ID
• SALESFORCE_CLIENT_SECRET — Salesforce Connected App のクライアントシークレット
• SALESFORCE_SANDBOX — サンドボックス環境では "true" に設定します（任意）

次に salesforce_connect_account を呼び出して、OAuth フローを開始します。

手動トークン

• SALESFORCE_ACCESS_TOKEN — 有効な Salesforce アクセストークン
• SALESFORCE_INSTANCE_URL — Salesforce インスタンスの URL（例：https://mycompany.my.salesforce.com）

追加オプション

• SALESFORCE_CONFIG_DIR — カスタム設定ディレクトリ（デフォルト：~/.mcp/salesforce）
• SALESFORCE_OAUTH_PORT — OAuth コールバックポート（0 = OS が割り当て；デフォルト：0）
• SALESFORCE_OAUTH_SCOPES — スペース区切りの OAuth スコープ。コネクターのデフォルトを使用する場合は設定しないでください。

利用可能なツール（37）

アカウント管理

• salesforce_connect_account — OAuth で Salesforce アカウントに接続
• salesforce_list_connected_accounts — 接続済みアカウントを一覧表示
• salesforce_disconnect_account — アカウントの接続を解除

CRM アカウント

• salesforce_get_accounts — フィルターを指定して CRM アカウントを取得
• salesforce_create_account — CRM アカウントを作成
• salesforce_update_account — CRM アカウントを更新

連絡先

• salesforce_get_contacts — フィルターを指定して連絡先を取得
• salesforce_create_contact — 連絡先を作成
• salesforce_update_contact — 連絡先を更新

商談

• salesforce_get_opportunities — フィルターを指定して商談を取得
• salesforce_create_opportunity — 商談を作成
• salesforce_update_opportunity — 商談を更新

リード

• salesforce_get_leads — フィルターを指定してリードを取得
• salesforce_create_lead — リードを作成
• salesforce_convert_lead — リードをアカウント＋連絡先に変換
• salesforce_update_lead — リードを更新

タスク

• salesforce_get_tasks — フィルターを指定してタスクを取得します
• salesforce_create_task — タスクを作成します
• salesforce_update_task — タスクを更新します

ケース

• salesforce_get_cases — フィルターを指定してサポートケースを取得します
• salesforce_create_case — サポートケースを作成します
• salesforce_update_case — サポートケースを更新します

イベント

• salesforce_get_events — フィルターを指定してカレンダーイベントを取得します
• salesforce_create_event — カレンダーイベントを作成します

検索

• salesforce_search — オブジェクト横断の全文検索（SOSL）を実行します。レスポンスの truncated フラグにより、上限を超える一致結果が存在するかどうかを確認できます

メモ

• salesforce_get_notes — レコードに添付されたメモを取得します
• salesforce_create_note — メモを作成し、必要に応じてレコードに添付します（添付に失敗した場合はメモをロールバックするか、孤立したメモの ID を報告します）

キャンペーン

• salesforce_get_campaigns — フィルターを指定してマーケティングキャンペーンを取得します
• salesforce_get_campaign_members — キャンペーンに参加しているリード／取引先責任者を取得します

レポート

• salesforce_run_report — 既存の Salesforce レポートを実行します（Analytics REST API）

ユーザー

• salesforce_get_users — Salesforce ユーザーを取得します

クエリとスキーマ

• salesforce_query — SOQL クエリを直接実行します
• salesforce_describe_object — オブジェクトのメタデータと項目を取得します
• salesforce_list_objects — 利用可能な Salesforce オブジェクトを一覧表示します

汎用 CRUD

• salesforce_create_record — 任意の Salesforce レコードを作成します
• salesforce_update_record — 任意の Salesforce レコードを更新します
• salesforce_get_records — 任意の Salesforce オブジェクトをクエリします

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

• スタンドアロンの OAuth コールバックサーバーは 127.0.0.1 にバインドされます。コールバックがループバックの範囲外に公開されるような環境変数による上書きは受け付けません。
• OAuth 認証情報は SALESFORCE_CONFIG_DIR（デフォルトは ~/.mcp/salesforce）に、厳格なディレクトリおよびファイル権限で保存されます。
• 書き込みツールと切断ツールにはマークが付けられているため、対応するホストでは Salesforce データを変更する前に確認を求めることができます。
• SOQL ヘルパーの処理では、文字列値と LIKE の値をエスケープし、クエリ上限を適用する前にコメントを引用符の状態を考慮して除去し、SOQL クエリで取得するレコード数を最大 200 件に制限します。
• 読み取りツールが返すレコードのテキストは <untrusted-content> エンベロープで囲まれるため、Salesforce の項目値は指示ではなくデータとしてモデルに提示されます。
• salesforce_convert_lead は、Salesforce がレコードレベルで変換を拒否した場合（検証ルールなど）、成功と報告せずに変換の失敗を報告します。組織が作成したエラーの詳細も同様にエンベロープで囲まれます。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1（MIT の将来のライセンスを含みます）。このソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。