mcp

MCP-сервер для взаимодействия с организациями Salesforce

Обратная связь

Сообщайте об ошибках и проблемах здесь.
Для запросов новых возможностей и других смежных тем начните обсуждение здесь.

Related MCP server: Salesforce DX MCP Server

Документация

Общую документацию о Salesforce DX MCP Server см. в этом разделе руководства Salesforce DX Developer Guide. Документация включает:

• Подробный обзор, включая сведения о функциях безопасности.

• Краткое руководство по началу работы.

• Несколько примеров настройки сервера в вашем MCP-клиенте.

• Примеры подсказок для вызова основных инструментов DX MCP.

Вот примечания к выпускам.

Обзор Salesforce DX MCP Server

Salesforce Config MCP Server — это специализированная реализация Model Context Protocol (MCP), предназначенная для обеспечения бесшовного взаимодействия между большими языковыми моделями (LLM) и организациями Salesforce. Этот MCP-сервер предоставляет надежный набор инструментов и возможностей, которые позволяют LLM безопасно читать ресурсы Salesforce, управлять ими и выполнять над ними операции.

Настройка DX MCP Server

Настройте Salesforce DX MCP Server для своего MCP-клиента, обновив соответствующий файл MCP JSON; каждый клиент немного отличается, поэтому обратитесь к документации своего MCP-клиента за подробностями. См. Конфигурации MCP-клиентов для дополнительных примеров.

Вот пример для VS Code с Copilot, в котором вы создаете и обновляете файл .vscode/mcp.json в своем проекте:

{
  "servers": {
    "Salesforce DX": {
      "command": "npx",
      "args": ["-y", "@salesforce/mcp",
              "--orgs", "DEFAULT_TARGET_ORG",
              "--toolsets", "orgs,metadata,data,users",
              "--tools", "run_apex_test",
              "--allow-non-ga-tools"]
    }
  }
}

Формат args, показанный в предыдущем примере, одинаков для всех MCP-клиентов; именно так вы настраиваете DX MCP Server под свое конкретное окружение.

Примечания:

• Часть "-y", "@salesforce/mcp" сообщает npx, что нужно автоматически установить пакет @salesforce/mcp вместо запроса разрешения. Не изменяйте эту часть.

• О возможных флагах, которые можно передать параметру args, и о возможных значениях, которые можно передать флагам --orgs, --toolsets и --tools, см. следующие разделы:

  • Доступные флаги для параметра args

  • Настройка организаций

  • Настройка наборов инструментов

  • Настройка инструментов

• При записи параметра args заключайте и имена флагов, и их значения в двойные кавычки, а все флаги и значения разделяйте запятыми. Некоторые флаги являются логическими и не принимают значений.

• В предыдущем примере показаны три флага, принимающих строковое значение (--orgs, --toolsets, --tools), и один логический флаг (--allow-non-ga-tools). Эта конфигурация запускает DX MCP Server, который включает все инструменты MCP в наборах orgs, metadata, data и users, а также конкретный инструмент run_apex_tests. Кроме того, она включает инструменты в этих настроенных наборах, которые еще не являются общедоступными (GA).

Конфигурации MCP-клиентов

Ниже приведены примеры настройки Salesforce DX MCP Server в различных MCP-клиентах.

Claude Code

Чтобы настроить Claude Code для работы с Salesforce DX MCP Server, добавьте этот фрагмент в файл .mcp.json вашего проекта:

{
  "mcpServers": {
    "Salesforce DX": {
      "command": "npx",
      "args": ["-y", "@salesforce/mcp",
               "--orgs", "DEFAULT_TARGET_ORG",
               "--toolsets", "orgs,metadata,data,users",
               "--tools", "run_apex_test",
               "--allow-non-ga-tools"]
    }
  }
}

Cline

Чтобы настроить Cline для работы с Salesforce DX MCP Server, добавьте этот фрагмент в файл cline_mcp_settings.json своего приложения Cline:

{
  "mcpServers": {
    "Salesforce DX": {
      "command": "npx",
      "args": ["-y", "@salesforce/mcp@latest",
              "--orgs", "DEFAULT_TARGET_ORG",
              "--toolsets", "orgs,metadata,data,users",
              "--tools", "run_apex_test",
              "--allow-non-ga-tools"]
    }
  }
}

Cursor

Чтобы настроить Cursor для работы с Salesforce DX MCP Server, добавьте этот фрагмент в файл mcp.json своего приложения Cursor:

{
  "mcpServers": {
    "Salesforce DX": {
      "command": "npx",
      "args": ["-y", "@salesforce/mcp@latest",
              "--orgs", "DEFAULT_TARGET_ORG",
              "--toolsets", "orgs,metadata,data,users",
              "--tools", "run_apex_test",
              "--allow-non-ga-tools"]
    }
  }
}

Другие MCP-клиенты

Обратитесь к документации по добавлению MCP-серверов для перечисленных ниже клиентов и следуйте той же схеме, что и в предыдущих примерах, чтобы настроить Salesforce DX MCP Server:

• Trae

• Windsurf

• Zed

Доступные флаги для параметра "args"

Вы можете передать следующие флаги параметру args.

Настройка организаций

Инструментам Salesforce MCP требуется организация, поэтому при настройке MCP-сервера необходимо указать обязательный флаг --orgs минимум с одной авторизованной организацией. Разделяйте несколько значений запятыми.

Перед тем как MCP-сервер сможет получить доступ к организациям, вы должны явно авторизовать их на своем компьютере. Используйте команду Salesforce CLI org login web или команду SFDX: Authorize an Org из палитры команд VS Code.

Вот доступные значения для флага --orgs:

[!NOTE] Токены DEFAULT_TARGET_ORG и DEFAULT_TARGET_DEV_HUB определяются динамически при каждом вызове инструмента, а не фиксируются при запуске сервера. Они отслеживают, к какой организации по умолчанию ведет рабочий каталог, в котором работает инструмент: переключение организации по умолчанию (или работа в каталоге с другой локальной организацией по умолчанию) меняет, к каким организациям эти токены дают доступ. Это повторяет поведение CLI sf, который определяет целевую организацию по умолчанию, когда вы не передаете --target-org. Если вы хотите зафиксировать сервер за фиксированным набором организаций вне зависимости от текущей организации по умолчанию, передавайте в --orgs явные имена пользователей или псевдонимы, а не токен DEFAULT_TARGET_*.

Настройка наборов инструментов

Salesforce Config MCP Server поддерживает toolsets — способ выборочного включения различных групп инструментов MCP в зависимости от ваших потребностей. Это позволяет запускать MCP-сервер только с необходимыми инструментами, что, в свою очередь, уменьшает контекст LLM.

При настройке Salesforce DX MCP Server используйте флаг --toolsets для указания наборов инструментов. Разделяйте несколько наборов инструментов запятыми.

Вот доступные наборы инструментов.

Настройка инструментов

Salesforce DX MCP Server также поддерживает регистрацию отдельных инструментов. Это можно использовать в сочетании с наборами инструментов для дальнейшей точной настройки зарегистрированных инструментов.

Используйте флаг --tools, чтобы включить определенные инструменты при настройке Salesforce DX MCP Server. Разделяйте несколько инструментов запятыми. Флаг --tools является необязательным.

В следующих разделах перечислены все инструменты, включенные в конкретный набор инструментов.

[!NOTE] Инструменты, помеченные как NON-GA, еще не являются общедоступными. Укажите флаг --allow-non-ga-tools, чтобы использовать их.

Набор инструментов Aura Experts

Для полной документации см. Использование инструментов миграции Aura-to-LWC в Руководстве разработчика Lightning Web Components.

• create_aura_blueprint_draft (GA) - Создает комплексный черновик документа требований к продукту (PRD) для миграции компонентов Aura. Анализирует файлы компонентов Aura и генерирует независимые от фреймворка спецификации, подходящие для миграции LWC, включая бизнес-требования, технические шаблоны и рекомендации по миграции.

• enhance_aura_blueprint_draft (GA) - Улучшает существующий черновик PRD с помощью экспертного анализа и разрешения неизвестных. Принимает черновик и применяет специализированные знания эксперта Aura для разрешения зависимостей, добавления технических идей и улучшения спецификаций миграции для лучшего руководства по реализации LWC.

• orchestrate_aura_migration (GA) - Оркестрирует полный рабочий процесс миграции Aura в LWC. Предоставляет сквозное руководство для всего процесса миграции, от начального анализа до финальной реализации, включая лучшие практики, рекомендации по инструментам и шаги по обеспечению качества.

• transition_prd_to_lwc (GA) - Предоставляет руководство по миграционному мосту для создания компонентов LWC из спецификаций Aura. Принимает улучшенный PRD и генерирует конкретные инструкции по реализации, сопоставления платформенных сервисов и пошаговые инструкции для создания эквивалентного компонента LWC.

Набор инструментов Code Analysis

Для полной документации, см. Использование MCP-инструментов для анализа вашего кода в Руководстве разработчика Salesforce Code Analyzer.

• create-custom-rule (NON-GA) - Создает пользовательское правило PMD на основе XPath из предоставленного образца кода Apex.

• describe_code_analyzer_rule (GA) - Получает описание правила Code Analyzer.

• generate_xpath_prompt (NON-GA) - Создает подсказку, которая направляет создание XPath из контекста AST. Вызывается при создании пользовательского правила PMD на основе XPath.

• list_code_analyzer_rules (GA) - Выбирает правила Code Analyzer по ряду критериев.

• query_code_analyzer_results (GA) - Запрашивает JSON-файл результатов Code Analyzer и возвращает отфильтрованные нарушения. Поддерживает фильтры, такие как серьезность, категория/тег, движок, правило и имя файла, а также top-N и сортировку. Используйте это после запуска run_code_analyzer для чтения сгенерированного файла результатов. После завершения этот инструмент суммирует и объяснит отфильтрованные результаты пользователю.

• run_code_analyzer (GA) - Выполняет статический анализ кода. Этот инструмент может проверить соответствие кода лучшим практикам, проверить уязвимости безопасности и выявить возможные проблемы производительности. Возвращает JSON, содержащий абсолютный путь к файлу результатов, если такой файл был создан, и строку, указывающую на общий успех или неудачу операции.

Набор инструментов Core (всегда включен)

Для примеров подсказок, которые вызывают основные инструменты DX MCP, см. Использование основных инструментов Salesforce DX MCP в Руководстве разработчика Salesforce DX.

• get_username (GA) - Определяет подходящее имя пользователя или псевдоним для операций Salesforce, обрабатывая как организации по умолчанию, так и Dev Hubs.

• resume_tool_operation (GA) - Возобновляет длительную операцию, которая не была завершена другим инструментом.

Набор инструментов Data

Для примеров подсказок, которые вызывают основные инструменты DX MCP, см. Использование основных инструментов Salesforce DX MCP в Руководстве разработчика Salesforce DX.

• run_soql_query (GA) - Выполняет SOQL-запрос к организации Salesforce.

Набор инструментов DevOps Center

Для полной документации, см. Разрешение конфликтов слияния с помощью MCP-инструментов DevOps Center (Managed Package) в справке Salesforce.

• check_devops_center_commit_status (GA) — Проверяет текущий статус элемента работы, зафиксированного в DevOps Center.

• checkout_devops_center_work_item (GA) — Переключается на ветку, связанную с выбранным элементом работы, по имени.

• commit_devops_center_work_item (GA) — Фиксирует изменения проекта DX и регистрирует SHA коммита в DevOps Center.

• create_devops_center_pull_request (GA) — Фиксирует локальные изменения в ветке элемента работы DevOps Center.

• detect_devops_center_merge_conflict (GA) — Определяет конфликты слияния для выбранного элемента работы или в указанной ветке.

• list_devops_center_projects (GA) — Выводит список всех проектов DevOps Center в конкретной организации.

• list_devops_center_work_items (GA) — Выводит список всех элементов работы для конкретного проекта DevOps Center.

• create_devops_center_work_item (GA) — Создает новый элемент работы DevOps Center в выбранном проекте.

• update_devops_center_work_item_status (GA) — Устанавливает статус элемента работы «In Progress» или «Ready to Promote».

• promote_devops_center_work_item (GA) — Переводит одобренный элемент работы на следующий этап конвейера DevOps Center.

• resolve_devops_center_deployment_failure (GA) — Диагностирует и устраняет сбои развертывания.

• resolve_devops_center_merge_conflict (GA) — Применяет выбранный метод разрешения конфликта слияния.

Инструментальный набор Enrichment

• enrich_metadata (NON-GA) — Обогащает метаданные из вашей организации в вашем проекте DX.

Инструментальный набор экспертов Lightning Web Components (LWC)

Полную документацию см. в разделе Use DX MCP Tools for LWC руководства Lightning Web Components Developer Guide.

Разработка компонентов

• create_lwc_component_from_prd (GA) — Создает компонент LWC из PRD, следуя рекомендациям по структуре файлов и коду.

• create_lwc_jest_test (GA) — Генерирует тесты Jest для компонентов LWC с покрытием и моками.

• review_lwc_component (GA) — Проводит ревью компонентов LWC, проверяя соответствие лучшим практикам и требованиям производительности.

Стилизация и дизайн

• apply_lwc_styling (GA) — Применяет рекомендации по стилизации Lightning Web Components с использованием Design Tokens и Lightning Design System.

• review_lwc_styling (GA) - Проверяет LWC-компоненты на соответствие рекомендациям по стилизации SLDS и Lightning Design System.

• use_lwc_styling_hooks (GA) — Применяет стилизующие хуки SLDS в LWC-компонентах.

Экспертные инструменты

• expert_lwc_lint (GA) — Запускает расширенную проверку LWC-кода с маршрутизацией ошибок и плагинами сообщества для выявления распространенных проблем.

• expert_generate_test (GA) — Создает модульные тесты, утверждения и макеты для файлов исходного кода.

• expert_review_code (GA) — Выполняет обзор архитектуры кода и потенциальных уязвимостей в выбранных исходных файлах.

Lightning Flow Toolset

• analyze_flow_health (GA) - Дает расширенные метрики здоровья и связанные контекстные рекомендации для потоков в вашей организации.

• create_flow_metadata (GA) - Создает точные Flow-метаданные с надлежащим охватом всех API-версий.

• extract_flow_model (GA) - Извлекает все компоненты указанного потока и возвращает структурированную модель потока.

• fetch_flow_metadata (GA) - Получает метаданные потока из организации.

• fix_flow_metadata (GA) - Вносит исправления в файл метаданных потока и выводит результат. Используется для исправления ошибок проверки метаданных, таких как неверные ссылки на API getName.

• locate_flow_metadata (GA) - Находит метаданные потока и возвращает их полный путь.

• review_flow_metadata (GA) - Проводит проверку метаданных потока на соответствие лучшим практикам и потенциальные проблемы.

• search_flow_metadata (GA) - Ищет метаданные потока по шаблону поиска.

Специализированные инструменты

• get_lightning_test_services_context (GA) - Получает информацию для Lightning Test Services.

• validate_agent_definition (GA) - Проверяет агента Agentforce и возвращает список проблем.

• create_agent (GA) - Создает агента Agentforce в выбранной организации.

• replay_event_log_files (GA) - Воспроизводит файлы журнала событий Salesforce для целей отладки.

DevOps Center Toolset

Для получения полной документации см. DevOps Center MCP Tools в Руководстве разработчика DevOps Center.

• create_org_snapshot (NON-GA) — Создать снимок scratch org.

• create_scratch_org (NON-GA) — Создать scratch org.

• delete_org (NON-GA) — Удалить локально авторизованную Salesforce scratch org или песочницу.

• list_all_orgs (GA) — Перечислить все настроенные Salesforce org, с опциональной проверкой статуса подключения.

• open_org (NON-GA) — Открыть org в браузере.

Набор инструментов Scale Products

Полную документацию см. в README в подкаталоге mcp-provider-scale-products.

• scan_apex_class_for_antipatterns (GA) — Анализирует файлы классов Apex на предмет антипаттернов производительности и дает рекомендации по их исправлению.

Набор инструментов тестирования

Примеры подсказок для вызова основных инструментов DX MCP см. в Использование основных инструментов Salesforce DX MCP в Salesforce DX Developer Guide.

• run_agent_test (GA) — Выполняет агентные тесты в вашем org.

• run_apex_test (GA) — Выполняет тесты Apex в вашем org.

Набор инструментов для пользователей

Примеры подсказок для вызова основных инструментов DX MCP см. в Использование основных инструментов Salesforce DX MCP в Salesforce DX Developer Guide.

• assign_permission_set (GA) — Назначает набор разрешений пользователю или от имени другого пользователя.