Salesforce MCP 서버

설정

uv venv .venv
uv pip install --python .venv/bin/python -e .

구성

인증을 위한 환경 변수를 설정합니다:

사용자 이름/비밀번호 (기본값):

SALESFORCE_USERNAME=your-username
SALESFORCE_PASSWORD=your-password
SALESFORCE_SECURITY_TOKEN=your-token
SALESFORCE_DOMAIN=login          # or "test" for sandbox

참고: 최신 Salesforce 조직에서는 SOAP API 로그인이 기본적으로 비활성화되어 있습니다. 활성화하려면:
설정(Setup) → 빠른 찾기 → **사용자 인터페이스(User Interface)**로 이동합니다.
**API 설정(API Settings)**에서 **SOAP API login() 활성화(Enable SOAP API login())**를 체크합니다.
**저장(Save)**을 클릭합니다.

OAuth (대안, 엔터프라이즈 권장):

SALESFORCE_ACCESS_TOKEN=your-token
SALESFORCE_INSTANCE_URL=https://your-instance.salesforce.com

액세스 모드

SALESFORCE_ACCESS_MODE를 설정하여 사용 가능한 도구를 제어합니다:

값	사용 가능한 도구	사용 사례
`read`	list_objects, describe_object, run_soql_query, run_sosl_search, get_record, get_report_metadata, get_report_type_fields	안전한 탐색, 보고, 읽기 전용 통합
`read_write`	모든 읽기 도구 + create_record, update_record	일상적인 CRM 작업
`all` (기본값)	delete_record, tooling_execute, apex_execute, restful을 포함한 모든 도구	전체 API 액세스

권장 보안 수준

환경	권장 모드	근거
프로덕션 (최종 사용자)	`read`	실수로 인한 데이터 수정 방지
프로덕션 (신뢰할 수 있는 운영)	`read_write`	CRM 데이터 입력 허용, 삭제 및 원시 API 차단
샌드박스 / 개발	`all`	테스트 및 개발을 위한 전체 액세스
데모 / 탐색	`read`	조직 구조 및 데이터 탐색을 위한 안전한 환경

환경 또는 MCP 서버 구성에서 설정하세요:

SALESFORCE_ACCESS_MODE=read

팁: MintMCP와 함께 이 서버를 사용하는 경우, 환경 변수를 사용하는 대신 MintMCP에서 직접 도구별 세부 권한을 구성할 수 있습니다. 이를 통해 서버를 재시작할 필요 없이 더 세밀한 제어(예: 생성은 허용하되 업데이트는 차단)가 가능합니다.

액세스 모드별 도구 권한

MCP 클라이언트가 추가 정책을 적용할 수 있도록 각 도구에 MCP 도구 주석(readOnlyHint, destructiveHint)이 설정되어 있습니다:

도구	액세스 모드	readOnlyHint	destructiveHint	openWorldHint
`list_objects`	read	true	—	—
`describe_object`	read	true	—	—
`run_soql_query`	read	true	—	—
`run_sosl_search`	read	true	—	—
`get_record`	read	true	—	—
`get_report_metadata`	read	true	—	—
`get_report_type_fields`	read	true	—	—
`create_record`	read_write	false	—	—
`update_record`	read_write	false	—	—
`delete_record`	all	false	true	—
`tooling_execute`	all	false	—	true
`apex_execute`	all	false	—	true
`restful`	all	false	—	true

실행

.venv/bin/python -m salesforce_mcp

도구

도구	설명
`list_objects`	조직 내 모든 Salesforce 객체 나열 (선택적 검색 필터 포함)
`describe_object`	객체의 필드, 관계, 선택 목록 값 및 레코드 유형 가져오기
`run_soql_query`	SOQL 쿼리 실행
`run_sosl_search`	SOSL을 통한 객체 간 전체 텍스트 검색
`get_record`	ID로 단일 레코드 가져오기
`get_report_metadata`	보고서에 대한 상세 메타데이터(열, 필터, 그룹화, 보고서 유형) 가져오기
`get_report_type_fields`	보고서 유형의 필드 카탈로그 확인 — 카테고리 나열 또는 특정 카테고리의 필드 가져오기
`create_record`	새 레코드 생성
`update_record`	기존 레코드의 필드 업데이트
`delete_record`	레코드 영구 삭제
`tooling_execute`	Salesforce Tooling API (메타데이터, Apex 클래스, 사용자 정의 필드)
`apex_execute`	사용자 정의 Apex REST 엔드포인트 호출
`restful`	일반 Salesforce REST API 호출