MCP Salesforce 커넥터

Salesforce 통합을 위한 Model Context Protocol (MCP) 서버 구현으로, LLM이 SOQL 쿼리 및 SOSL 검색을 통해 Salesforce 데이터와 상호 작용할 수 있도록 합니다.

기능

• SOQL (Salesforce Object Query Language) 쿼리 실행

• SOSL (Salesforce Object Search Language) 검색 수행

• 필드 이름, 레이블 및 유형을 포함한 Salesforce 객체 메타데이터 검색

• 사용 가능한 모든 SObject 나열 - 표준 및 사용자 정의 객체 탐색

• 레코드 검색, 생성, 업데이트 및 삭제

• Tooling API 요청 실행

• Apex REST 요청 실행

• Salesforce에 직접 REST API 호출

Related MCP server: Salesforce MCP Integration

구성

Model Context Protocol

이 서버를 Model Context Protocol과 함께 사용하려면 claude_desktop_config.json 파일에서 구성해야 합니다. mcpServers 섹션에 다음 항목을 추가하십시오:

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

사용 가능한 도구

쿼리 및 검색 도구

• run_soql_query - Salesforce에 대해 SOQL 쿼리 실행

• run_sosl_search - 객체 전반에 걸쳐 SOSL 검색 수행

메타데이터 도구

• get_object_fields - 특정 객체에 대한 필드 메타데이터 검색

• list_sobjects - 사용 가능한 모든 SObject(표준 및 사용자 정의) 나열

단일 레코드 작업

• get_record - ID로 특정 레코드 검색

• create_record - 새 레코드 생성

• update_record - 기존 레코드 업데이트

• delete_record - 레코드 삭제

대량 작업

• bulk_create_records - 단일 작업으로 여러 레코드 생성

• bulk_update_records - 여러 레코드 업데이트 (Id 필드 포함 필수)

• bulk_delete_records - 레코드 ID를 사용하여 여러 레코드 삭제

고급 API 도구

• tooling_execute - Tooling API 요청 실행

• apex_execute - Apex REST 요청 실행

• restful - Salesforce에 직접 REST API 호출

Salesforce 인증 방법 참고

이 서버는 네 가지 인증 방법을 지원합니다:

• OAuth (권장): SALESFORCE_ACCESS_TOKEN 및 SALESFORCE_INSTANCE_URL을 환경 변수로 설정합니다.

• 클라이언트 자격 증명: OAuth 2.0 클라이언트 자격 증명 흐름을 위해 SALESFORCE_CLIENT_ID 및 SALESFORCE_CLIENT_SECRET을 설정합니다. 이는 서버 간 통합에 유용합니다.

• Salesforce CLI (기본 조직): OAuth 환경 변수가 설정되지 않은 경우, 서버는 현재 작업 공간에서 활성 Salesforce CLI 기본 조직을 사용하려고 시도합니다(sf org display --json 또는 sfdx force:org:display --json을 통해). 선택적으로 SALESFORCE_CLI_TARGET_ORG를 설정하여 특정 조직을 대상으로 지정할 수 있습니다.

• 사용자 이름/비밀번호 (레거시): SALESFORCE_ACCESS_TOKEN 및 SALESFORCE_INSTANCE_URL이 설정되지 않은 경우, 서버는 SALESFORCE_USERNAME, SALESFORCE_PASSWORD 및 SALESFORCE_SECURITY_TOKEN을 사용하는 방식으로 대체됩니다.

환경 구성

• SALESFORCE_DOMAIN (선택 사항): Salesforce 샌드박스 환경에 연결하려면 test로 설정하십시오. 설정하지 않거나 비워두면 서버가 프로덕션 환경에 연결됩니다.

• SALESFORCE_CLI_TARGET_ORG (선택 사항): Salesforce CLI 인증 방법을 사용할 때, 기본 조직 대신 특정 조직 별칭이나 사용자 이름을 대상으로 지정하려면 이 값을 설정하십시오.