Salesforce MCP Server

🚀 Salesforce MCP 服務器

這是一個將 Claude 集成到 Salesforce 中的 MCP（模型上下文協議）服務器實現。藉助該服務器，您能夠通過自然語言與 Salesforce 的數據和元數據進行交互，Claude 可以使用日常語言對 Salesforce 數據進行查詢、修改和管理。

🚀 快速開始

您可以按照以下步驟完成服務器的安裝和配置，開啟使用之旅。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/surajadsul02/mcp-server-salesforce.git

# 進入目錄
cd mcp-server-salesforce

# 安裝依賴項
npm install

# 構建項目
npm run build

📚 詳細文檔

設置

環境變量配置

使用用戶名/密碼認證：

• SALESFORCE_USERNAME：您的 Salesforce 用戶名或電子郵件
• SALESFORCE_PASSWORD：您的 Salesforce 密碼
• SALESFORCE_TOKEN：您的 Salesforce 安全令牌
• SALESFORCE_INSTANCE_URL：默認為 https://login.salesforce.com

使用 OAuth2 認證：

• SALESFORCE_USERNAME：您的 Salesforce 用戶名或電子郵件
• SALESFORCE_PASSWORD：您的 Salesforce 密碼
• SALESFORCE_CONSUMER_KEY：連接應用的消費者密鑰
• SALESFORCE_CONSUMER_SECRET：連接應用的消費者秘密
• SALESFORCE_INSTANCE_URL：默認為 https://login.salesforce.com

💻 使用示例

基礎用法

搜索對象

"查找所有與 Account 相關的對象"
"顯示處理客戶支持的對象"
"有哪些可用於訂單管理的對象？"

獲取架構信息

"Account 對象有哪些可用字段？"
"顯示 Case 狀態的下拉列表值"
"描述 Opportunity 的關係字段"

查詢記錄

"獲取本月創建的所有 Account"
"顯示高優先級的 Cases 及其相關聯繫人"
"查找所有金額超過 10 萬美元的 Opportunities"

管理自定義對象

"創建一個客戶反饋對象"
"在反饋對象中添加評分字段"
"更新服務請求對象的共享設置"

跨對象搜索

"在 Account 和 Opportunity 中查找 'cloud'"
"在 Cases 和知識文章中查找 '網絡問題'"
"在所有相關對象中搜索客戶名稱"

高級用法

從源代碼構建

# 克隆倉庫
git clone https://github.com/surajadsul02/mcp-server-salesforce.git

# 進入目錄
cd mcp-server-salesforce

# 安裝依賴項
npm install

# 構建項目
npm run build

🔧 技術細節

故障排除

1. 認證錯誤

   • 驗證您的憑證是否正確
   • 使用用戶名/密碼認證：確保安全令牌正確
   • 使用 OAuth2：驗證消費者密鑰和秘密

2. 連接問題

   • 檢查 Salesforce 實例 URL
   • 確保網絡連接正常
   • 確保正確的 API 訪問權限

3. Cursor IDE 集成

   • 在配置更改後重新啟動 Cursor IDE
   • 使用開發者工具檢查錯誤信息（幫助 > 切換開發者工具）
   • 確認包已全局安裝

4. Claude Desktop 集成

   • 驗證配置文件位置
   • 檢查文件權限
   • 在配置更改後重新啟動 Claude Desktop
   • 確保環境變量正確設置

🤝 貢獻

歡迎貢獻！隨時提交 Pull Request。

📄 許可證

此項目 licensed under MIT License，具體內容請參閱 LICENSE 文件。

❓ 問題與支持

如遇任何問題或需要支持，請在 GitHub 倉庫中提交問題。