Salesforce MCP Server

resmi

Salesforce entegrasyonu OAuth2 kullanır. Yazma işlemleri entegrasyon gereği varsayılan olarak devre dışıdır. SOQL, SOSL, REST ve CRUD kapsayan, tek tek seçilebilir 700'den fazla araç. DataGrout hesabı gerektirir.

Salesforce MCP ile neler yapabilirsiniz?

  • SOQL ile CRM kayıtlarını sorgulayın — asistanınızdan, müşteri adaylarını, fırsatları, vakaları veya kampanyaları almak için bir salesforce@v1/soql@v1 SELECT sorgusu çalıştırmasını isteyin.
  • Herhangi bir Salesforce REST uç noktasını çağırın — asistanınıza, belirli bir REST API uç noktasından veri almak için salesforce@v1/rest@v1 kullanmasını söyleyin.
  • SOSL ile nesneler arasında arama yapın — asistanınızın, etkinleştirilmiş SOSL araçlarından birini kullanarak birden fazla CRM nesnesinde metin tabanlı bir arama yapmasını sağlayın.
  • CRM nesneleri üzerinde CRUD işlemleri gerçekleştirin — yazma erişimi araç başına açıkça etkinleştirildiğinde, asistanınız uygun CRUD araçları aracılığıyla kayıtlar oluşturabilir, güncelleyebilir veya silebilir.

Dokümantasyon

DataGrout'un Salesforce MCP Sunucusu, AI ajanlarını Salesforce'a OAuth2 üzerinden bağlar ve DataGrout'un uygulama kimlik bilgilerini veya kendi kimlik bilgilerinizi kullanır. Yazma işlemleri varsayılan olarak devre dışıdır ve her entegrasyon için açık yapılandırma gerektirir. 700'den fazla araç, CRM nesnelerini — potansiyel müşteriler, fırsatlar, vakalar, kampanyalar — SOQL, SOSL, REST ve CRUD aracılığıyla kapsar ve tek bir sabit küme olarak sunulmak yerine ayrı ayrı seçilebilir.

CLI kullanarak kurulum:

DataGrout GitHub'a gidin ve komut satırı arayüzünü kullanarak kurulum yapın - https://github.com/DataGrout/conduit-sdk

DataGrout Portalı kullanarak kurulum:

1. DataGrout hesabı oluşturun
https://app.datagrout.ai/ adresine gidin ve bir hesap oluşturun.

2. Bir sunucu oluşturun

  • Panonun sol üst köşesindeki sunucu açılır menüsüne tıklayın.

  • Yeni Sunucu Oluştur seçeneğini seçin.

  • Bir ad girin (zorunlu) ve isteğe bağlı bir açıklama ekleyin.

  • Sunucu Oluştur düğmesine tıklayın.

  • Sunucunuza bir UUID atanır ve bir MCP uç noktası oluşturulur: https://gateway.datagrout.ai/servers/{your-uuid}/mcp

  • Bu URL'yi daha sonra istediğiniz zaman Ayarlar > Sunucu Bilgileri altından alabilirsiniz.

3. Bir erişim belirteci oluşturun

  • Sunucu açılır menüsünü açın ve Ayarlar simgesine tıklayın.

  • Kimlik Doğrulama sekmesine gidin.

  • Erişim Belirteci Oluştur düğmesine tıklayın.

  • Bir ad verin veya otomatik oluşturulan bir ad için boş bırakın.

  • Belirteci hemen kopyalayın — yalnızca bir kez gösterilir ve daha sonra tekrar alınamaz.

4. Salesforce entegrasyonunu ekleyin

  • Ana Sayfa sayfasına gidin — burası entegrasyon pazarıdır.

  • Listede Salesforce'u bulun ve Ekle düğmesine tıklayın.

  • Kurulumu tamamlamak için Salesforce entegrasyon detay sayfasına yönlendirileceksiniz.

5. Kimlik doğrulamayı yapılandırın

  • Kimlik doğrulama türünü seçin: OAuth2.

  • DataGrout'un uygulama kimlik bilgilerini mi yoksa kendi kimlik bilgilerinizi mi kullanacağınızı seçin.

  • Ortamı seçin: Production veya Sandbox.

6. Bağlantıyı yetkilendirin

  • Bağlan düğmesine tıklayın.

  • Oturum açmak ve erişim izni vermek için Salesforce'un kendi barındırdığı giriş/yetkilendirme ekranına yönlendirilirsiniz.

  • Yetkilendirme tamamlandığında DataGrout panosuna geri dönersiniz.

7. Araçları ve politikayı yapılandırın

  • Entegrasyonun detay sayfasında, bu entegrasyon için hangi 700'den fazla aracın kullanıma açılacağını seçin.

  • Güvenlik politikasını incelemek veya ayarlamak için Politika sekmesini açın. Bu, üst Hub Sunucusunun politikasından devralınır ve yalnızca sıkılaştırılabilir, asla gevşetilemez — yazma erişimi varsayılan olarak devre dışı olduğundan, istiyorsanız her araç için açıkça etkinleştirilmelidir.

MCP İstemci Yapılandırması:

DataGrout, sunucu başına bir MCP uç noktası çalıştırır — aynı URL ve belirteç, bağlı her istemcide çalışır ve eklediğiniz her entegrasyon (Salesforce dahil) bu uç nokta üzerinden kullanılabilir hale gelir. Her entegrasyon için ayrı bir yapılandırma gerekmez.

{
  "mcpServers": {
    "DataGrout": {
      "url": "https://gateway.datagrout.ai/servers/YOUR_UUID/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Bu aynı bloğu Claude Desktop, Claude Code, Cursor ve Windsurf için kullanın. VS Code'un MCP yapılandırması "mcpServers" yerine "servers" kullanabilir — sürümünüzü kontrol edin.

Bu uç nokta için iki başka kimlik doğrulama seçeneği mevcuttur: karşılıklı TLS (production/kurumsal ajanlar) ve OAuth 2.1 (kullanıcıya yönelik uygulamalar, İstemci Kimlik Bilgileri veya Yetkilendirme Kodu + PKCE aracılığıyla).

Yapılandırma referansı:

AyarDeğerlerVarsayılan
Kimlik doğrulama türüOAuth2, mTLS veya Bearer belirteci
Kimlik bilgileriDataGrout uygulama kimlik bilgileri veya kullanıcı tarafından sağlanan
OrtamProduction veya Sandboxkurulumda kullanıcı tarafından seçilir
Araç kullanıma sunumu700'den fazla araçtan ayrı ayrı seçilebilirseçilene kadar hiçbiri etkin değil
Yazma erişimiAraç başına, entegrasyon başına etkinleştirilirdevre dışı
PolitikaÜst Hub Sunucusundan devralınır; sıkılaştırılabilir, gevşetilemezdevralınır

Araçlar:

  • salesforce@v1/rest@v1 — belirtilen bir REST uç noktasını ve HTTP yöntemini çağırır. GET her zaman izinlidir; diğer yöntemler politikaya bağlıdır.

  • salesforce@v1/soql@v1 — bir SOQL sorgusu çalıştırır. Yalnızca SELECT, DML yok. Sonuçlar sayfalanır ve önbelleğe alınır.

  • CRM nesneleri için SOQL, SOSL, REST ve CRUD aracılığıyla 700'den fazla ek araç, entegrasyon başına ayrı ayrı etkinleştirilir veya devre dışı bırakılır.

Etkileşim ayarları:

  • Bir araç çalıştırılmadan önce maliyet tahmini gösterilir

  • Bir aracın çalıştığını doğrulayan yürütme makbuzu

  • Tamamlandıktan sonra yürütme özeti

Bağlantılar: