Salesforce MCP Server

Salesforce MCP サーバー

Claude と Salesforce を統合する MCP（Model Context Protocol）サーバーの実装です。Salesforce のデータやメタデータを自然言語で操作できます。このサーバーを使うと、日常的な言葉で Salesforce のオブジェクトやレコードを検索、変更、管理できます。

特徴

• オブジェクトと項目の管理：自然言語を使ってカスタムオブジェクトや項目を作成、変更できます
• スマートなオブジェクト検索：名前の一部を指定して Salesforce オブジェクトを検索できます
• 詳細なスキーマ情報：任意のオブジェクトについて、項目やリレーションシップの詳細を包括的に取得できます
• 柔軟なデータクエリ：リレーションシップに対応し、複雑なフィルターを使ってレコードを検索できます
• データ操作：レコードの挿入、更新、削除、アップサートを簡単に行えます
• オブジェクト横断検索：SOSL を使って複数のオブジェクトを横断検索できます
• 直感的なエラー処理：Salesforce 固有のエラー詳細を含む、明確なフィードバックが得られます

インストール

npm install -g @surajadsul02/mcp-server-salesforce

セットアップ

Salesforce 認証

Salesforce の認証には、次のいずれかの方法を使用できます。

1. ユーザー名／パスワード認証

1. Salesforce の認証情報を設定します
2. セキュリティトークンを取得します（Salesforce の設定からリセットできます）
3. 設定セクションに記載されている環境変数を設定します

2. コンシューマーキー／シークレットを使った OAuth2 認証

1. Salesforce で接続アプリを設定します
2. コンシューマーキーとコンシューマーシークレットを取得します
3. 設定セクションに記載されている環境変数を設定します

IDE との統合

Cursor IDE のセットアップ

1. パッケージをグローバルにインストールします：

npm install -g @surajadsul02/mcp-server-salesforce

2. Cursor IDE の .cursor/mcp.json で MCP サーバーを設定します：

env コマンドを使用する場合

{
  "mcpServers": {
    "salesforce": {
      "command": "env",
      "args": [
        "[email protected]",
        "SALESFORCE_PASSWORD=YourActualPassword123",
        "SALESFORCE_TOKEN=YourActualSecurityToken123",
        "SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
        "npx",
        "-y",
        "@surajadsul02/mcp-server-salesforce"
      ]
    }
  }
}

Cursor で OAuth2 認証を使用する場合

{
  "mcpServers": {
    "salesforce": {
      "command": "env",
      "args": [
        "[email protected]",
        "SALESFORCE_PASSWORD=YourActualPassword123",
        "SALESFORCE_TOKEN=YourActualSecurityToken123",
        "SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
        "SALESFORCE_CONSUMER_KEY=YourConsumerKey",
        "SALESFORCE_CONSUMER_SECRET=YourConsumerSecret",
        "npx",
        "-y",
        "@surajadsul02/mcp-server-salesforce"
      ]
    }
  }
}

Claude Desktop のセットアップ

1. パッケージをグローバルにインストールします（まだインストールしていない場合）：

npm install -g @surajadsul02/mcp-server-salesforce

2. claude_desktop_config.json に追加します：

ユーザー名／パスワード認証の場合

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@surajadsul02/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_USERNAME": "your_username",
        "SALESFORCE_PASSWORD": "your_password",
        "SALESFORCE_TOKEN": "your_security_token",
        "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
      }
    }
  }
}

OAuth2 認証の場合

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@surajadsul02/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_USERNAME": "your_username",
        "SALESFORCE_PASSWORD": "your_password",
        "SALESFORCE_CONSUMER_KEY": "your_consumer_key",
        "SALESFORCE_CONSUMER_SECRET": "your_consumer_secret",
        "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
      }
    }
  }
}

3. 設定ファイルの場所：
   • macOS：~/Library/Application Support/Claude Desktop/claude_desktop_config.json
   • Windows：%APPDATA%\Claude Desktop\claude_desktop_config.json
   • Linux：~/.config/Claude Desktop/claude_desktop_config.json

必須の環境変数

ユーザー名／パスワード認証の場合：

• 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）

使用例

オブジェクトの検索

"Find all objects related to Accounts"
"Show me objects that handle customer service"
"What objects are available for order management?"

スキーマ情報の取得

"What fields are available in the Account object?"
"Show me the picklist values for Case Status"
"Describe the relationship fields in Opportunity"

レコードの検索

"Get all Accounts created this month"
"Show me high-priority Cases with their related Contacts"
"Find all Opportunities over $100k"

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

"Create a Customer Feedback object"
"Add a Rating field to the Feedback object"
"Update sharing settings for the Service Request object"

オブジェクト横断検索

"Search for 'cloud' in Accounts and Opportunities"
"Find mentions of 'network issue' in Cases and Knowledge Articles"
"Search for customer name across all relevant objects"

開発

ソースからビルドする

# Clone the repository
git clone https://github.com/surajadsul02/mcp-server-salesforce.git

# Navigate to directory
cd mcp-server-salesforce

# Install dependencies
npm install

# Build the project
npm run build

トラブルシューティング

1. 認証エラー

   • 認証情報が正しいことを確認してください
   • ユーザー名／パスワード認証の場合：セキュリティトークンが正しいことを確認してください
   • OAuth2 の場合：コンシューマーキーとシークレットを確認してください

2. 接続の問題

   • Salesforce インスタンスの URL を確認してください
   • ネットワーク接続を確認してください
   • 適切な API アクセス権限があることを確認してください

3. Cursor IDE との統合

   • 設定を変更した後、Cursor IDE を再起動してください
   • 開発者ツール（Help > Toggle Developer Tools）でエラーメッセージを確認してください
   • パッケージがグローバルにインストールされていることを確認してください

4. Claude Desktop との統合

   • 設定ファイルの場所を確認してください
   • ファイルのアクセス許可を確認してください
   • 設定を変更した後、Claude Desktop を再起動してください
   • 環境変数が正しく設定されていることを確認してください

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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

問題とサポート

問題が発生した場合やサポートが必要な場合は、GitHub リポジトリに issue を登録してください。