Surajadsul MCP Server Salesforce

🚀 Salesforce MCP 服務器

這是一個基於 Salesforce MCP 協議的工具，可與 Salesforce 集成。藉助自然語言處理技術，它能對 Salesforce 中的對象和記錄進行查詢、修改與管理，極大簡化了與 Salesforce 的交互流程。

🚀 快速開始

本工具可幫助你通過自然語言處理與 Salesforce 進行交互，簡化操作流程。你可以按照下面的步驟進行安裝和配置。

✨ 主要特性

• 基於 Salesforce MCP 協議實現，可與 Salesforce 無縫集成。
• 利用自然語言處理技術，支持對 Salesforce 中的對象和記錄進行查詢、修改和管理。
• 提供多種身份驗證方式，包括用戶名/密碼認證和 OAuth2 認證。
• 支持在 Cursor IDE 和 Claude Desktop 中集成使用。

📦 安裝指南

使用 npm 安裝包：

# 使用 npm 安裝包
npm install salesforce-mcp-server

📦 設置

身份驗證方式

用戶名/密碼認證

需要配置以下環境變量：

• SALESFORCE_USERNAME：Salesforce 用戶名或電子郵件
• SALESFORCE_PASSWORD：Salesforce 密碼
• SALESFORCE_SECURITY_TOKEN：Salesforce 安全令牌

OAuth2 認證

需要配置以下環境變量：

• SALESFORCE_CLIENT_ID：註冊應用時獲取的客戶端 ID
• SALESFORCE_CLIENT_SECRET：應用的密鑰
• SALESFORCE_REDIRECT_URI：重定向 URI

📦 集成指南

在 Cursor IDE 中集成

1. 打開 Cursor IDE 的設置。
2. 導航到插件管理或擴展部分。
3. 搜索並安裝 Salesforce MCP 插件。
4. 配置插件，輸入相關環境變量。

在 Claude Desktop 中集成

1. 將配置文件 config.json 放置在相應的位置：
   • Windows：%APPDATA%\Claude Desktop\config.json
   • macOS：~/Library/Application Support/Claude Desktop/config.json
2. 確保配置文件包含以下內容：

{
    "salesforce": {
        "username": "your_salesforce_username",
        "password": "your_salesforce_password",
        "security_token": "your_security_token"
    }
}

💻 使用示例

基礎用法

搜索對象

server.searchObjects("Account");

獲取模式信息

server.getSchemaInfo("Account", "fields");

查詢記錄

server.queryRecords("SELECT Id, Name FROM Account WHERE CreatedDate = TODAY()");

🚧 開發

從源代碼構建

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

# 進入目錄
cd salesforce-mcp-server

# 安裝依賴項
npm install

# 構建項目
npm run build

🛠️ 故障排除

身份驗證錯誤

• 確認憑據是否正確。
• 對於用戶名密碼認證，確保安全令牌有效。
• 對於 OAuth2 認證，檢查客戶端 ID 和密鑰是否正確。

連接問題

• 檢查 Salesforce 實例 URL 是否正確。
• 確保網絡連接正常。
• 驗證 API 訪問權限。

Cursor IDE 集成問題

• 重啟 Cursor IDE 後確認插件已加載。
• 使用開發者工具檢查控制檯輸出。
• 確認全局安裝了 npm 包。

Claude Desktop 集成問題

• 檢查配置文件位置是否正確。
• 確保文件權限無誤。
• 重啟 Claude Desktop 後確認插件加載狀態。
• 確保環境變量已正確設置。

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

本項目遵循 MIT 許可證，詳細信息請查看 LICENSE 文件。

❓ 問題與支持

如需幫助或報告問題，請在 GitHub 倉庫中創建 ISSUE。