Salesforce MCP Server

🚀 Salesforce MCP サーバー

ClaudeとSalesforceを統合したMCP（モデルコンテキストプロトコル）サーバーの実装です。これにより、日常の言語でSalesforceのデータやメタデータと自然に対話することができます。Claudeはこのサーバーを通じて、日常の言語でSalesforceのデータを照会、管理、操作することができます。

✨ 主な機能

• オブジェクト検索：アカウントに関連するすべてのオブジェクトを検索します。
• スキーマ情報の取得：顧客フィードバックオブジェクトで利用可能なフィールドを表示します。
• レコードの照会：今月作成されたすべてのアカウントを取得します。
• カスタムオブジェクトの管理：顧客フィードバックオブジェクトを作成します。
• オブジェクト間検索：アカウントと商談の中で「クラウド」を検索します。

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/surajadsul02/mcp-server-salesforce.git
   

2. ディレクトリに移動します：

   cd mcp-server-salesforce
   

3. 依存関係をインストールします：

   npm install
   

4. プロジェクトをビルドします：

   npm run build
   

📚 ドキュメント

ユーザー名とパスワードによる認証

• SALESFORCE_USERNAME：Salesforceのユーザー名またはメールアドレス
• SALESFORCE_PASSWORD：Salesforceのパスワード
• SALESFORCE_TOKEN：Salesforceのセキュリティトークン
• SALESFORCE_INSTANCE_URL：SalesforceのインスタンスURL（オプション、デフォルトはhttps://login.salesforce.com）

OAuth2 認証

• SALESFORCE_USERNAME：Salesforceのユーザー名またはメールアドレス
• SALESFORCE_PASSWORD：Salesforceのパスワード
• SALESFORCE_CONSUMER_KEY：接続するアプリケーションのコンシューマーキー
• SALESFORCE_CONSUMER_SECRET：接続するアプリケーションのコンシューマーシークレット
• SALESFORCE_INSTANCE_URL：SalesforceのインスタンスURL（オプション、デフォルトはhttps://login.salesforce.com）

💻 使用例

基本的な使用法

オブジェクト検索

"すべてのアカウント関連オブジェクトを検索する"
"顧客サービスを扱うオブジェクトを表示する"
"注文管理に使用できるオブジェクトは何ですか？"

スキーマ情報の取得

"Accountオブジェクトで利用可能なフィールドは何ですか？"
"ケースステータスのドロップダウンリストの値を表示する"
"商談の関係フィールドを説明する"

レコードの照会

"今月作成されたすべてのアカウントを取得する"
"すべての高優先度ケースと関連する連絡先を表示する"
"金額が10万ドルを超えるすべての商談を検索する"

カスタムオブジェクトの管理

"顧客フィードバックオブジェクトを作成する"
"フィードバックオブジェクトに評価フィールドを追加する"
"サービスリクエストオブジェクトの共有設定を更新する"

オブジェクト間検索

"アカウントと商談の中で'クラウド'を検索する"
"ケースと知識記事の中で'ネットワーク問題'が記載されているものを検索する"
"すべての関連オブジェクトの中で顧客名を検索する"

🔧 技術詳細

開発手順

1. リポジトリをクローンします：

   git clone https://github.com/surajadsul02/mcp-server-salesforce.git
   

2. ディレクトリに移動します：

   cd mcp-server-salesforce
   

3. 依存関係をインストールします：

   npm install
   

4. プロジェクトをビルドします：

   npm run build
   

トラブルシューティング

1. 認証エラー：

   • 認証情報が正しいことを確認します。
   • ユーザー名とパスワードによる認証の場合：セキュリティトークンが正しいことを確認します。
   • OAuth2の場合：コンシューマーキーとシークレットを確認します。

2. 接続問題：

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

3. Cursor IDE統合：

   • 設定を変更した後、Cursor IDEを再起動します。
   • 開発者ツールを使用してエラー情報を確認します。
   • パッケージがグローバルにインストールされていることを確認します。

4. Claude Desktop統合：

   • 設定ファイルの場所を確認します。
   • ファイルの権限を確認します。
   • 設定を変更した後、Claude Desktopを再起動します。
   • 環境変数が正しく設定されていることを確認します。

🤝 コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

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

❓ 問題とサポート

何か問題が発生した場合やサポートが必要な場合は、GitHubリポジトリにIssueを投稿してください。