MCP Force

Expone las APIs de Salesforce como herramientas para agentes de IA, permitiendo la interacción en lenguaje natural con organizaciones de Salesforce.

GitHub
19
Prueba este MCPPatrocinado

Documentación

MCP Force : un servidor MCP para exponer las APIs de Salesforce como herramientas para agentes de IA

Este programa proporciona un servidor MCP (Model Context Protocol) que expone las APIs de Salesforce como herramientas para su uso en agentes de IA. Permite que asistentes de IA como Claude Desktop y VS Code interactúen con su organización de Salesforce mediante lenguaje natural.

Actualmente, se cubren las siguientes APIs:

  • APIs de la plataforma Salesforce : REST API, Bulk v2 API, GraphQL API, Tooling API, Auth API

EXPERIMENTAL

Este paquete es experimental.

Por favor, úselo SOLO en un sandbox, una organización de desarrollo o una organización scratch. NUNCA lo use en producción: ha sido advertido.

Las APIs proporcionadas por MCP Force se definen en el paquete @rapidocloud/mcp-tools en NPMjs.org. Todas las APIs de Salesforce se conectarán, dependiendo de las solicitudes de los usuarios: abra un issue para solicitar más.

Finalmente, la autenticación de usuario es manual, por ahora: establezca un token de acceso OAuth2 en el archivo .env. Esto se mejorará muy pronto.

Características

  • Conectar a organizaciones de Salesforce
  • Consultar y manipular datos de Salesforce
  • Ejecutar consultas SOQL
  • Gestionar registros de Salesforce
  • Integración con VS Code y Claude Desktop

Configuración

1. Configuración del entorno

Cree un archivo .env en el directorio de su proyecto con sus credenciales de Salesforce:

SALESFORCE_ENDPOINT='https://mydomain-dev-ed.developer.my.salesforce.com'

# run this command :
# sf org login web --instance-url ${SALESFORCE_ENDPOINT} --json
SALESFORCE_ACCESS_TOKEN='<your_access_token_here>'

# Set your port : 3001 by default
PORT=3021

3. Uso de la línea de comandos

Mostrar el menú de ayuda con los comandos y opciones disponibles

npx @rapidocloud/mcp-force@1.0.0-dev.5 --help

Listar todos los endpoints de la API de Salesforce actualmente conocidos por MCP Force

npx @rapidocloud/mcp-force@1.0.0-dev.5  list-tools

Ejecutar una versión específica de MCP Force

npx @rapidocloud/mcp-force@1.0.0-dev.5

Ejecutar el servidor MCP en modo predeterminado con todas las APIs seleccionadas

npx @rapidocloud/mcp-force run-server

Ejecutar el servidor MCP solo con las APIs especificadas para reducir el número de herramientas cargadas

npx @rapidocloud/mcp-force run-server --selectedAPIs 'rest,tooling'

Ejecutar el servidor MCP con todas las APIs excepto las especificadas

npx @rapidocloud/mcp-force run-server --barredAPIs 'bulk'

Ejecutar el servidor MCP con todos los endpoints de API excepto los nombres de herramientas especificados

npx @rapidocloud/mcp-force run-server --barredToolNames 'run_tests_sync, tooling_run_tests_async'

Ejecutar el servidor MCP con una versión específica de MCP Tools, APIs seleccionadas y APIs bloqueadas

npm install -g @rapidocloud/mcptools@1.0.0-dev.9 1>&2 && npx @rapidocloud/mcp-force@1.0.0-dev.5 run-server --selectedAPIs 'rest, tooling, metadata' --barredAPIs 'auth, bulk, graphql'

Para usar esto en la configuración de su servidor MCP:

{
  "servers": {
    "mcpforce": {
      "command": "bash",
      "args": ["-c", "npm install -g @rapidocloud/mcp-tools@1.0.0-dev.9 1>&2 && npx @rapidocloud/mcp-force@1.0.0-dev.5 run-server --selectedAPIs 'rest, tooling, metadata' --barredAPIs 'auth, bulk, graphql'"],
      "env": {
        "SALESFORCE_ENDPOINT": "https://mydomain-dev-ed.developer.my.salesforce.com",
        "SALESFORCE_ACCESS_TOKEN": "<your_access_token_here>",
        "PORT": "3021"
      }
    }
  }
}

4. Configuración de VS Code

Cree o actualice .vscode/mcp.json para configurar el servidor MCP:

{
  "servers": {
    "mcp-force": {
      "command": "npx",
      "args": ["-y", "@rapidocloud/mcp-force"],
      "env": {
        "SALESFORCE_ENDPOINT": "https://mydomain-dev-ed.developer.my.salesforce.com",
        "SALESFORCE_ACCESS_TOKEN": "<your_access_token_here>",
        "PORT": "3021"
      }
    }
  }
}

5. Configuración de Claude Desktop

Agregue el servidor MCP a su archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-force": {
      "command": "npx",
      "args": ["-y", "@rapidocloud/mcp-force"],
      "env": {
        "SALESFORCE_ENDPOINT": "https://mydomain-dev-ed.developer.my.salesforce.com",
        "SALESFORCE_ACCESS_TOKEN": "<your_access_token_here>",
        "PORT": "3021"
      }
    }
  }
}

Instalación

¡No se requiere instalación! El servidor MCP se descargará y ejecutará automáticamente usando npx cuando se configure en su cliente MCP.

Para desarrollo o pruebas, también puede ejecutarlo directamente:

npx @rapidocloud/mcp-force list-tools
npx @rapidocloud/mcp-force run-server

Ejemplos de uso

Modo agente de VS Code

En VS Code con la extensión MCP y el modo agente habilitado:

  1. Abra la Paleta de comandos (Cmd/Ctrl + Shift + P)
  2. Seleccione "MCP: Start Agent Session"
  3. Pregunte al agente:
Sum the amount of all open Salesforce opportunities

El agente:

  • Se conectará a su organización de Salesforce
  • Consultará oportunidades abiertas usando SOQL
  • Calculará el monto total
  • Le proporcionará la suma y el desglose

Modo agente de Claude Desktop

En Claude Desktop con el servidor MCP configurado:

  1. Inicie una nueva conversación
  2. Pregunte a Claude:
Sum the total amount of all open Salesforce opportunities?
Connect to my Salesforce org and run a query to get this information.

Claude:

  • Usará las herramientas MCP para conectarse a Salesforce
  • Ejecutará una consulta SOQL como: SELECT Amount FROM Opportunity WHERE IsClosed = false AND Amount != null
  • Sumará los montos y proporcionará un informe detallado

Ejemplo de respuesta:

I've connected to your Salesforce org and found the following open opportunities:

Total Open Opportunity Amount: $2,450,000

Breakdown:
- 15 opportunities with amounts ranging from $25,000 to $500,000
- Average deal size: $163,333
- Largest opportunity: $500,000
- Smallest opportunity: $25,000

Solución de problemas

  • Asegúrese de que sus credenciales de Salesforce sean correctas en las variables de entorno
  • Verifique que su token de seguridad esté actualizado
  • Compruebe que el servidor MCP esté correctamente configurado en su aplicación cliente
  • Revise los registros de la consola para detectar errores de conexión
  • Asegúrese de tener Node.js 22+ instalado para que npx funcione correctamente

Requisitos

  • Node.js 22+
  • Credenciales válidas de Salesforce
  • VS Code con la extensión MCP (para uso de VS Code)
  • Claude Desktop (para uso de Claude Desktop)