Salesforce MCP

Kích hoạt máy chủ MCP Salesforce

Trong Salesforce, hãy mở Setup.

1. Trong Quick Find, tìm kiếm MCP Servers.
2. Mở MCP Servers trong API Catalog.
3. Bật máy chủ bạn muốn sử dụng. Đối với thiết lập lần đầu, hãy bật platform/sobject-reads.
4. Đợi tối đa 2 phút để máy chủ chuyển sang trạng thái hoạt động.

Nếu bạn dự định sử dụng ví dụ toàn quyền truy cập, hãy bật platform/sobject-all thay thế.

Tạo một Ứng dụng Client bên ngoài

Trong phần Thiết lập Salesforce:

1. Trong Quick Find, hãy tìm kiếm External Client App Manager.
2. Nhấp vào New External Client App.
3. Điền thông tin cơ bản của ứng dụng. Hãy sử dụng một cái tên rõ ràng, chẳng hạn như LibreChat Salesforce MCP.
4. Mở rộng API (Enable OAuth Settings) và bật OAuth.
5. Thêm URL callback của LibreChat.

Đối với phát triển cục bộ:

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

Đối với môi trường production, hãy thay thế base URL bằng URL LibreChat công khai của bạn:

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

Cấu hình OAuth scopes và bảo mật

Trong cài đặt OAuth của External Client App, hãy thêm các phạm vi (scopes) sau:

mcp_api
refresh_token

Không sử dụng phạm vi (scope) api tiêu chuẩn của Salesforce cho các máy chủ MCP được lưu trữ (Hosted MCP servers). Máy chủ MCP yêu cầu phạm vi mcp_api.

Trong cài đặt bảo mật của External Client App:

• Chọn Issue JSON Web Token (JWT)-based access tokens for named users.
• Chọn Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Để nguyên Require Secret for Web Server Flow ở trạng thái tắt (disabled) cho thiết lập cơ bản trong hướng dẫn này.
• Để nguyên Require Secret for Refresh Token Flow ở trạng thái tắt (disabled) cho thiết lập cơ bản trong hướng dẫn này.

Nhấp vào Create, sau đó mở cài đặt ứng dụng và sao chép Consumer Key. Salesforce cho biết một External Client App mới có thể mất tới 30 phút để khả dụng.

Thêm Salesforce client ID vào .env

Thêm consumer key của External Client App vào tệp .env trong LibreChat của bạn:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Nếu bạn đã bật Require Secret for Web Server Flow, hãy thêm cả:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Thêm Salesforce MCP vào librechat.yaml

Ví dụ này cấu hình máy chủ SObject chỉ đọc cho một org production hoặc Developer Edition:

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'

Đối với sandbox hoặc scratch org, hãy sử dụng URL MCP sandbox và các endpoint OAuth của Salesforce sandbox:

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'

Nếu Ứng dụng Khách Bên ngoài của bạn yêu cầu một client secret, hãy thêm các trường này vào bên trong oauth:

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

Nếu LibreChat được triển khai tại một URL công khai, hãy cập nhật redirect_uri để khớp chính xác với URL callback đã đăng ký trong Salesforce.

Chuyển sang quyền truy cập Salesforce đầy đủ, nếu cần

Sau khi máy chủ chỉ đọc (read-only) hoạt động, bạn có thể chuyển sang một máy chủ Salesforce đã kích hoạt khác bằng cách thay đổi url.

Để có quyền truy cập SObject đầy đủ trong một org production hoặc Developer Edition:

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

Để có quyền truy cập SObject đầy đủ trong sandbox hoặc scratch org:

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

Chỉ cung cấp quyền truy cập vào các máy chủ có khả năng thay đổi (mutation) hoặc xóa dữ liệu cho những người dùng được phép tạo, cập nhật hoặc xóa các bản ghi Salesforce thông qua trợ lý.

Khởi động lại LibreChat

Khởi động lại LibreChat để tải lại .env và librechat.yaml.

Để xác nhận máy chủ đã tải trong Docker, hãy kiểm tra nhật ký API:

docker logs LibreChat --tail 200 | grep MCP

Kết nối Salesforce trong LibreChat

Mở LibreChat, sau đó mở MCP Settings hoặc menu thả xuống MCP Servers trong phần nhập liệu trò chuyện.

1. Nhấp vào Connect cho máy chủ Salesforce.
2. Hoàn tất quy trình Salesforce OAuth.
3. Xem lại các phạm vi mcp_api và refresh_token được yêu cầu.
4. Quay lại LibreChat sau khi trang xác thực OAuth đóng lại.

Sau khi OAuth thành công và kết nối MCP khởi tạo, các công cụ Salesforce sẽ khả dụng trong trò chuyện và trong Agent Builder.