Integracja z serwerem Salesforce MCP

Do czego służy serwer “Salesforce” MCP?

Serwer Salesforce MCP to implementacja protokołu Model Context Protocol (MCP), która łączy asystentów AI, takich jak Claude, z Salesforce. Umożliwia interakcje w języku naturalnym z danymi i metadanymi Salesforce, pozwalając użytkownikom na zapytania, modyfikowanie i zarządzanie obiektami oraz rekordami Salesforce w sposób bezproblemowy. Dzięki udostępnieniu potężnych API Salesforce przez standardowe narzędzia MCP, serwer umożliwia klientom AI wykonywanie zapytań do bazy danych, zarządzanie obiektami, obsługę kodu Apex i automatyzację przepływów pracy bezpośrednio w środowisku deweloperskim. Programiści zyskują usprawniony dostęp do zasobów Salesforce, większą wydajność i możliwość budowania solidnych integracji oraz automatyzacji opartych na AI na różnych platformach.

Lista promptów

Brak jawnie zdefiniowanych szablonów promptów w repozytorium.

Lista zasobów

Brak jawnie zdefiniowanych zasobów MCP w repozytorium.

Lista narzędzi

• salesforce_search_objects
  Wyszukiwanie standardowych i niestandardowych obiektów w Salesforce na podstawie częściowej nazwy.
• salesforce_describe_object
  Pobieranie szczegółowych informacji o schemacie obiektu, w tym pól, relacji i list wyboru.
• salesforce_query_records
  Zapytania do rekordów z obsługą relacji i złożonych warunków.
• salesforce_aggregate_query
  Wykonywanie zapytań agregujących z GROUP BY, HAVING i różnymi funkcjami agregującymi.
• salesforce_dml_records
  Wstawianie, aktualizacja, usuwanie lub upsert rekordów Salesforce.
• salesforce_manage_object
  Tworzenie i modyfikacja niestandardowych obiektów oraz ustawianie ich właściwości.
• salesforce_manage_field
  Dodawanie lub modyfikacja niestandardowych pól, w tym relacyjnych oraz uprawnień dostępu.
• salesforce_manage_field_permissions
  Nadawanie/odbieranie/czytanie uprawnień do pól na poziomie profilu.
• salesforce_search_all
  Wyszukiwanie w wielu obiektach Salesforce przy użyciu zapytań SOSL.
• salesforce_read_apex
  Odczyt klas Apex, listowanie po wzorcu oraz pobieranie ich kodu źródłowego i metadanych.
• salesforce_write_apex
  Tworzenie lub aktualizacja klas Apex z określonym kodem i wersjami API.
• salesforce_read_apex_trigger
  Odczyt wyzwalaczy Apex, listowanie i pobieranie ich metadanych/kodu źródłowego.
• salesforce_write_apex_trigger
  Tworzenie lub aktualizacja wyzwalaczy Apex dla wybranych obiektów, z określeniem zdarzeń i wersji API.
• salesforce_execute_anonymous
  Wykonywanie anonimowego kodu Apex oraz podgląd logów debugowania i wyników.

Przykładowe zastosowania tego serwera MCP

• Zarządzanie bazą danych Salesforce
  Wykonywanie operacji CRUD na rekordach Salesforce, usprawnienie manipulacji danymi i automatyzacja powtarzalnych zadań za pomocą instrukcji AI.
• Eksploracja schematów i metadanych
  Szybkie pobieranie schematów obiektów, szczegółów pól i relacji, co pomaga w budowaniu integracji lub zrozumieniu złożonych struktur organizacji.
• Zaawansowane raportowanie i agregacja
  Wykonywanie zapytań agregujących do generowania podsumowań, analiz oraz filtrowania grupowanych wyników, wspierając potrzeby analityki biznesowej.
• Zarządzanie kodem Apex i wyzwalaczami
  Odczyt, tworzenie i aktualizacja klas lub wyzwalaczy Apex bezpośrednio z poziomu środowiska deweloperskiego, przyspieszając wdrażanie i utrzymanie.
• Wyszukiwanie między obiektami i odkrywanie danych
  Wykorzystanie wyszukiwania SOSL do odnajdywania informacji w wielu obiektach, co ułatwia lokalizację rekordów i relacji w dużych organizacjach Salesforce.

Jak skonfigurować

Windsurf

1. Upewnij się, że Node.js jest zainstalowany na Twoim systemie.
2. Zainstaluj serwer Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Zlokalizuj plik konfiguracyjny Windsurf (np. windsurf.config.json).
4. Dodaj serwer Salesforce MCP, używając poniższego fragmentu JSON:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Zapisz plik i uruchom ponownie Windsurf.
6. Zweryfikuj uruchomienie serwera w panelu MCP.

Claude

1. Upewnij się, że Node.js jest zainstalowany.
2. Zainstaluj serwer Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Edytuj plik konfiguracyjny integracji Claude.
4. Dodaj poniższą sekcję do mcpServers:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Zapisz i uruchom ponownie Claude.
6. Potwierdź dostępność Salesforce MCP w swoim workspace Claude.

Cursor

1. Zainstaluj Node.js.
2. Zainstaluj Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Otwórz plik konfiguracyjny Cursor.
4. Dodaj serwer Salesforce MCP jak poniżej:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Zapisz zmiany i uruchom ponownie Cursor.
6. Przetestuj połączenie z serwerem w panelu integracji MCP.

Cline

1. Upewnij się, że Node.js jest zainstalowany.
2. Zainstaluj pakiet:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Znajdź i otwórz plik konfiguracyjny Cline.
4. Wstaw serwer Salesforce MCP:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Zapisz i uruchom ponownie Cline.
6. Sprawdź status serwera MCP w menu narzędzi.

Zabezpieczanie kluczy API:
Zawsze używaj zmiennych środowiskowych do wrażliwych danych. W konfiguracji dodaj wymagane pola do obiektu env jak pokazano powyżej.
Aby przekazać dodatkowe dane wejściowe, możesz użyć:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "mcp-server-salesforce",
      "args": [],
      "env": {
        "SALESFORCE_CLIENT_ID": "your-client-id"
      },
      "inputs": {
        "instanceUrl": "https://your-instance.salesforce.com"
      }
    }
  }
}

Jak używać tego MCP w przepływach

Użycie MCP w FlowHunt

Aby zintegrować serwery MCP w swoim przepływie FlowHunt, zacznij od dodania komponentu MCP do przepływu i połącz go z agentem AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracji. W sekcji konfiguracji systemu MCP wprowadź dane serwera MCP w takim formacie JSON:

{
  "salesforce-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po skonfigurowaniu agent AI może korzystać z tego MCP jako narzędzia z dostępem do wszystkich jego funkcji i możliwości. Pamiętaj, by zmienić “salesforce-mcp” na właściwą nazwę serwera MCP oraz podmienić URL na własny adres serwera MCP.

Podsumowanie

Między tymi dwoma tabelami serwer Salesforce MCP oferuje świetną dokumentację narzędzi i konfiguracji, lecz brakuje dokumentacji szablonów promptów, zasobów, rootów czy sampling. Jego mocną stroną jest rozbudowany zestaw narzędzi Salesforce oraz jasne instrukcje konfiguracji. Na tej podstawie oceniam repozytorium na 7/10 pod względem praktycznej integracji MCP i wygody dla deweloperów.

Ocena MCP