MCP do Salesforce – Twój inteligentny asystent CRM

Opis
Działanie
Instalacja
FAQ

Salesforce DX MCP Server – opis

Salesforce DX MCP Server to serwer MCP, który łączy Twojego asystenta AI z Salesforce. Dzięki tej wtyczce MCP możesz pozwolić AI czytać, sprawdzać i zarządzać zasobami Salesforce. Serwer działa jako bezpieczne połączenie między AI a Twoją organizacją w Salesforce.

ℹ️ Info: Serwer wymaga wskazania co najmniej jednej lokalnie autoryzowanej organizacji Salesforce.

Dostępne zestawy narzędzi

Serwer grupuje funkcje w zestawy narzędzi. Możesz włączyć wszystkie zestawy albo tylko te, których potrzebujesz.

all – włącza wszystkie dostępne narzędzia ze wszystkich zestawów.
aura-experts – pomaga analizować komponenty Aura i planować migrację do LWC.
code-analysis – pozwala analizować kod przez Salesforce Code Analyzer.
core – zawiera podstawowe narzędzia serwera, zawsze włączone.
data – pozwala zarządzać danymi w organizacji Salesforce.
devops – obsługuje zasoby Salesforce DevOps Center.
enrichment – wzbogaca metadane w projekcie DX.
experts-validation – sprawdza komponenty LWC pod kątem gotowości produkcyjnej.
lwc-experts – wspiera tworzenie, testowanie i optymalizację komponentów LWC.
metadata – obsługuje pobieranie i wdrażanie metadanych Salesforce.
mobile – wspiera funkcje mobilne w komponentach LWC.
mobile-core – zawiera podstawowe narzędzia mobilne.
orgs – pomaga zarządzać autoryzowanymi organizacjami Salesforce.
scale-products – pomaga wykrywać problemy wydajnościowe w Apex.
testing – pozwala uruchamiać testy w Salesforce.
users – pozwala zarządzać uprawnieniami użytkowników Salesforce.

Narzędzia: Aura Experts

create_aura_blueprint_draft – tworzy roboczy dokument PRD dla migracji komponentu Aura.
enhance_aura_blueprint_draft – ulepsza roboczy PRD o analizę ekspercką i zależności.
orchestrate_aura_migration – prowadzi cały proces migracji z Aura do LWC.
transition_prd_to_lwc – zamienia ulepszony PRD na wskazówki wdrożenia komponentu LWC.

Narzędzia: Code Analysis

create-custom-rule – tworzy własną regułę PMD XPath na podstawie przykładu kodu Apex.
describe_code_analyzer_rule – pobiera opis wybranej reguły Code Analyzer.
generate_xpath_prompt – buduje prompt pomocny przy tworzeniu reguły XPath.
list_code_analyzer_rules – wybiera reguły Code Analyzer według podanych kryteriów.
query_code_analyzer_results – filtruje wyniki analizy kodu zapisane w pliku JSON.
run_code_analyzer – analizuje kod pod kątem dobrych praktyk, bezpieczeństwa i wydajności.

Narzędzia: Core

get_username – ustala właściwą nazwę użytkownika lub alias dla operacji Salesforce.
resume_tool_operation – wznawia długą operację, której inne narzędzie nie zakończyło.

Narzędzia: Data

run_soql_query – uruchamia zapytanie SOQL w wybranej organizacji Salesforce.

Narzędzia: DevOps Center

check_devops_center_commit_status – sprawdza status elementu pracy zatwierdzonego w DevOps Center.
checkout_devops_center_work_item – pobiera gałąź powiązaną z wybranym elementem pracy.
commit_devops_center_work_item – zapisuje zmiany projektu SFDX i rejestruje commit w DevOps Center.
create_devops_center_pull_request – tworzy pull request dla zmian z lokalnego elementu pracy.
detect_devops_center_merge_conflict – wykrywa konflikty scalania dla elementu pracy lub gałęzi.
list_devops_center_projects – wyświetla projekty DevOps Center w konkretnej organizacji.
list_devops_center_work_items – wyświetla elementy pracy dla wybranego projektu DevOps Center.
create_devops_center_work_item – tworzy nowy element pracy w wybranym projekcie.
update_devops_center_work_item_status – zmienia status elementu pracy na In Progress lub Ready to Promote.
promote_devops_center_work_item – promuje zatwierdzony element pracy do następnego etapu procesu.
resolve_devops_center_deployment_failure – diagnozuje i pomaga rozwiązać błędy wdrożenia.
resolve_devops_center_merge_conflict – stosuje wybraną metodę rozwiązania konfliktu scalania.

Narzędzia: Enrichment

enrich_metadata – wzbogaca metadane z organizacji Salesforce w Twoim projekcie DX.

Narzędzia: LWC Experts

Tworzenie komponentów

create_lwc_component_from_prd – tworzy kompletne komponenty LWC na podstawie specyfikacji PRD.
create_lwc_jest_tests – generuje testy Jest dla komponentów LWC.
review_lwc_jest_tests – sprawdza i ocenia testy Jest dla komponentów LWC.

Wytyczne rozwojowe

create_lightning_type – daje wskazówki do tworzenia Custom Lightning Types.
explore_slds_blueprints – pobiera specyfikacje SLDS według nazwy, kategorii lub klasy CSS.
guide_design_general – podaje wytyczne SLDS dla dostępności i responsywnego projektu.
guide_component_accessibility – podaje zasady dostępności i testowania komponentów LWC.
guide_lwc_best_practices – opisuje dobre praktyki i standardy kodowania LWC.
guide_lwc_development – prowadzi przez proces tworzenia komponentów LWC.
guide_lwc_rtl_support – podaje wskazówki dla języków pisanych od prawej do lewej.
guide_lws_security – analizuje bezpieczeństwo zgodnie z Lightning Web Security.
guide_slds_blueprints – udostępnia wytyczne i indeks blueprintów SLDS.
guide_utam_generation – podaje wytyczne generowania obiektów stron UTAM.
lwc-doc-error – pobiera informacje o błędach LWC i sposobach ich rozwiązania.
reference_lwc_compilation_error – wyjaśnia błędy kompilacji LWC na podstawie kodów błędów.
guide_slds_styling – pobiera wskazówki dotyczące stylowania SLDS.
explore_slds_styling – wyszukuje haki stylowania SLDS według różnych wzorców.
guide_lbc_usage – pokazuje indeks komponentów Lightning Base Components z krótkimi opisami.
explore_lbc_components – pobiera pełną dokumentację API wskazanych komponentów Lightning Base Components.

Lightning Data Service

create_lds_graphql_mutation_query – pomaga tworzyć zapytania GraphQL do zmiany danych.
create_lds_graphql_read_query – tworzy zapytania GraphQL do odczytu danych LDS.
explore_lds_uiapi – opisuje możliwości UI API dla Lightning Design System.
fetch_lds_graphql_schema – pobiera strukturę schematu GraphQL dla LDS.
guide_lds_data_consistency – podaje wzorce spójności danych dla komponentów LDS.
guide_lds_development – podaje wytyczne rozwoju i integracji komponentów LDS.
guide_lds_graphql – opisuje wzorce użycia GraphQL w LDS.
guide_lds_referential_integrity – opisuje zasady spójnych powiązań danych w LDS.
orchestrate_lds_data_requirements – prowadzi analizę wymagań danych do formatu PRD.
test_lds_graphql_query – testuje zapytanie GraphQL na połączonej organizacji Salesforce.

Migracja i integracje

guide_figma_to_lwc_conversion – zamienia projekty Figma na specyfikacje komponentów LWC.
guide_lo_migration – pomaga przejść z Lightning Out beta do Lightning Out 2.0.
run_lwc_accessibility_jest_tests – dostarcza testy dostępności dla komponentów LWC w Jest.
verify_aura_migration_completeness – sprawdza kompletność migracji z Aura do LWC.

Procesy pracy

orchestrate_lwc_component_creation – prowadzi proces tworzenia komponentu LWC.
orchestrate_lwc_component_optimization – pomaga optymalizować wydajność komponentów LWC.
orchestrate_lwc_component_testing – prowadzi proces testowania i generowania testów LWC.
orchestrate_lwc_slds2_uplift – daje wskazówki migracji do SLDS 2.

Narzędzia: Experts Validation

validate_and_optimize – tworzy instrukcję walidacji dostępności, bezpieczeństwa i dobrych praktyk.
score_issues – wylicza wynik gotowości i ocenę jakości na podstawie problemów SARIF.

Narzędzia: Metadata

deploy_metadata – wdraża metadane z projektu DX do organizacji Salesforce.
retrieve_metadata – pobiera metadane z organizacji Salesforce do projektu DX.

Narzędzia: Mobile

create_mobile_lwc_app_review – daje dokumentację TypeScript dla LWC App Review Service.
create_mobile_lwc_ar_space_capture – daje dokumentację TypeScript dla LWC AR Space Capture.
create_mobile_lwc_barcode_scanner – daje wskazówki dla skanowania kodów kreskowych w LWC.
create_mobile_lwc_biometrics – daje wskazówki dla logowania biometrycznego w LWC.
create_mobile_lwc_calendar – daje wskazówki dla integracji kalendarza w LWC.
create_mobile_lwc_contacts – daje wskazówki dla obsługi kontaktów w LWC.
create_mobile_lwc_document_scanner – daje wskazówki dla skanowania dokumentów w LWC.
create_mobile_lwc_geofencing – daje wskazówki dla funkcji geofencingu w LWC.
create_mobile_lwc_location – daje wskazówki dla usług lokalizacji w LWC.
create_mobile_lwc_nfc – daje wskazówki dla obsługi NFC w LWC.
create_mobile_lwc_payments – daje wskazówki dla obsługi płatności w LWC.
get_mobile_lwc_offline_analysis – analizuje komponenty LWC pod kątem pracy mobilnej offline.
get_mobile_lwc_offline_guidance – podaje instrukcje naprawy problemów mobilnych offline w LWC.

Narzędzia: Mobile-core

create_mobile_lwc_barcode_scanner – daje podstawowe wskazówki dla skanowania kodów kreskowych.
create_mobile_lwc_biometrics – daje podstawowe wskazówki dla biometrii w aplikacjach mobilnych.
create_mobile_lwc_location – daje podstawowe wskazówki dla usług lokalizacji.
get_mobile_lwc_offline_analysis – analizuje podstawowe problemy pracy offline w komponentach mobilnych.
get_mobile_lwc_offline_guidance – podaje podstawowe instrukcje naprawy problemów offline.

Narzędzia: Orgs

create_org_snapshot – tworzy migawkę organizacji scratch org.
create_scratch_org – tworzy organizację scratch org.
delete_org – usuwa lokalnie autoryzowaną organizację scratch org lub sandbox.
list_all_orgs – wyświetla skonfigurowane organizacje Salesforce i może sprawdzić połączenie.
open_org – otwiera organizację Salesforce w przeglądarce.

Narzędzia: Scale Products

scan_apex_class_for_antipatterns – analizuje klasy Apex pod kątem problemów wydajnościowych.

Narzędzia: Testing

run_agent_test – uruchamia testy agentów w Twojej organizacji Salesforce.
run_apex_test – uruchamia testy Apex w Twojej organizacji Salesforce.

Narzędzia: Users

assign_permission_set – przypisuje zestaw uprawnień Tobie lub innej osobie w Salesforce.

⚠️ Uwaga: Część narzędzi ma status NON-GA. Aby ich używać, musisz włączyć flagę –allow-non-ga-tools.

Jak działa Salesforce DX MCP Server?

Salesforce DX MCP Server działa jako bezpieczne połączenie między Twoim asystentem AI a organizacją Salesforce. Najpierw konfigurujesz serwer w kliencie MCP, na przykład w ChatGPT, Claude, VS Code, Claude Code, Cursor albo Cline. W konfiguracji wskazujesz organizację Salesforce oraz zestawy narzędzi, z których AI może korzystać.

Prosty schemat działania

Ty wpisujesz polecenie w rozmowie z AI.
AI rozpoznaje, że potrzebuje dostępu do Salesforce.
Serwer MCP uruchamia odpowiednie narzędzie Salesforce DX.
Salesforce wykonuje operację w wybranej organizacji.
AI pokazuje Ci wynik w rozmowie.

ℹ️ Info: Serwer może działać tylko z organizacjami Salesforce, które wcześniej połączysz lokalnie na swoim komputerze.

Co ustawiasz w konfiguracji?

W pliku konfiguracyjnym MCP wskazujesz, jak serwer ma się uruchamiać. Najważniejsze ustawienia to organizacje Salesforce, zestawy narzędzi oraz pojedyncze narzędzia.

–orgs – wskazuje organizacje Salesforce, do których serwer może mieć dostęp.
–toolsets – wybiera grupy funkcji, na przykład dane, metadane, użytkowników lub testy.
–tools – pozwala włączyć konkretne narzędzia, na przykład samo uruchamianie testów Apex.
–allow-non-ga-tools – pozwala korzystać także z narzędzi, które nie są jeszcze ogólnie dostępne.
–debug – włącza logi diagnostyczne, jeśli Twój klient MCP je pokazuje.
–dynamic-tools – ładuje narzędzia dopiero wtedy, gdy są potrzebne.
–no-telemetry – wyłącza automatyczne zbieranie danych telemetrycznych.

💡 Wskazówka: Nie musisz włączać wszystkich narzędzi. Lepiej wybrać tylko te zestawy, których naprawdę używasz.

Jak wybierasz organizację Salesforce?

Serwer wymaga wskazania co najmniej jednej organizacji Salesforce. Możesz wybrać organizację domyślną, domyślny Dev Hub, konkretny alias albo wszystkie połączone organizacje.

DEFAULT_TARGET_ORG – używa Twojej domyślnej organizacji Salesforce.
DEFAULT_TARGET_DEV_HUB – używa Twojej domyślnej organizacji Dev Hub.
username lub alias – pozwala wskazać konkretną organizację.
ALLOW_ALL_ORGS – pozwala na dostęp do wszystkich połączonych organizacji.

⚠️ Uwaga: Opcji ALLOW_ALL_ORGS używaj ostrożnie, bo daje dostęp do wszystkich lokalnie połączonych organizacji Salesforce.

Przykład działania: testy Apex

Możesz poprosić AI o uruchomienie testów Apex w Twojej organizacji Salesforce. AI przekaże zadanie do serwera MCP, a ten użyje narzędzia run_apex_test. Po wykonaniu operacji zobaczysz wynik w rozmowie z AI. Dzięki temu nie musisz ręcznie przechodzić przez cały proces w narzędziach Salesforce DX.

Przykład działania: praca z metadanymi

Możesz użyć AI do pobierania albo wdrażania metadanych między projektem DX a organizacją Salesforce. Służą do tego narzędzia retrieve_metadata oraz deploy_metadata. To pomaga Ci pracować z konfiguracją Salesforce bez ręcznego wpisywania każdego polecenia. AI może uruchomić właściwą operację przez serwer MCP.

Przykład działania: analiza kodu

Możesz poprosić AI o sprawdzenie kodu pod kątem dobrych praktyk, bezpieczeństwa i wydajności. Serwer MCP może wtedy użyć narzędzia run_code_analyzer. Po analizie możesz dalej pracować z wynikami. Narzędzie query_code_analyzer_results pomaga filtrować znalezione problemy według kryteriów.

Przykład konfiguracji

Poniżej widzisz przykład konfiguracji dla klienta MCP. Włącza ona zestawy narzędzi dla organizacji, metadanych, danych i użytkowników oraz jedno konkretne narzędzie testowe.

{
  "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"
      ]
    }
  }
}

W praktyce oznacza to, że AI dostaje dostęp tylko do wskazanych obszarów Salesforce. Możesz więc ograniczyć zakres działania serwera do tego, czego faktycznie potrzebujesz.

Instalacja Salesforce DX MCP Server

Salesforce DX MCP Server instalujesz przez konfigurację klienta MCP, z którego korzystasz na co dzień. Najpierw łączysz swoją organizację Salesforce lokalnie na komputerze. Potem dodajesz serwer MCP do pliku konfiguracyjnego wybranego narzędzia.

Krok 1: Połącz organizację Salesforce

Serwer MCP wymaga dostępu do co najmniej jednej organizacji Salesforce. Musisz ją wcześniej autoryzować lokalnie na swoim komputerze. Możesz to zrobić przez Salesforce CLI:

org login web

Możesz też użyć VS Code i polecenia z palety komend:

SFDX: Authorize an Org

⚠️ Uwaga: Bez połączonej organizacji Salesforce narzędzia MCP nie będą miały dostępu do danych i zasobów Salesforce.

Instalacja w Claude Code

Aby używać Salesforce DX MCP Server w Claude Code, dodaj konfigurację do pliku .mcp.json w swoim projekcie.

{
  "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"
      ]
    }
  }
}

Ta konfiguracja uruchamia serwer przez npx. Włącza dostęp do domyślnej organizacji Salesforce oraz wybranych zestawów narzędzi.

Instalacja w Cline

Aby używać serwera w Cline, dodaj konfigurację do pliku cline_mcp_settings.json.

{
  "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"
      ]
    }
  }
}

W tym wariancie Cline pobiera najnowszą wersję pakietu @salesforce/mcp.

Instalacja w Cursor

Aby używać serwera w Cursor, dodaj konfigurację do pliku mcp.json Cursora.

{
  "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"
      ]
    }
  }
}

Po zapisaniu konfiguracji Cursor może korzystać z funkcji Salesforce przez serwer MCP.

Instalacja w VS Code z Copilot

W VS Code z Copilot utwórz lub zaktualizuj plik .vscode/mcp.json w swoim projekcie.

{
  "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"
      ]
    }
  }
}

Ten przykład włącza zestawy narzędzi: organizacje, metadane, dane i użytkowników. Dodatkowo włącza narzędzie run_apex_test.

Inne klienty MCP

Możesz też skonfigurować Salesforce DX MCP Server w Trae, Windsurf oraz Zed. W tych narzędziach używasz tego samego schematu konfiguracji. Różnić może się tylko nazwa i lokalizacja pliku konfiguracyjnego.

Najważniejsze ustawienia instalacji

-y – pozwala automatycznie zainstalować pakiet bez dodatkowego pytania.
@salesforce/mcp – uruchamia pakiet Salesforce DX MCP Server.
–orgs – wskazuje organizację Salesforce, z którą serwer ma pracować.
–toolsets – wybiera grupy funkcji, które chcesz włączyć.
–tools – pozwala dodać pojedyncze narzędzie poza zestawami.
–allow-non-ga-tools – włącza także narzędzia, które nie są jeszcze ogólnie dostępne.

Jak wybrać organizację Salesforce?

W ustawieniu –orgs możesz wskazać jedną lub więcej organizacji Salesforce. Jeśli podajesz kilka wartości, oddziel je przecinkami.

DEFAULT_TARGET_ORG – używa Twojej domyślnej organizacji Salesforce.
DEFAULT_TARGET_DEV_HUB – używa Twojej domyślnej organizacji Dev Hub.
username lub alias – używa konkretnej organizacji po nazwie lub aliasie.
ALLOW_ALL_ORGS – pozwala na dostęp do wszystkich lokalnie połączonych organizacji.

⚠️ Uwaga: Opcji ALLOW_ALL_ORGS używaj ostrożnie. Daje ona dostęp do wszystkich autoryzowanych organizacji Salesforce.

Co zrobić po dodaniu konfiguracji?

Zapisz plik konfiguracyjny wybranego klienta MCP.
Sprawdź, czy organizacja Salesforce jest lokalnie autoryzowana.
Uruchom ponownie klienta MCP, jeśli jest to wymagane.
Poproś AI o wykonanie operacji dostępnej w wybranych narzędziach.

💡 Wskazówka: Nie włączaj zestawu all, jeśli nie potrzebujesz wszystkich funkcji. Salesforce DX MCP Server ma ponad 60 narzędzi.

FAQ – Salesforce DX MCP Server

Do czego służy Salesforce DX MCP Server?

Salesforce DX MCP Server łączy Twojego asystenta AI z organizacją Salesforce. Dzięki temu możesz z poziomu rozmowy z AI uruchamiać wybrane operacje, na przykład testy, analizę kodu, pracę z metadanymi albo zarządzanie użytkownikami.

Czy musisz wcześniej połączyć konto Salesforce?

Tak. Musisz lokalnie autoryzować co najmniej jedną organizację Salesforce na swoim komputerze. Możesz to zrobić przez Salesforce CLI poleceniem org login web albo przez VS Code poleceniem SFDX: Authorize an Org.

Czy możesz ograniczyć, do czego AI ma dostęp?

Tak. W konfiguracji wybierasz konkretne organizacje Salesforce, zestawy narzędzi oraz pojedyncze funkcje. Dzięki temu AI korzysta tylko z tych obszarów, które mu udostępnisz.

Czym są zestawy narzędzi w Salesforce DX MCP Server?

Zestawy narzędzi to grupy funkcji podzielone według zastosowania. Możesz włączyć na przykład narzędzia do danych, metadanych, testów, użytkowników, DevOps Center albo komponentów LWC.

Czy warto włączać wszystkie narzędzia naraz?

Nie zawsze. Serwer ma ponad 60 narzędzi, więc włączenie wszystkiego może przeciążyć kontekst AI. Najlepiej wybierasz tylko te zestawy, których naprawdę potrzebujesz w swojej pracy.

Kompatybilne między innmi z:

SZYBKA INSTALACJA

Code

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

MCP Salesforce – Twój inteligentny asystent CRM

Sprzedaż