Salesforce MCP

Salesforce MCP sunucusunu etkinleştirin

Salesforce içinde Setup kısmını açın.

1. Quick Find içinde MCP Servers araması yapın.
2. API Catalog altında MCP Servers kısmını açın.
3. Kullanmak istediğiniz sunucuyu etkinleştirin. İlk kurulum için platform/sobject-reads öğesini etkinleştirin.
4. Sunucunun aktif hale gelmesi için 2 dakikaya kadar bekleyin.

Tam erişimli örneği kullanmayı planlıyorsanız, bunun yerine platform/sobject-all seçeneğini etkinleştirin.

Harici Bir İstemci Uygulaması Oluşturun

Salesforce Kurulumu'nda:

1. Quick Find içinde External Client App Manager araması yapın.
2. New External Client App öğesine tıklayın.
3. Temel uygulama bilgilerini doldurun. LibreChat Salesforce MCP gibi net bir isim kullanın.
4. API (Enable OAuth Settings) kısmını genişletin ve OAuth'u etkinleştirin.
5. LibreChat geri çağırma (callback) URL'sini ekleyin.

Yerel geliştirme için:

http://localhost:3080/api/mcp/salesforce/oauth/callback

Üretim ortamı için, temel URL'yi herkese açık LibreChat URL'niz ile değiştirin:

https://chat.example.com/api/mcp/salesforce/oauth/callback

OAuth kapsamlarını ve güvenliği yapılandırın

Harici İstemci Uygulaması (External Client App) OAuth ayarlarında şu kapsamları (scopes) ekleyin:

mcp_api
refresh_token

Barındırılan MCP sunucuları için standart Salesforce api kapsamını kullanmayın. MCP sunucusu mcp_api kapsamını bekler.

Harici İstemci Uygulaması (External Client App) güvenlik ayarlarında:

• JSON Web Token (JWT) tabanlı erişim belirteçlerini adlandırılmış kullanıcılar için ver seçeneğini belirleyin.
• Desteklenen Yetkilendirme Akışları için Kod Değişimi için Kanıt Anahtarı (PKCE) uzantısını zorunlu kıl seçeneğini belirleyin.
• Bu kılavuzdaki temel kurulum için Require Secret for Web Server Flow seçeneğini devre dışı bırakın.
• Bu kılavuzdaki temel kurulum için Require Secret for Refresh Token Flow seçeneğini devre dışı bırakın.

Create düğmesine tıklayın, ardından uygulama ayarlarına gidin ve Consumer Key değerini kopyalayın. Salesforce, yeni bir External Client App'in kullanılabilir hale gelmesinin 30 dakikayı bulabileceğini belirtmektedir.

Salesforce istemci kimliğini (client ID) .env dosyasına ekleyin

Harici İstemci Uygulaması tüketici anahtarını LibreChat .env dosyanıza ekleyin:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Eğer Require Secret for Web Server Flow özelliğini etkinleştirdiyseniz, şunu da ekleyin:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Salesforce MCP'yi librechat.yaml dosyasına ekleyin

Bu örnek, bir üretim veya Developer Edition organizasyonu için salt okunur SObject sunucusunu yapılandırır:

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://login.salesforce.com/services/oauth2/authorize'
      token_url: 'https://login.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

Bir sandbox veya scratch org için, sandbox MCP URL'sini ve Salesforce sandbox OAuth endpoint'lerini kullanın:

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://test.salesforce.com/services/oauth2/authorize'
      token_url: 'https://test.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

Harici İstemci Uygulamanız bir istemci gizli anahtarı (client secret) gerektiriyorsa, bu alanları oauth içine ekleyin:

oauth:
  client_secret: '${SALESFORCE_MCP_CLIENT_SECRET}'
  token_exchange_method: default_post
  token_endpoint_auth_methods_supported: ['client_secret_post']

LibreChat herkese açık bir URL'de dağıtılmışsa, redirect_uri değerini Salesforce'ta kayıtlı olan geri çağırma (callback) URL'si ile tam olarak eşleşecek şekilde güncelleyin.

Gerekirse tam Salesforce erişimine geçin

Salt okunur sunucu çalıştıktan sonra, url kısmını değiştirerek başka bir etkin Salesforce sunucusuna geçiş yapabilirsiniz.

Bir üretim veya Developer Edition organizasyonunda tam SObject erişimi için:

url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-all'

Bir sandbox veya scratch org içinde tam SObject erişimi için:

url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all'

Değişiklik yapma veya silme yeteneğine sahip sunucuları, yalnızca bir asistan aracılığıyla Salesforce kayıtlarını oluşturmasına, güncellemesine veya silmesine izin verilmesi gereken kullanıcılara açın.

LibreChat'i Yeniden Başlatın

.env ve librechat.yaml dosyalarını yeniden yüklemesi için LibreChat'i yeniden başlatın.

Sunucunun Docker içinde yüklendiğini doğrulamak için API günlüklerini kontrol edin:

docker logs LibreChat --tail 200 | grep MCP

LibreChat içinde Salesforce'u bağlayın

LibreChat'i açın, ardından sohbet girişindeki MCP Settings veya MCP Servers açılır menüsünü açın.

1. Salesforce sunucusu için Connect düğmesine tıklayın.
2. Salesforce OAuth akışını tamamlayın.
3. İstenen mcp_api ve refresh_token kapsamlarını gözden geçirin.
4. OAuth başarı sayfası kapandıktan sonra LibreChat'e dönün.

OAuth başarılı olduktan ve MCP bağlantısı başlatıldıktan sonra, Salesforce araçları sohbet içinde ve Agent Builder'da kullanılabilir hale gelir.