Salesforce MCP Server

Salesforce MCP (Model Context Protocol) server based on Node.js / Express / TypeScript

You can query Salesforce data using natural language.

How to Run

Local Execution

# 환경변수 설정
cp .env.example .env
# .env 파일에 Salesforce 인증 정보 입력 후

npm install
npm run build
npm start

# 인증 토큰과 함께 실행
TOKEN=your_token npm start

Generate Sample Data

npm run seed

Automatically generates 7 accounts, contacts, opportunities, leads, and activity data.

Deployment (CloudType)

1. Create New Service → Connect GitHub → Select alerundev/salesforce-mcp-server

2. Settings

   • Node v22

   • Build command: npm run build

   • Start command: npm start

3. Environment Variables

4. MCP Connection URL

   https://<배포된 도메인>/mcp

Authentication

Uses Bearer token authentication (enabled when environment variable TOKEN is set):

Authorization: Bearer your-token

Supported Tools

Natural Language Query Examples

• "Show me the list of deals closing this month"

• "What is the total value of opportunities in Closed Won status?"

• "Find the contact for Samsung Electronics"

• "Summarize opportunities by stage"

• "Show me Hot status leads"