Salesforce
Salesforce CRM과 연결하여 SOQL 쿼리, SOSL 검색, DML 작업 등을 수행할 수 있습니다.
주요 기능
- SOQL 쿼리 실행으로 데이터 조회
- SOSL 검색으로 여러 객체에서 데이터 검색
- DML 작업 (CREATE, UPDATE, DELETE) 수행
- 객체 스키마 정보 조회
- 집계 쿼리 실행으로 비즈니스 분석
기본 정보
인증 방식
Username/Password 인증을 사용합니다.
입력 파라미터
- username (필수): Salesforce 사용자명
- password (필수): Salesforce 비밀번호
- salesforceToken (필수): Salesforce 보안 토큰 (사용자 설정에서 확인)
- instanceUrl (필수): Salesforce 인스턴스 URL (예:
https://mycompany--dev.sandbox.lightning.force.com)
지원하는 MCP 도구
데이터 조회 도구
query_records
SOQL 쿼리를 실행하여 Salesforce 레코드를 조회합니다. 토큰 효율적인 포맷팅으로 최적화되어 있습니다.
입력 파라미터:
- query (필수): 실행할 SOQL 쿼리 (예:
SELECT Id, Name FROM Account LIMIT 10)
aggregate_query
GROUP BY를 사용한 SOQL 집계 쿼리를 실행하여 비즈니스 분석 및 리포팅을 수행합니다.
입력 파라미터:
- query (필수): GROUP BY가 포함된 SOQL 집계 쿼리 (예:
SELECT COUNT(Id), Industry FROM Account GROUP BY Industry)
데이터 검색 도구
search_objects
여러 Salesforce 객체에서 레코드를 찾기 위해 SOSL 검색을 수행합니다.
입력 파라미터:
- searchQuery (필수): SOSL 검색 쿼리 (예:
FIND {John} IN ALL FIELDS RETURNING Account(Id, Name), Contact(Id, Name))
데이터 관리 도구
dml_records
Salesforce 레코드에 DML 작업(CREATE, UPDATE, DELETE)을 수행합니다.
입력 파라미터:
- operation (필수): DML 작업 유형 (
CREATE,UPDATE,DELETE) - objectName (필수): Salesforce 객체명 (예:
Account,Contact,Opportunity) - recordId (선택): 레코드 ID (UPDATE 및 DELETE 작업에 필요)
- fields (선택): JSON 객체 형태의 필드 값 (CREATE 및 UPDATE 작업에 필요)
스키마 정보 도구
describe_object
필드와 관계를 포함한 Salesforce 객체의 상세 스키마 정보를 조회합니다.
입력 파라미터:
- objectName (필수): 설명할 Salesforce 객체명 (예:
Account,Contact,Opportunity)
사용 예시
예를 들어,
- Prompt로 “Account 객체에서 최근에 생성된 10개의 레코드를 조회해줘” 라고 입력하면,
- LLM은 MCP를 통해
query_records도구를 호출하여 SOQL 쿼리를 실행합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.
Salesforce 보안 토큰 생성 방법
- Salesforce에 로그인합니다.
- 우측 상단의 프로필 아이콘을 클릭합니다.
- 설정(Setup)을 선택합니다.
- 좌측 사이드바에서 내 개인 정보(My Personal Information)를 클릭합니다.
- 내 보안 토큰 재설정(Reset My Security Token)을 클릭합니다.
- 보안 토큰 재설정(Reset Security Token)을 클릭합니다.
- 이메일로 보안 토큰이 전송됩니다.
주의사항
- Salesforce API 버전은 최신 버전을 사용합니다.
- SOQL 쿼리는 Salesforce 객체 및 필드 권한에 따라 제한됩니다.
- DML 작업은 데이터 무결성을 위해 신중하게 수행해야 합니다.
- API 호출 제한이 있으므로 과도한 요청을 피해주세요.
- 보안 토큰은 안전하게 보관하고 정기적으로 갱신하세요.
Last updated on