Surajadsul MCP Server Salesforce

🚀 Salesforce MCP サーバー

このサーバーはSalesforce MCPプロトコルに基づいて実装されており、Salesforceとの統合を可能にします。自然言語処理を通じて、Salesforce内のオブジェクトとレコードの照会、修正、管理を行うことができ、Salesforceとのやり取りを簡素化することを目的としています。

🚀 クイックスタート

このサーバーを使用することで、Salesforceとのやり取りを自然言語で行うことができます。以下のセクションでは、インストール方法、設定方法、使用例などを説明します。

✨ 主な機能

• Salesforce MCPプロトコルを使用して、Salesforceとの統合を実現します。
• 自然言語処理を通じて、Salesforce内のオブジェクトとレコードの照会、修正、管理を行います。
• Cursor IDEやClaude Desktopなどの開発環境との統合が可能です。

📦 インストール

# 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

トラブルシューティング

1. 認証エラー

   • 認証情報が正しいことを確認します。
   • ユーザー名/パスワード認証の場合、セキュリティトークンが有効であることを確認します。
   • OAuth2認証の場合、クライアントIDとシークレットキーが正しいことを確認します。

2. 接続問題

   • SalesforceインスタンスのURLが正しいことを確認します。
   • ネットワーク接続が正常であることを確認します。
   • APIアクセス権限を確認します。

3. Cursor IDE統合問題

   • Cursor IDEを再起動し、プラグインが読み込まれていることを確認します。
   • 開発者ツールを使用してコンソール出力を確認します。
   • npmパッケージがグローバルにインストールされていることを確認します。

4. Claude Desktop統合問題

   • 設定ファイルの場所が正しいことを確認します。
   • ファイルの権限が正しいことを確認します。
   • Claude Desktopを再起動し、プラグインの読み込み状態を確認します。
   • 環境変数が正しく設定されていることを確認します。

貢献

貢献を歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。詳細については LICENSE ファイルを参照してください。

問題とサポート

ヘルプが必要な場合や問題を報告する場合は、GitHubリポジトリでISSUEを作成してください。