salesforce_mcp

MCP Salesforce – Twój inteligentny asystent CRM

Otwarte i darmowe

Wtyczka MCP do Salesforce – Twój inteligentny asystent CRM

Ta wtyczka pozwala Twojemu asystentowi AI bezpośrednio pracować na danych i ustawieniach w systemie Salesforce. Dzięki niej możesz wyszukiwać informacje, zarządzać uprawnieniami i sprawdzać konfiguracje z poziomu czatu. Oszczędzasz czas, bo sztuczna inteligencja wykonuje za Ciebie skomplikowane operacje. To idealne rozwiązanie dla administratorów i programistów Salesforce.

Możliwości i narzędzia wtyczki (Toolsets)

Wtyczka posiada potężny zestaw funkcji, podzielonych na kategorie. Oto wszystkie dostępne narzędzia:
Podstawowe (Core) i Dane (Data)
  • get_username – Znajduje odpowiednią nazwę użytkownika do wykonania zadania.
  • resume_tool_operation – Wznawia operację, która wymagała więcej czasu na ukończenie.
  • run_soql_query – Pozwala na przeszukiwanie bazy danych Salesforce za pomocą zapytań tekstowych.
Zarządzanie kontami (Orgs) i Użytkownikami (Users)
  • list_all_orgs – Pokazuje listę wszystkich Twoich połączonych środowisk Salesforce.
  • open_org – Otwiera wybrane środowisko Salesforce bezpośrednio w Twojej przeglądarce.
  • create_scratch_org – Tworzy szybkie środowisko testowe do sprawdzania nowych funkcji.
  • create_org_snapshot – Zapisuje kopię (stan) Twojego środowiska testowego.
  • delete_org – Usuwa wybrane środowisko testowe z Twojego systemu.
  • assign_permission_set – Nadaje wybranemu użytkownikowi konkretny pakiet uprawnień.
Ustawienia (Metadata) i Testowanie (Testing)
  • deploy_metadata – Wysyła nowe pliki z ustawieniami z Twojego komputera do Salesforce.
  • retrieve_metadata – Pobiera aktualne pliki z ustawieniami z Salesforce na Twój dysk.
  • run_apex_test – Uruchamia testy automatyczne kodu w Salesforce, aby sprawdzić, czy działa poprawnie.
  • run_agent_test – Sprawdza i testuje działanie asystentów (agentów) w Twoim środowisku.
Analiza kodu (Code Analysis) i Wydajność (Scale Products)
  • run_code_analyzer – Skanuje Twój kod w poszukiwaniu błędów i luk bezpieczeństwa.
  • query_code_analyzer_results – Wyświetla i tłumaczy wyniki skanowania z poprzedniego narzędzia.
  • list_code_analyzer_rules – Pokazuje reguły i zasady, według których sprawdzany jest kod.
  • describe_code_analyzer_rule – Tłumaczy szczegóły konkretnej reguły sprawdzającej.
  • scan_apex_class_for_antipatterns – Szuka błędów spowalniających działanie systemu i podpowiada, jak je naprawić.
Funkcje Mobilne (Mobile)
  • create_mobile_lwc_barcode_scanner – Pomaga stworzyć funkcję skanera kodów kreskowych w aplikacji.
  • create_mobile_lwc_biometrics – Pomaga wdrożyć logowanie odciskiem palca lub twarzą.
  • create_mobile_lwc_location – Podpowiada, jak używać danych o lokalizacji (GPS) użytkownika.
  • get_mobile_lwc_offline_analysis – Sprawdza, czy Twoja aplikacja zadziała bez dostępu do internetu.
  • get_mobile_lwc_offline_guidance – Daje instrukcje, jak naprawić błędy działania bez internetu.
  • create_mobile_lwc_ar_space_capture – Dodaje obsługę rozszerzonej rzeczywistości (AR).
  • create_mobile_lwc_calendar – Pomaga zintegrować aplikację z kalendarzem na telefonie.
  • create_mobile_lwc_contacts – Pozwala na zarządzanie książką adresową telefonu.
  • create_mobile_lwc_document_scanner – Ułatwia dodanie funkcji skanowania dokumentów.
  • create_mobile_lwc_geofencing – Pomaga tworzyć wirtualne granice na mapie (geofencing).
  • create_mobile_lwc_nfc – Pomaga obsłużyć płatności lub tagi NFC z telefonu.
  • create_mobile_lwc_payments – Podpowiada, jak wdrożyć płatności mobilne.
  • create_mobile_lwc_app_review – Uczy, jak dodać prośbę o ocenę aplikacji w sklepie.
Zarządzanie projektami (DevOps Center)
  • list_devops_center_projects – Pokazuje wszystkie projekty prowadzone w Twoim dziale IT.
  • list_devops_center_work_items – Wyświetla listę zadań do zrobienia w konkretnym projekcie.
  • check_devops_center_commit_status – Sprawdza status zapisania Twojej pracy w projekcie.
  • checkout_devops_center_work_item – Pobiera pliki powiązane z konkretnym zadaniem.
  • commit_devops_center_work_item – Zapisuje Twoje zmiany i łączy je z zadaniem.
  • create_devops_center_pull_request – Zgłasza Twoje poprawki do wglądu przez innych.
  • detect_devops_center_merge_conflict – Ostrzega, gdy Twoje zmiany kłócą się ze zmianami innej osoby.
  • resolve_devops_center_merge_conflict – Pomaga automatycznie rozwiązać te konflikty w plikach.
  • promote_devops_center_work_item – Przesuwa zatwierdzone zadanie do kolejnego etapu realizacji.
Ekspert od tworzenia interfejsów (LWC i Aura Experts)
  • create_lwc_component_from_prd – Tworzy gotowy kod elementu wizualnego na podstawie Twojego opisu.
  • create_lwc_jest_tests – Automatycznie generuje testy dla utworzonych widoków.
  • review_lwc_jest_tests – Ocenia i poprawia napisane testy widoków.
  • guide_lwc_best_practices – Udziela rad, jak poprawnie pisać kod dla widoków Salesforce.
  • guide_lwc_accessibility – Sprawdza, czy Twój interfejs jest przyjazny dla osób z niepełnosprawnościami.
  • guide_lwc_security – Wykonuje audyt bezpieczeństwa Twoich widoków.
  • create_aura_blueprint_draft – Analizuje stary system widoków (Aura) i przygotowuje plan przenosin na nowy (LWC).
  • enhance_aura_blueprint_draft – Ulepsza wstępny plan przenosin o opinie eksperckie.
  • orchestrate_aura_migration – Krok po kroku prowadzi Cię przez proces zmiany systemu na nowszy.
  • transition_prd_to_lwc – Tworzy instrukcje dla programistów na podstawie przygotowanego planu.
ℹ️ Info: Serwer ten wymaga od Ciebie podania odpowiednich flag podczas konfiguracji. Oznacza to, że możesz włączyć tylko te pakiety narzędzi (toolsets), których naprawdę potrzebujesz, aby nie przeciążać pamięci AI.

Jak ta wtyczka działa w praktyce?

Działanie wtyczki opiera się na bezpośrednim połączeniu z Twoim kontem w systemie. Nie musisz ręcznie „wyklikiwać” zmian w skomplikowanym panelu Salesforce. Ty piszesz polecenie w czacie AI → AI używa wtyczki MCP → wtyczka wysyła komendę do Twojego konta Salesforce → AI podaje Ci wynik na tacy.

Praktyczne przykłady użycia:

  • Szybkie przeszukiwanie danych: Zamiast szukać w tabelach, prosisz AI: „Znajdź mi wszystkich klientów w Salesforce z Warszawy” i od razu dostajesz listę.
  • Oszczędność czasu w nadawaniu ról: Piszesz: „Nadaj uprawnienia administratora dla konta Jan Kowalski”. AI robi to w ułamek sekundy za pomocą narzędzia assign_permission_set.
  • Tworzenie środowisk testowych: Mówisz asystentowi: „Stwórz nowe środowisko testowe do sprawdzenia kampanii marketingowej”. Wtyczka generuje nowe tzw. „scratch org” gotowe do pracy.
💡 Wskazówka: Możesz dostosować, które funkcje są włączone. Jeśli interesuje Cię tylko przeszukiwanie bazy, włączysz jedynie moduł „Data”, co sprawi, że sztuczna inteligencja będzie odpowiadać dużo szybciej.

Instalacja połączenia Salesforce w Twoim AI

Wtyczka wymaga instalacji lokalnej. Pliki z ustawieniami są przechowywane na Twoim komputerze. Konieczne jest też posiadanie narzędzia systemowego npx oraz autoryzacja konta Salesforce z poziomu terminala.

Przygotowanie (Wymagane!)

  1. Upewnij się, że masz zainstalowane środowisko Node.js (które zawiera polecenie npx).
  2. Upewnij się, że posiadasz narzędzie Salesforce CLI.
  3. Otwórz okno poleceń / terminal i zaloguj się do swojego Salesforce komendą:
    sfdx force:auth:web:login

Instalacja w Claude Desktop

  1. Otwórz ustawienia w aplikacji Claude Desktop, przechodząc do Settings -> Developer.
  2. Kliknij Edit Config, aby otworzyć plik z ustawieniami w formacie JSON.
  3. Dopisz poniższy kod do swojego pliku:
    {
    "mcpServers": {
    "Salesforce DX": {
    "command": "npx",
    "args": [
    "-y", "@salesforce/mcp",
    "--orgs", "DEFAULT_TARGET_ORG",
    "--toolsets", "data,orgs,users",
    "--allow-non-ga-tools"
    ]
    }
    }
    }
  4. Zapisz plik i uruchom ponownie aplikację Claude Desktop.

Instalacja w aplikacjach kodujących (Cursor / Windsurf)

  1. W swoim folderze roboczym (projekcie) utwórz plik z ustawieniami o nazwie mcp.json (lub edytuj istniejący).
  2. Wklej do niego poniższy fragment kodu:
    {
    "mcpServers": {
    "Salesforce DX": {
    "command": "npx",
    "args": [
    "-y", "@salesforce/mcp@latest",
    "--orgs", "DEFAULT_TARGET_ORG",
    "--toolsets", "data,orgs,users"
    ]
    }
    }
    }
  3. Zapisz plik. Twoje środowisko automatycznie wykryje nowe połączenie z Salesforce.
⚠️ Uwaga: W powyższym kodzie w linijce --toolsets użyliśmy modułów “data,orgs,users”. Możesz tam dopisać inne moduły z listy w pierwszej zakładce, oddzielając je przecinkiem (np. “metadata,testing”).

Rozwiązywanie problemów

  • AI mówi, że nie widzi konta Salesforce: Upewnij się, że poprawnie zalogowałeś się w swoim terminalu za pomocą komendy z pierwszego etapu instalacji.
  • Błąd „command npx not found”: Twój komputer nie ma zainstalowanego narzędzia Node.js. Pobierz je z internetu i zainstaluj, a następnie zrestartuj komputer.
  • Zbyt długa odpowiedź AI: Wtyczka ma ponad 60 narzędzi. Sprawdź plik z ustawieniami i upewnij się, że w --toolsets wpisane są tylko moduły, których naprawdę używasz (unikaj wpisywania słowa “all”).

Często zadawane pytania (FAQ)

Czy potrzebuję specjalisty IT do uruchomienia tej wtyczki?

Do samej instalacji przydadzą się podstawowe umiejętności edycji plików z ustawieniami (JSON) oraz zalogowanie się z poziomu czarnego okienka (terminala). Później, w codziennym użytku, wszystko obsługujesz już po prostu rozmawiając z AI.

Czy wtyczka wyciągnie poufne dane z mojego Salesforce?

Nie. Asystent ma dostęp tylko do tego konta i tych informacji, do których Ty masz uprawnienia jako zalogowany użytkownik. Narzędzie jest oficjalnym produktem w fazie Beta od firmy Salesforce i spełnia wysokie wymogi bezpieczeństwa.

Co oznacza flaga „allow-non-ga-tools”?

Oznacza to „zezwól na narzędzia w wersji testowej”. Część możliwości tej wtyczki nie jest jeszcze oficjalnie i w pełni udostępniona (tzw. General Availability). Dodanie tego parametru do kodu pozwala Ci testować najnowsze funkcje przed innymi.

Czy wtyczka obsługuje język polski?

Z asystentem AI możesz rozmawiać i wydawać mu polecenia całkowicie po polsku. Należy jednak pamiętać, że nazwy narzędzi oraz elementy ustawień konfiguracyjnych w samym systemie Salesforce są z reguły anglojęzyczne.

SZYBKA INSTALACJA


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