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

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

Функции

• Подключайтесь к организациям Salesforce с помощью переменных среды

• Выполнение запросов SOQL к данным Salesforce

• Извлечение и обработка записей и метаданных Salesforce

• Перечисление и управление потоками Salesforce

• Безопасное управление учетными данными с использованием переменных среды

Предпосылки

• Node.js (v14 или выше)

• npm (менеджер пакетов узлов)

• Salesforce org с доступом API

• Учетные данные Salesforce (имя пользователя и пароль)

Установка

1. Клонируйте этот репозиторий:

   git clone <repository-url> cd <repository-directory>

2. Установить зависимости:

   npm install

3. Создайте файл .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:

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

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

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

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

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

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

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

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

• Замените /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

• Используйте переменные среды для всей конфиденциальной информации.

• Рассмотрите возможность использования более безопасного метода аутентификации для производственных сред.

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

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

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

1. Проверьте свои учетные данные Salesforce в файле .env

2. Проверьте доступность вашей организации Salesforce

3. Убедитесь, что ваш IP-адрес добавлен в белый список Salesforce (при необходимости)

4. Убедитесь, что у вашего пользователя Salesforce есть доступ к API

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

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

1. Проверьте синтаксис SOQL

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

3. Убедитесь, что у вашего пользователя есть разрешение на доступ к объектам и полям.

Лицензия

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

Внося вклад

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