salesforce-marketing-mcp
salesforce-marketing-mcp
AIアシスタント(Claude、Cursorなど)がSalesforce CRMデータに直接アクセスできるようにする、本番環境対応のModel Context Protocol(MCP)サーバーです。マーケティングオペレーション、レベニューオペレーション、およびB2Bマーケティングチーム向けに構築されており、SOQLを書くことなく、リード、取引先責任者、キャンペーン、キャンペーンメンバー、タスク、および14のレポートツールにAI経由でアクセスできます。
機能
リード — 検索、取得、作成、更新、変換
取引先責任者 — 検索、取得、作成、更新、メールアドレスによる検索
取引先 — 検索、取得、取引先ごとの取引先責任者リストの取得
キャンペーン — リスト表示、取得、作成、更新
キャンペーンメンバー — メンバーのリスト表示、個人の追加、最大200件の一括追加、ステータスの更新
タスク — タスクの作成、リード・取引先責任者・キャンペーンごとのリスト表示
分析レポート — Salesforce分析レポートのリスト表示、実行、説明
キャンペーン分析 — ROI計算、メンバーのステータス内訳、トップキャンペーン、パフォーマンスの傾向
属性分析 — リードソースの内訳、キャンペーン別パイプライン、CampaignInfluence、キャンペーン別受注収益、リードコンバージョン指標
パイプライン — パイプラインサマリー、リードソース別パイプライン、MQLトレンド、予測サマリー
活動 — ディメンション別の活動サマリー、リードまたは取引先責任者別の最近の活動
パワーツール — 生のSOQL実行、SObjectの記述、全オブジェクトのリスト表示
前提条件
Salesforce組織(APIアクセス権を持つすべてのエディション)
Salesforceのユーザー名、パスワード、およびセキュリティトークン
セキュリティトークンの取得/リセット方法: 設定 > 個人情報 > セキュリティトークンのリセット
Node.js 20以降
接続アプリケーションやOAuthの設定は不要です。
セットアップ
1. インストール
npm install -g salesforce-marketing-mcp
# or run directly with npx
npx salesforce-marketing-mcp2. 環境変数
変数 | 必須 | デフォルト | 説明 |
| はい | — | Salesforceログインメールアドレス |
| はい | — | Salesforceパスワード |
| はい | — | セキュリティトークン(ログイン時にパスワードの末尾に付加) |
| いいえ |
| サンドボックスの場合は |
| いいえ |
| Salesforce APIバージョン |
.envファイルを作成するか、シェルで設定してください:
export SF_USERNAME="you@yourcompany.com"
export SF_PASSWORD="yourpassword"
export SF_SECURITY_TOKEN="yourtoken"
# For sandbox:
export SF_LOGIN_URL="https://test.salesforce.com"使用方法
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に追加します:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["salesforce-marketing-mcp"],
"env": {
"SF_USERNAME": "you@yourcompany.com",
"SF_PASSWORD": "yourpassword",
"SF_SECURITY_TOKEN": "yourtoken",
"SF_LOGIN_URL": "https://login.salesforce.com"
}
}
}
}Claude Code
claude mcp add salesforce-marketing-mcp \
-e SF_USERNAME=you@yourcompany.com \
-e SF_PASSWORD=yourpassword \
-e SF_SECURITY_TOKEN=yourtoken \
-- npx salesforce-marketing-mcpCursor
.cursor/mcp.json に以下を追加します:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["salesforce-marketing-mcp"],
"env": {
"SF_USERNAME": "you@yourcompany.com",
"SF_PASSWORD": "yourpassword",
"SF_SECURITY_TOKEN": "yourtoken"
}
}
}
}ツールリファレンス
ツール | 説明 |
| リード名、メール、会社名に対するSOSL検索 |
| IDによるリードレコードの全取得 |
| 新規リードの作成 |
| リード項目の更新 |
| リードを取引先/取引先責任者/商談に変換 |
| 取引先責任者名とメールに対するSOSL検索 |
| 取引先名を含む取引先責任者レコードの全取得 |
| 新規取引先責任者の作成 |
| 取引先責任者項目の更新 |
| メールアドレスによる取引先責任者の検索(最大10件) |
| 取引先名に対するSOSL検索 |
| オープン商談数とリード数を含む取引先レコード |
| 取引先に関連付けられた取引先責任者 |
| ステータス/タイプ/アクティブフィルター付きのキャンペーンリスト |
| すべてのパフォーマンス指標を含むキャンペーンレコード |
| 新規キャンペーンの作成 |
| キャンペーン項目の更新 |
| リード/取引先責任者の詳細を含むキャンペーンメンバーリスト |
| 単一のリードまたは取引先責任者をキャンペーンに追加 |
| 1回の呼び出しで最大200件のリード/取引先責任者を追加 |
| メンバーのステータスとHasRespondedフラグの更新 |
| リード、取引先責任者、またはキャンペーンにリンクされたタスクの作成 |
| リードに関連付けられたタスク |
| 取引先責任者に関連付けられたタスク |
| キャンペーンに関連付けられたタスク |
| 利用可能なSalesforce分析レポートのリスト |
| レポートを実行し、構造化された行を返す |
| レポートの列定義とグループ化情報 |
| キャンペーンごとのROI、CPL、CPO、および応答率 |
| キャンペーンのメンバーのステータス内訳 |
| 応答数、商談数、または受注収益によるキャンペーンランキング |
| 時間経過に伴うメンバー追加数(週/月) |
| リードソース別のリード数、コンバージョン数、収益 |
| キャンペーンとフェーズでグループ化されたオープンパイプライン |
| キャンペーンと商談をリンクするCampaignInfluenceレコード |
| プライマリキャンペーンでグループ化された受注収益 |
| リードソースまたはキャンペーン別のコンバージョン率 |
| フェーズ別のパイプライン:件数、金額、確率、加重値 |
| リードソース別にグループ化されたパイプライン |
| 時間経過に伴うMQL(または任意のステータス)のボリューム |
| 指定期間内に完了予定の商談の期待収益 |
| リードソース、キャンペーン、または所有者別のタスク/イベント数 |
| 特定のリードのタスクとイベント |
| 特定の取引先責任者のタスクとイベント |
| 生のSOQLを実行(カスタムクエリ用) |
| SObjectの全フィールドメタデータ |
| クエリ可能な全SObjectのリスト(フィルター可) |
プロンプト例
接続後、Claudeに以下のように質問できます:
"今四半期の受注収益トップ5のキャンペーンは何ですか?"
"過去90日間のリードソースの内訳を表示して。コンバージョン率も含めて。"
"リード 00Q のフォローアップタスクを来週金曜日期限で作成して。"
"ROIが最も高いキャンペーンはどれですか?リード単価も含めて。"
"今年の月別MQLトレンドを表示して。"
"このリストの全リードを、ステータス 'Invited' で Q2 Webinar キャンペーンに追加して。"
"現在のフェーズ別パイプラインサマリーを、加重値付きで教えて。"
仕組み
認証: jsforce を使用して、Salesforceのユーザー名 + パスワード + セキュリティトークンで接続します。接続は25分間キャッシュされ、
INVALID_SESSION_IDエラーが発生した場合は自動的に更新されます。本番環境とサンドボックス:
SF_LOGIN_URL=https://test.salesforce.comを設定することでサンドボックスをターゲットにできます。レート制限: すべてのクエリはSalesforceのAPI制限を遵守します。結果サイズを制御するには
limitパラメータを使用してください。
ライセンス
MIT
Related MCP Connectors
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
Cloud MCP for project data, analytics, research, content planning, media generation, and growth.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/salesforce-marketing-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server