salesforce-marketing-mcp
salesforce-marketing-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-mcp2. Переменные окружения
Переменная | Обязательно | По умолчанию | Описание |
| Да | — | Email для входа в Salesforce |
| Да | — | Пароль Salesforce |
| Да | — | Токен безопасности (добавляется к паролю при входе) |
| Нет |
| Используйте |
| Нет |
| Версия 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-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 по имени лида, email и компании |
| Полная запись лида по ID |
| Создание нового лида |
| Обновление любых полей лида |
| Конвертация лида в аккаунт / контакт / сделку |
| Поиск SOSL по имени контакта и email |
| Полная запись контакта с названием аккаунта |
| Создание нового контакта |
| Обновление любых полей контакта |
| Поиск контактов по email (до 10 совпадений) |
| Поиск SOSL по названию аккаунта |
| Запись аккаунта с количеством открытых сделок и лидов |
| Контакты, связанные с аккаунтом |
| Список кампаний с опциональными фильтрами по статусу/типу/активности |
| Полная запись кампании со всеми метриками эффективности |
| Создание новой кампании |
| Обновление любых полей кампании |
| Список участников кампании с данными лидов/контактов |
| Добавление одного лида или контакта в кампанию |
| Массовое добавление до 200 лидов/контактов за один вызов |
| Обновление статуса участника и флага HasResponded |
| Создание задачи, связанной с лидом, контактом или кампанией |
| Задачи, связанные с лидом |
| Задачи, связанные с контактом |
| Задачи, связанные с кампанией |
| Список доступных аналитических отчетов Salesforce |
| Выполнение отчета и возврат структурированных строк |
| Определения столбцов и группировки для отчета |
| ROI, CPL, CPO и коэффициент отклика по кампании |
| Количество участников по статусам для кампании |
| Ранжирование кампаний по откликам, сделкам или выигранной выручке |
| Добавление участников с течением времени (неделя/месяц) |
| Объем лидов, конверсии и выручка по источнику лидов |
| Открытая воронка, сгруппированная по кампании и этапу |
| Записи CampaignInfluence, связывающие кампании со сделками |
| Выигранная выручка, сгруппированная по основной кампании |
| Коэффициенты конверсии по источнику лидов или кампании |
| Воронка по этапам: количество, сумма, вероятность, взвешенное значение |
| Воронка, сгруппированная по источнику лидов |
| Объем MQL (или любого статуса) с течением времени |
| Ожидаемая выручка по сделкам, закрывающимся в диапазоне дат |
| Количество задач/событий по источнику лидов, кампании или владельцу |
| Задачи и события для конкретного лида |
| Задачи и события для конкретного контакта |
| Выполнение «сырого» SOQL (обходной путь для пользовательских запросов) |
| Полные метаданные полей для любого SObject |
| Список всех запрашиваемых 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.
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