Коннектор MCP для Salesforce

Реализация сервера протокола контекста модели (MCP) для интеграции с Salesforce, позволяющая LLM взаимодействовать с данными Salesforce посредством запросов SOQL и поиска SOSL.

Функции

• Выполнение запросов SOQL (Salesforce Object Query Language)

• Выполнение поиска SOSL (Salesforce Object Search Language)

• Получение метаданных объектов Salesforce, включая имена полей, метки и типы

• Список всех доступных SObjects — обнаружение стандартных и пользовательских объектов

• Получение, создание, обновление и удаление записей

• Выполнение запросов Tooling API

• Выполнение запросов Apex REST

• Выполнение прямых вызовов REST API к Salesforce

Related MCP server: Salesforce MCP Integration

Конфигурация

Протокол контекста модели (MCP)

Чтобы использовать этот сервер с протоколом контекста модели, необходимо настроить его в файле claude_desktop_config.json. Добавьте следующую запись в раздел mcpServers:

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

Доступные инструменты

Инструменты запроса и поиска

• run_soql_query — выполнение запросов SOQL к Salesforce

• run_sosl_search — выполнение поиска SOSL по объектам

Инструменты метаданных

• get_object_fields — получение метаданных полей для конкретных объектов

• list_sobjects — список всех доступных SObjects (стандартных и пользовательских)

Операции с отдельными записями

• get_record — получение конкретной записи по ID

• create_record — создание новой записи

• update_record — обновление существующей записи

• delete_record — удаление записи

Пакетные операции

• bulk_create_records — создание нескольких записей за одну операцию

• bulk_update_records — обновление нескольких записей (должно включать поле Id)

• bulk_delete_records — удаление нескольких записей с использованием их ID

Расширенные инструменты API

• tooling_execute — выполнение запросов Tooling API

• apex_execute — выполнение запросов Apex REST

• restful — выполнение прямых вызовов REST API к Salesforce

Примечание о методах аутентификации в Salesforce

Этот сервер поддерживает четыре метода аутентификации:

• OAuth (рекомендуется): Установите SALESFORCE_ACCESS_TOKEN и SALESFORCE_INSTANCE_URL в качестве переменных окружения.

• Учетные данные клиента (Client Credentials): Установите SALESFORCE_CLIENT_ID и SALESFORCE_CLIENT_SECRET для потока OAuth 2.0 Client Credentials. Это полезно для интеграций типа «сервер-сервер».

• Salesforce CLI (организация по умолчанию): Если переменные окружения OAuth не установлены, сервер попытается использовать активную организацию Salesforce CLI по умолчанию из текущей рабочей области (через sf org display --json или sfdx force:org:display --json). При необходимости установите SALESFORCE_CLI_TARGET_ORG для выбора конкретной организации.

• Имя пользователя/пароль (устаревший метод): Если SALESFORCE_ACCESS_TOKEN и SALESFORCE_INSTANCE_URL не установлены, сервер вернется к использованию SALESFORCE_USERNAME, SALESFORCE_PASSWORD и SALESFORCE_SECURITY_TOKEN.

Конфигурация окружения

• SALESFORCE_DOMAIN (необязательно): Установите значение test для подключения к песочнице (sandbox) Salesforce. Если не установлено или оставлено пустым, сервер будет подключаться к рабочей среде (production).

• SALESFORCE_CLI_TARGET_ORG (необязательно): При использовании метода аутентификации Salesforce CLI установите это значение, чтобы выбрать конкретный псевдоним организации или имя пользователя вместо организации по умолчанию.