이 MCP 서버는 Salesforce Agentforce API와 상호 작용하는 도구를 제공합니다. Agentforce Agent와 인증, 세션 생성 및 메시지 교환을 허용합니다.

Cloning 시작하기

이 저장소를 복제하면 대화 형 설정 스크립트를 사용하여 서버를 신속하게 구성하고 실행할 수 있습니다.

설정 스크립트는:

1. Python 버전 확인
2. 필수 의존성 설치
3. Salesforce 자격 증명을 통해 안내
4. Salesforce에 당신의 연결을 시험하십시오
5. 서버 시작
6. Claude Desktop 구성 지침 제공

대안으로, 당신은 이 설명서 단계를 따를 수 있습니다:

1. 모든 의존성:

2. ** 환경 변수 설정 **:

3. ** Salesforce 자격 증명**:

• SALESFORCE ORG ID: 귀하의 18-character 영업 인력 Org ID
• SALESFORCE AGENT ID: 당신의 Agentforce 대리인에서 18-character 대리인 ID
• SALESFORCE CLIENT ID: Connected App의 소비자 키 -SALESFORCE CLIENT SECRET: Connected App의 소비자 비밀
• SALESFORCE SERVER URL: https:// 접두사 없이 내 도메인 URL을 확장

4. ** 수집 된 자격이있는 .env 파일 **에 따라 :

Agentforce MCP Server

This MCP server provides tools to interact with the Salesforce Agentforce API. It allows authentication, session creation, and message exchange with Agentforce agents.

Getting Started After Cloning

If you’ve just cloned this repository, you can use the interactive setup script to quickly configure and run the server:

chmod +x setup.sh
./setup.sh

The setup script will:

1. Check your Python version
2. Install required dependencies
3. Guide you through entering your Salesforce credentials
4. Test your connection to Salesforce
5. Offer to start the server
6. Provide instructions for configuring Claude Desktop

Alternatively, you can follow these manual steps:

1. Install dependencies:

   pip install -r requirements.txt
   

2. Set up your environment variables:

   cp .env.example .env
   

3. Collect your Salesforce credentials:

   • SALESFORCE_ORG_ID: Your 18-character Salesforce Org ID
   • SALESFORCE_AGENT_ID: The 18-character Agent ID from your Agentforce agent
   • SALESFORCE_CLIENT_ID: The Consumer Key from your Connected App
   • SALESFORCE_CLIENT_SECRET: The Consumer Secret from your Connected App
   • SALESFORCE_SERVER_URL: Your Salesforce My Domain URL without https:// prefix

4. Edit your .env file with the collected credentials:

   SALESFORCE_ORG_ID="00D5f000000J2PKEA0"
   SALESFORCE_AGENT_ID="0XxHn000000x9F1KAI"
   SALESFORCE_CLIENT_ID="3MVG9OGq41FnYVsFgnaG0AzJDWnoy37Bb18e0R.GgDJu2qB9sqppVl7ehWmJhGvPSLrrA0cBNhDJdsbZXnv52"
   SALESFORCE_CLIENT_SECRET="210117AC36E9E4C8AFCA02FF062B8A677BACBFFB71D2BB1162D60D316382FADE"
   SALESFORCE_SERVER_URL="example.my.salesforce.com"
   

   (Note: These are fictional example values. Replace with your actual credentials.)

5. Make the server script executable:

   chmod +x agentforce_mcp_server.py
   

6. Run the server:

   python agentforce_mcp_server.py
   

For detailed instructions on finding your Salesforce credentials, see the Setting Up Salesforce section below.

Setup

1. Ensure you have Python 3.10 or higher installed.

2. Install the required dependencies:

   pip install -r requirements.txt
   

3. Make the server script executable:

   chmod +x agentforce_mcp_server.py
   

Configuration

The server uses environment variables for configuration. These are loaded from the .env file.

1. Copy the example environment file to create your own:

   cp .env.example .env
   

2. Edit the .env file and fill in your values:

   SALESFORCE_ORG_ID="your_org_id_here"
   SALESFORCE_AGENT_ID="your_agent_id_here"  # The 18-character Agent ID you found in Salesforce
   SALESFORCE_CLIENT_ID="your_client_id_here"  # The Consumer Key from your Connected App
   SALESFORCE_CLIENT_SECRET="your_client_secret_here"  # The Consumer Secret from your Connected App