Salesforce MCP Integration

Salesforce MCP 통합

이 프로젝트는 Salesforce 통합을 위한 MCP(Model Context Protocol) 서버를 제공하여 표준화된 인터페이스를 통해 SOQL 쿼리를 실행하고 Salesforce 데이터와 상호 작용할 수 있도록 합니다.

특징

• 환경 변수를 사용하여 Salesforce 조직에 연결
• Salesforce 데이터에 대해 SOQL 쿼리 실행
• Salesforce 레코드 검색 및 처리
• 환경 변수를 사용한 보안 자격 증명 관리

필수 조건

• Node.js(v14 이상)
• npm(노드 패키지 관리자)
• API 액세스가 가능한 Salesforce 조직
• Salesforce 자격 증명(사용자 이름, 비밀번호 및 보안 토큰)

설치

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. Salesforce 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
   SF_LOGIN_URL=https://your-instance.salesforce.com/ SF_USERNAME=your_username SF_PASSWORD=your_password SF_SECURITY_TOKEN=your_security_token PORT=3000
   참고: 샌드박스 환경의 경우 로그인 URL로 https://test.salesforce.com/ 사용하세요.

용법

MCP 서버 시작

Node.js를 사용하여 서버를 실행합니다.

서버는 .env 파일에 있는 자격 증명을 사용하여 Salesforce에 연결하고 MCP 요청을 수신하기 시작합니다.

SOQL 쿼리 실행

서버가 실행되면 MCP 인터페이스를 통해 SOQL 쿼리를 실행할 수 있습니다. 서버는 SOQL 쿼리를 수신하고 결과를 반환하는 soqlQuery 도구를 제공합니다.

SOQL 쿼리 예시:

프로젝트 구조

• server.js - 주요 MCP 서버 구현
• .env - Salesforce 자격 증명에 대한 환경 변수
• package.json - 프로젝트 종속성 및 스크립트

보안 고려 사항

• .env 파일을 버전 제어에 커밋하지 마십시오.
• .gitignore 파일에 .env 추가하세요.
• 모든 민감한 정보에 환경 변수를 사용하세요
• 프로덕션 환경에서 보다 안전한 인증 방법을 사용하는 것을 고려하세요.

문제 해결

연결 문제

연결 문제가 발생하는 경우:

1. .env 파일에서 Salesforce 자격 증명을 확인하세요.
2. Salesforce 조직에 액세스할 수 있는지 확인하세요.
3. 필요한 경우 Salesforce에서 IP 주소가 허용 목록에 등록되어 있는지 확인하세요.
4. Salesforce 사용자에게 API 액세스 권한이 있는지 확인하세요.

쿼리 오류

SOQL 쿼리가 실패하는 경우:

1. SOQL 구문을 확인하세요
2. 조직에 개체와 필드가 있는지 확인하세요.
3. 사용자에게 개체 및 필드에 액세스할 수 있는 권한이 있는지 확인하세요.

특허

MIT 라이센스

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.