Интеграция Salesforce MCP

Этот проект предоставляет сервер Model Context Protocol (MCP) для интеграции Salesforce, позволяя выполнять запросы SOQL, извлекать метаданные и взаимодействовать с данными Salesforce через стандартизированный интерфейс.

Функции

Подключайтесь к организациям Salesforce с помощью переменных среды
Выполнение запросов SOQL к данным Salesforce
Извлечение и обработка записей и метаданных Salesforce
Перечисление и управление потоками Salesforce
Безопасное управление учетными данными с использованием переменных среды

Related MCP server: MCP Salesforce Connector

Предпосылки

Node.js (v14 или выше)
npm (менеджер пакетов узлов)
Salesforce org с доступом API
Учетные данные Salesforce (имя пользователя и пароль)

Установка

Клонируйте этот репозиторий:
git clone <repository-url> cd <repository-directory>
Установить зависимости:
npm install
Создайте файл .env в корневом каталоге с вашими учетными данными Salesforce и версией API:
SF_LOGIN_URL=https://your-instance.salesforce.com/ SF_USERNAME=your_username SF_PASSWORD=your_password SF_API_VERSION=58.0
- Для сред-песочниц используйте https://test.salesforce.com/ в качестве URL-адреса для входа.
- Переменная SF_API_VERSION управляет версией API Salesforce, используемой интеграцией. Обновите ее по мере необходимости для вашей организации.

Использование

Запуск MCP-сервера

Запустите сервер с помощью Node.js:

node server.js

Сервер подключится к Salesforce, используя учетные данные из вашего файла .env , и начнет прослушивать запросы MCP.

Выполнение запросов SOQL

После запуска сервера вы можете выполнять запросы SOQL через интерфейс MCP. Сервер предоставляет инструмент soqlQuery , который принимает запросы SOQL и возвращает результаты.

Пример запроса SOQL:

SELECT Id, Name, Status FROM Account LIMIT 5

Листинг потоков Salesforce

Вы можете перечислить все потоки в вашей организации Salesforce, используя инструмент retrieveMetadata с типом метаданных Flow . Это вернет все доступные потоки и их метаданные.

Настройка mcpServers в курсоре

Чтобы использовать этот сервер Salesforce MCP с Cursor, добавьте следующую конфигурацию в файл mcp.json в Cursor:

"mcpServers": { "mcp-salesforce": { "command": "node /absolute/path/to/your/project/root/server.js", "transport": "stdio", "args": [] } }

Замените /absolute/path/to/your/project/root/server.js на абсолютный путь к вашему файлу server.js .
Убедитесь, что сервер запущен из правильного каталога, чтобы он мог найти файл .env и зависимости.

После добавления этой конфигурации в ваш mcp.json вы сможете подключиться к серверу Salesforce MCP из Cursor и использовать все доступные инструменты.

Структура проекта

server.js — реализация основного сервера MCP и настройка подключения Salesforce
tools.js — все определения инструментов MCP (SOQL, метаданные, потоки и т. д.)
.env — переменные среды для учетных данных Salesforce и версии API
package.json — Зависимости проекта и скрипты

Соображения безопасности

Никогда не передавайте файл .env в систему контроля версий
Добавьте .env в ваш файл .gitignore
Используйте переменные среды для всей конфиденциальной информации.
Рассмотрите возможность использования более безопасного метода аутентификации для производственных сред.

Поиск неисправностей

Проблемы с подключением

Если у вас возникли проблемы с подключением:

Проверьте свои учетные данные Salesforce в файле .env
Проверьте доступность вашей организации Salesforce
Убедитесь, что ваш IP-адрес добавлен в белый список Salesforce (при необходимости)
Убедитесь, что у вашего пользователя Salesforce есть доступ к API

Ошибки запроса

Если ваши запросы SOQL не выполняются:

Проверьте синтаксис SOQL
Убедитесь, что объекты и поля существуют в вашей организации.
Убедитесь, что у вашего пользователя есть разрешение на доступ к объектам и полям.

Лицензия

Лицензия Массачусетского технологического института

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Salesforce MCP Integration