MCP-Salesforce

MCP-сервер для Salesforce: запросы SOQL и SOSL, чтение и изменение записей, пакетные операции и вызовы Apex REST

  • 179 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Агент создает, обновляет и удаляет записи, в том числе пачками, а переключателя только для чтения нет
  • Инструменты `restful`, `apex_execute` и `tooling_execute` открывают прямые вызовы к API организации
  • Токен или логин с паролем дают доступ к клиентским данным CRM, а без SALESFORCE_DOMAIN сервер работает с боевой организацией
Все причины и проверки

smn2gnt/mcp-salesforce

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-salesforce

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент создает, обновляет и удаляет записи, в том числе пачками, а переключателя только для чтения нет
  • Инструменты `restful`, `apex_execute` и `tooling_execute` открывают прямые вызовы к API организации
  • Токен или логин с паролем дают доступ к клиентским данным CRM, а без SALESFORCE_DOMAIN сервер работает с боевой организацией

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCP-Salesforce дает агенту 14 инструментов для работы с Salesforce. Чтение закрывают `run_soql_query` и `run_sosl_search`, `list_sobjects` и `get_object_fields` показывают стандартные и пользовательские объекты и их поля. Записи читают, создают, обновляют и удаляют по одной или пачкой через `bulk_create_records`, `bulk_update_records` и `bulk_delete_records`. Для продвинутых сценариев есть `tooling_execute` для Tooling API, `apex_execute` для вызовов Apex REST и `restful` для произвольных REST-запросов к организации. Войти можно по OAuth с токеном доступа (рекомендуемый путь), через Client Credentials, через активную организацию Salesforce CLI или по логину с паролем. Переменная SALESFORCE_DOMAIN со значением `test` переключает сервер на песочницу. Запускается через uvx из PyPI-пакета mcp-salesforce-connector.

Для кого. Администраторам и разработчикам Salesforce, которые хотят запрашивать и править данные организации из Claude Desktop или другого MCP-клиента.

Подходит, если

  • Нужно выгрузить контакты и сделки по условию SOQL и свести их в таблицу
  • Агент должен найти запись по тексту через SOSL по нескольким объектам сразу
  • Список полей пользовательского объекта неизвестен, и его надо получить из метаданных организации
  • Сотни записей требуют пакетного обновления поля по списку идентификаторов
  • Проверка Apex REST или Tooling API идет на песочнице, подключенной через SALESFORCE_DOMAIN=test

Не подходит, если

  • Агенту достаточно читать данные: у сервера нет режима только для чтения, и удаление доступно всегда
  • Нужна официальная поддержка Salesforce: для нее есть сервер Salesforce DX
  • Рабочая организация не допускает токенов с широкими правами для сторонних инструментов
  • Нужен фоновый обмен данными на тысячи записей: пакетные инструменты рассчитаны на запросы агента

Пример запроса к агенту

Покажи поля объекта Opportunity и выведи десять последних сделок с суммой больше миллиона запросом SOQL.

MCP

Транспорт
stdio
Авторизация
OAuth

Переменные окружения

SALESFORCE_ACCESS_TOKEN секрет
Токен доступа OAuth, рекомендуемый способ входа
SALESFORCE_INSTANCE_URL
Адрес экземпляра Salesforce для OAuth
SALESFORCE_DOMAIN
Значение `test` подключает песочницу, пустое значение боевую организацию
SALESFORCE_CLIENT_ID
Идентификатор клиента для OAuth Client Credentials
SALESFORCE_CLIENT_SECRET секрет
Секрет клиента для OAuth Client Credentials
SALESFORCE_USERNAME
Логин для устаревшего входа по паролю
SALESFORCE_PASSWORD секрет
Пароль для устаревшего входа
SALESFORCE_SECURITY_TOKEN секрет
Токен безопасности для входа по паролю
SALESFORCE_CLI_TARGET_ORG
Псевдоним или логин организации Salesforce CLI, если нужна не организация по умолчанию

Ограничения

  • Режима только для чтения нет: `delete_record`, `bulk_delete_records` и `restful` доступны вместе с чтением. Права ограничивайте на стороне пользователя Salesforce.
  • Каждый способ авторизации требует своих переменных: токен и адрес экземпляра, пара Client ID и Secret, активная организация CLI или логин, пароль и токен безопасности.
  • Без SALESFORCE_DOMAIN сервер подключается к боевой организации, а не к песочнице.
  • Последний коммит репозитория сделан в июле 2026 года, README коротко описывает каждый инструмент без примеров запросов.

Как отключить. Удалите блок salesforce из `claude_desktop_config.json` и перезапустите клиент. Токен доступа отзовите в Salesforce, если он больше не нужен.

Частые вопросы

Какие методы входа поддерживает MCP-Salesforce?

Четыре: OAuth с токеном и адресом экземпляра, Client Credentials, активная организация Salesforce CLI и логин с паролем и токеном безопасности. Первый из них README советует как основной.

Как подключиться к песочнице, а не к боевой организации?

Задайте переменную SALESFORCE_DOMAIN со значением `test`. Если ее нет или она пустая, сервер подключается к боевой организации.

Может ли агент удалить записи?

Да. Среди 14 инструментов есть `delete_record` и `bulk_delete_records`, а переключателя только для чтения нет. Защитой служат права пользователя Salesforce и ваше подтверждение каждой записи.

Как поставить MCP-Salesforce в Claude Desktop?

Добавьте в `claude_desktop_config.json` сервер с командой uvx и аргументами `--from mcp-salesforce-connector salesforce`, а в env положите токен и адрес экземпляра. После перезапуска клиента инструменты появятся в списке.

Какой пакет запускает сервер?

PyPI-пакет mcp-salesforce-connector, его вызывает uvx командой `uvx --from mcp-salesforce-connector salesforce`. Отдельной установки пакета в README нет.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер Salesforce: агент ищет объекты, запрашивает и меняет записи, правит поля и пишет Apex обычным языком.

MCP-серверШирокий доступ164Звезды репозитория
Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверШирокий доступ489Звезды репозитория
Официальный

Размещенные MCP-серверы Salesforce подключают Claude, Cursor и ChatGPT к данным организации с правами вошедшего пользователя.

MCP-серверШирокий доступ136Звезды репозитория
Российский стек

MCP-сервер для платформы интернет-магазинов InSales: товары, заказы, клиенты и категории через админ API

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров

MCP-серверРасширенный доступ
Российский стек

Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен

MCP-серверШирокий доступ12Звезды репозитория

Коротко о README

README коротко перечисляет возможности и дает фрагмент конфигурации для `claude_desktop_config.json` с запуском через uvx. Затем идут сгруппированный список инструментов, способы входа и описание переменных окружения, включая SALESFORCE_DOMAIN и SALESFORCE_CLI_TARGET_ORG.

Бейдж для README

Сообщить о проблеме