Skip to main content
Glama
ZLeventer

salesforce-marketing-mcp

salesforce-marketing-mcp

MIT License Node.js 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-mcp

2. 環境変数

変数

必須

デフォルト

説明

SF_USERNAME

はい

Salesforceログインメールアドレス

SF_PASSWORD

はい

Salesforceパスワード

SF_SECURITY_TOKEN

はい

セキュリティトークン(ログイン時にパスワードの末尾に付加)

SF_LOGIN_URL

いいえ

https://login.salesforce.com

サンドボックスの場合は https://test.salesforce.com を使用

SF_API_VERSION

いいえ

60.0

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-mcp

Cursor

.cursor/mcp.json に以下を追加します:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken"
      }
    }
  }
}

ツールリファレンス

ツール

説明

sf_search_leads

リード名、メール、会社名に対するSOSL検索

sf_get_lead

IDによるリードレコードの全取得

sf_create_lead

新規リードの作成

sf_update_lead

リード項目の更新

sf_convert_lead

リードを取引先/取引先責任者/商談に変換

sf_search_contacts

取引先責任者名とメールに対するSOSL検索

sf_get_contact

取引先名を含む取引先責任者レコードの全取得

sf_create_contact

新規取引先責任者の作成

sf_update_contact

取引先責任者項目の更新

sf_contact_by_email

メールアドレスによる取引先責任者の検索(最大10件)

sf_search_accounts

取引先名に対するSOSL検索

sf_get_account

オープン商談数とリード数を含む取引先レコード

sf_list_account_contacts

取引先に関連付けられた取引先責任者

sf_list_campaigns

ステータス/タイプ/アクティブフィルター付きのキャンペーンリスト

sf_get_campaign

すべてのパフォーマンス指標を含むキャンペーンレコード

sf_create_campaign

新規キャンペーンの作成

sf_update_campaign

キャンペーン項目の更新

sf_get_campaign_members

リード/取引先責任者の詳細を含むキャンペーンメンバーリスト

sf_add_campaign_member

単一のリードまたは取引先責任者をキャンペーンに追加

sf_bulk_add_campaign_members

1回の呼び出しで最大200件のリード/取引先責任者を追加

sf_update_campaign_member_status

メンバーのステータスとHasRespondedフラグの更新

sf_create_task

リード、取引先責任者、またはキャンペーンにリンクされたタスクの作成

sf_list_tasks_by_lead

リードに関連付けられたタスク

sf_list_tasks_by_contact

取引先責任者に関連付けられたタスク

sf_list_tasks_by_campaign

キャンペーンに関連付けられたタスク

sf_list_reports

利用可能なSalesforce分析レポートのリスト

sf_run_report

レポートを実行し、構造化された行を返す

sf_get_report_metadata

レポートの列定義とグループ化情報

sf_campaign_roi

キャンペーンごとのROI、CPL、CPO、および応答率

sf_campaign_member_status_breakdown

キャンペーンのメンバーのステータス内訳

sf_top_campaigns

応答数、商談数、または受注収益によるキャンペーンランキング

sf_campaign_performance_trend

時間経過に伴うメンバー追加数(週/月)

sf_lead_source_breakdown

リードソース別のリード数、コンバージョン数、収益

sf_pipeline_by_campaign

キャンペーンとフェーズでグループ化されたオープンパイプライン

sf_campaign_influence

キャンペーンと商談をリンクするCampaignInfluenceレコード

sf_won_revenue_by_campaign

プライマリキャンペーンでグループ化された受注収益

sf_lead_conversion_metrics

リードソースまたはキャンペーン別のコンバージョン率

sf_pipeline_summary

フェーズ別のパイプライン:件数、金額、確率、加重値

sf_pipeline_by_lead_source

リードソース別にグループ化されたパイプライン

sf_mql_trend

時間経過に伴うMQL(または任意のステータス)のボリューム

sf_forecast_summary

指定期間内に完了予定の商談の期待収益

sf_activity_summary

リードソース、キャンペーン、または所有者別のタスク/イベント数

sf_recent_activities_by_lead

特定のリードのタスクとイベント

sf_recent_activities_by_contact

特定の取引先責任者のタスクとイベント

sf_run_soql

生のSOQLを実行(カスタムクエリ用)

sf_describe_object

SObjectの全フィールドメタデータ

sf_list_objects

クエリ可能な全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.

View all MCP Connectors

Latest Blog Posts

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