Skip to main content
Glama
ZLeventer

salesforce-marketing-mcp

salesforce-marketing-mcp

MIT License Node.js MCP

Готовый к промышленному использованию сервер Model Context Protocol (MCP), который предоставляет ИИ-ассистентам (Claude, Cursor и др.) прямой доступ к данным Salesforce CRM. Создан для команд маркетинговых операций, операционного управления доходами и B2B-маркетологов, которым нужен доступ к лидам, контактам, кампаниям, участникам кампаний, задачам и 14 инструментам отчетности с помощью ИИ — и все это без написания SOQL.


Функции

  • Лиды — поиск, получение, создание, обновление и конвертация лидов

  • Контакты — поиск, получение, создание, обновление и поиск по email

  • Аккаунты — поиск, получение и список контактов по аккаунту

  • Кампании — список, получение, создание и обновление кампаний

  • Участники кампаний — список участников, добавление отдельных лиц, массовое добавление до 200 человек, обновление статусов

  • Задачи — создание задач; список по лиду, контакту или кампании

  • Аналитические отчеты — список, запуск и описание аналитических отчетов Salesforce

  • Аналитика кампаний — расчет ROI, разбивка по статусам участников, топ кампаний, тренды эффективности

  • Атрибуция — разбивка по источникам лидов, воронка по кампаниям, CampaignInfluence, выигранная выручка по кампаниям, метрики конверсии лидов

  • Воронка (Pipeline) — сводка воронки, воронка по источникам лидов, тренд 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

Да

Email для входа в Salesforce

SF_PASSWORD

Да

Пароль Salesforce

SF_SECURITY_TOKEN

Да

Токен безопасности (добавляется к паролю при входе)

SF_LOGIN_URL

Нет

https://login.salesforce.com

Используйте https://test.salesforce.com для песочниц (sandboxes)

SF_API_VERSION

Нет

60.0

Версия API Salesforce

Создайте файл .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 по имени лида, email и компании

sf_get_lead

Полная запись лида по ID

sf_create_lead

Создание нового лида

sf_update_lead

Обновление любых полей лида

sf_convert_lead

Конвертация лида в аккаунт / контакт / сделку

sf_search_contacts

Поиск SOSL по имени контакта и email

sf_get_contact

Полная запись контакта с названием аккаунта

sf_create_contact

Создание нового контакта

sf_update_contact

Обновление любых полей контакта

sf_contact_by_email

Поиск контактов по 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

Массовое добавление до 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? Включи стоимость привлечения лида (CPL)."

"Покажи тренд MQL по месяцам за этот год."

"Добавь всех лидов из этого списка в кампанию Q2 Webinar со статусом 'Invited'."

"Какова наша текущая сводка воронки по этапам с учетом взвешенных значений?"


Как это работает

  • Авторизация: Подключается через имя пользователя + пароль + токен безопасности Salesforce с использованием jsforce. Соединение кэшируется на 25 минут и автоматически обновляется при ошибках INVALID_SESSION_ID.

  • Продакшн и песочница: Установите SF_LOGIN_URL=https://test.salesforce.com для работы с песочницей.

  • Ограничения скорости: Все запросы соблюдают лимиты API Salesforce. Используйте параметры 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