Salesforce MCP Integration

Интеграция 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. Убедитесь, что у вашего пользователя есть разрешение на доступ к объектам и полям.

Лицензия

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

Внося вклад

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