Kablewy Salesforce MCP Server

🚀 Salesforce MCP サーバー

このサーバーは、jsforce を使用して Salesforce の REST API を通じて実装された Model Context Protocol サーバーです。Salesforce データの操作や管理を容易にします。

🚀 クイックスタート

このセクションでは、Salesforce MCP サーバーをすぐに使い始めるための手順を説明します。

✨ 主な機能

• SOQL クエリの実行
• オブジェクトのメタデータの取得
• レコードの作成、更新、削除
• 安全な認証処理
• リアルタイムデータアクセス

📦 インストール

以下の手順に従って、サーバーをセットアップします。

1. リポジトリをクローンします。
2. .env.example を .env にコピーし、Salesforce の認証情報を入力します。
3. 依存関係をインストールします: npm install
4. ビルドします: npm run build
5. サーバーを起動します: npm start

💻 使用例

サーバーはいくつかの機能を公開しています。

基本的な使用法

query

Salesforce インスタンスに対して SOQL クエリを実行します。

{
  "name": "query",
  "parameters": {
    "query": "SELECT Id, Name FROM Account LIMIT 5"
  }
}

describe - object

Salesforce オブジェクトに関するメタデータを取得します。

{
  "name": "describe-object",
  "parameters": {
    "objectName": "Account"
  }
}

create

新しいレコードを作成します。

{
  "name": "create",
  "parameters": {
    "objectName": "Contact",
    "data": {
      "FirstName": "John",
      "LastName": "Doe",
      "Email": "john.doe@example.com"
    }
  }
}

update

既存のレコードを更新します。

{
  "name": "update",
  "parameters": {
    "objectName": "Contact",
    "data": {
      "Id": "003XXXXXXXXXXXXXXX",
      "Email": "new.email@example.com"
    }
  }
}

delete

レコードを削除します。

{
  "name": "delete",
  "parameters": {
    "objectName": "Contact",
    "id": "003XXXXXXXXXXXXXXX"
  }
}

📚 ドキュメント

安全

以下の注意事項を守ってください。

⚠️ 重要提示

• .env ファイルを安全に保管し、決してコミットしないでください。
• 可能な限り、Salesforce で IP 制限を使用してください。
• 定期的にセキュリティトークンを更新してください。
• MCP サーバーに追加の認証を実装することを検討してください。

貢献

貢献を歓迎します！改善点を含む PR を送信してください。

📄 ライセンス

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.