simple-salesforce-mcp

Легковесный сервер MCP для Salesforce. Он общается напрямую с Salesforce REST API через stdio и имеет две зависимости времени выполнения (mcp, httpx) — создан как замена с быстрым холодным стартом для официального DX-сервера @salesforce/mcp, чьё дерево зависимостей слишком тяжело для песочниц.

Инструменты

Каждый инструмент несёт аннотации MCP (readOnlyHint / destructiveHint / idempotentHint). update_record и delete_record отказываются действовать, если вызов не содержит confirm: true, а сообщение об отказе предписывает модели показать пользователю точное изменение и сначала получить одобрение. Сам SOQL не может изменять данные, поэтому запасной вариант остаётся доступным только для чтения.

Related MCP server: Salesforce MCP Server

Аутентификация

Сервер сам не выполняет OAuth-поток; он использует существующий токен доступа, который определяется при каждом вызове инструмента (так что внешний процесс может ротировать токен в любой момент):

1. Хранилище аутентификации Salesforce CLI в $HOME:

   • ~/.sf/config.json → {"target-org": "<username>"} (или устаревший ~/.sfdx/sfdx-config.json → {"defaultusername": ...})

   • ~/.sfdx/<username>.json → {"accessToken": "...", "instanceUrl": "https://..."}

   Это формат, который создаёт sf org login, и формат, который платформа JustParent разворачивает в песочницах (при этом платформа обновляет токен доступа перед каждым вызовом). Refresh-токены и клиентские секреты в этих файлах игнорируются — они никогда не считываются в память, не сохраняются и не логируются.

2. Переменные окружения (запасной вариант для локального/автономного использования): SALESFORCE_ACCESS_TOKEN и SALESFORCE_INSTANCE_URL.

Если токен отклонён (HTTP 401 / INVALID_SESSION_ID), сервер один раз перечитывает хранилище аутентификации и повторяет попытку, после чего сообщает, что соединение нужно установить заново.

Версия REST API по умолчанию — 62.0; переопределяется через SALESFORCE_API_VERSION.

Запуск

# Standalone with env vars (get a token via: sf org display --json)
SALESFORCE_ACCESS_TOKEN=... \
SALESFORCE_INSTANCE_URL=https://yourorg.my.salesforce.com \
uvx --from git+https://github.com/JustParent/simple-salesforce-mcp simple-salesforce-mcp

Конфигурация Claude Desktop / универсального MCP-клиента:

{
  "mcpServers": {
    "salesforce": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/JustParent/simple-salesforce-mcp", "simple-salesforce-mcp"],
      "env": {
        "SALESFORCE_ACCESS_TOKEN": "...",
        "SALESFORCE_INSTANCE_URL": "https://yourorg.my.salesforce.com"
      }
    }
  }
}

Смоук-тест (без сети, выводит версию, статус учётных данных и инструменты; завершается с кодом 0):

uvx --from . simple-salesforce-mcp --test

Разработка

uv run pytest                    # unit tests, no network needed
uv run ruff check .              # lint
uv run ruff format .             # format (--check to verify only)
uv run mypy                      # type check (src and tests)
uv run simple-salesforce-mcp --test
npx @modelcontextprotocol/inspector uv run simple-salesforce-mcp   # interactive

CI (.github/workflows/tests.yml) запускается при каждом push и pull request: тестовый набор на Python 3.10–3.13, проверки линтера и форматирования с помощью ruff, плюс mypy, а также задача упаковки, которая устанавливает пакет так же, как это делают песочницы (uvx --from .), чтобы выявить ошибки упаковки.

Замечания по безопасности

• Только токен доступа: сервер никогда не запрашивает, не считывает и не сохраняет refresh-токены.

• Деструктивные операции (update/delete) выполняются только при наличии явного аргумента confirm=true; модель получает инструкцию сначала получить одобрение пользователя.

• Курсоры пагинации SOQL (next_url) проверяются на соответствие путям /services/data/..., а идентификаторы объектов/записей проверяются перед вставкой в URL.

• Ответы ограничены по размеру с явными уведомлениями об усечении.