Salesforce MCP

Salesforce MCP 서버 활성화

Salesforce에서 Setup을 엽니다.

1. Quick Find에서 MCP Servers를 검색하세요.
2. API Catalog에서 MCP Servers를 여세요.
3. 사용하려는 서버를 활성화하세요. 초기 설정의 경우 platform/sobject-reads를 활성화하세요.
4. 서버가 활성화될 때까지 최대 2분 정도 기다려 주세요.

full-access 예제를 사용할 계획이라면, 대신 platform/sobject-all을 활성화하세요.

외부 클라이언트 앱 생성

Salesforce 설정에서:

1. Quick Find에서 External Client App Manager를 검색하세요.
2. New External Client App을 클릭합니다.
3. 기본 앱 정보를 입력하세요. LibreChat Salesforce MCP와 같이 명확한 이름을 사용하세요.
4. **API (Enable OAuth Settings)**를 확장하고 OAuth를 활성화하세요.
5. LibreChat 콜백 URL을 추가하세요.

로컬 개발 환경의 경우:

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

프로덕션 환경의 경우, 기본 URL을 귀하의 공개 LibreChat URL로 교체하세요:

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

OAuth 범위 및 보안 구성

External Client App OAuth 설정에서 다음 스코프(scopes)를 추가하세요:

mcp_api
refresh_token

Hosted MCP 서버에는 표준 Salesforce api scope를 사용하지 마십시오. MCP 서버는 mcp_api scope를 사용해야 합니다.

External Client App 보안 설정에서:

• Issue JSON Web Token (JWT)-based access tokens for named users(지정된 사용자를 위한 JSON Web Token(JWT) 기반 액세스 토큰 발급)을 선택하세요.
• Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows를 선택하세요.
• 이 가이드의 기본 설정을 위해서는 Require Secret for Web Server Flow를 비활성화 상태로 두십시오.
• 이 가이드의 기본 설정을 위해서는 Require Secret for Refresh Token Flow를 비활성화 상태로 두십시오.

Create를 클릭한 다음, 앱 설정을 열고 Consumer Key를 복사합니다. Salesforce에 따르면 새로운 External Client App을 사용할 수 있게 되기까지 최대 30분이 소요될 수 있습니다.

.env에 Salesforce 클라이언트 ID 추가하기

LibreChat .env 파일에 External Client App 소비자 키(consumer key)를 추가하세요:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Require Secret for Web Server Flow를 활성화한 경우, 다음도 추가하세요:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

librechat.yaml에 Salesforce MCP 추가하기

이 예시는 프로덕션 또는 Developer Edition 조직을 위한 읽기 전용 SObject 서버를 구성합니다:

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'

샌드박스 또는 스크래치 조직의 경우, 샌드박스 MCP URL과 Salesforce 샌드박스 OAuth endpoint를 사용하세요:

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'

외부 클라이언트 앱에 클라이언트 시크릿이 필요한 경우, oauth 내부에 다음 필드를 추가하세요:

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

LibreChat가 공용 URL에 배포된 경우, redirect_uri를 Salesforce에 등록된 정확한 콜백 URL과 일치하도록 업데이트하세요.

필요한 경우 전체 Salesforce 액세스로 전환

읽기 전용 서버가 작동한 후, url을 변경하여 다른 활성화된 Salesforce 서버로 전환할 수 있습니다.

프로덕션 또는 Developer Edition 조직에서 전체 SObject 액세스를 사용하려면:

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

샌드박스 또는 스크래치 조직에서 전체 SObject 액세스를 사용하려면:

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

어시스턴트를 통해 Salesforce 레코드를 생성, 업데이트 또는 삭제할 수 있는 권한이 있는 사용자에게만 변경(mutation) 또는 삭제가 가능한 서버를 노출하십시오.

LibreChat 재시작

.env 및 librechat.yaml을 다시 불러올 수 있도록 LibreChat을 재시작하세요.

Docker에서 서버가 로드되었는지 확인하려면 API 로그를 확인하세요:

docker logs LibreChat --tail 200 | grep MCP

LibreChat에서 Salesforce 연결하기

LibreChat을 열고, MCP Settings 또는 채팅 입력창의 MCP Servers 드롭다운을 엽니다.

1. Salesforce 서버에 대해 Connect를 클릭하세요.
2. Salesforce OAuth 흐름을 완료하세요.
3. 요청된 mcp_api 및 refresh_token 범위를 검토하세요.
4. OAuth 성공 페이지가 닫힌 후 LibreChat으로 돌아오세요.

OAuth가 성공하고 MCP 연결이 초기화되면, Salesforce 도구를 채팅과 Agent Builder에서 사용할 수 있게 됩니다.