MCP Force

Expõe as APIs do Salesforce como ferramentas para agentes de IA.

GitHub
19

Documentação

MCP Force : um servidor MCP para expor APIs do Salesforce como ferramentas para Agentes de IA

Este programa fornece um servidor MCP (Model Context Protocol) que expõe APIs do Salesforce como ferramentas para uso em agentes de IA. Ele permite que assistentes de IA como Claude Desktop e VS Code interajam com sua organização Salesforce por meio de linguagem natural.

Atualmente, as seguintes APIs são cobertas:

  • APIs da Plataforma Salesforce: REST API, Bulk v2 API, GraphQL API, Tooling API, Auth API

EXPERIMENTAL

Este pacote é experimental.

Use-o SOMENTE em um sandbox, uma org de desenvolvedor ou uma scratch org. NUNCA use isso em produção: você foi avisado.

As APIs fornecidas pelo MCP Force são definidas no pacote @rapidocloud/mcp-tools no NPMjs.org. Todas as APIs do Salesforce serão conectadas, dependendo das solicitações dos usuários: abra uma issue para pedir mais.

Por fim, a autenticação do usuário é manual, por enquanto: defina um token de acesso OAuth2 no arquivo .env. Isso será melhorado muito em breve.

Recursos

  • Conectar-se a organizações Salesforce
  • Consultar e manipular dados do Salesforce
  • Executar consultas SOQL
  • Gerenciar registros do Salesforce
  • Integração com VS Code e Claude Desktop

Configuração

1. Configuração do Ambiente

Crie um arquivo .env no diretório do seu projeto com suas credenciais do 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 pela Linha de Comando

Exibir o menu de ajuda com comandos e opções disponíveis

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

Listar todos os endpoints de API do Salesforce atualmente conhecidos pelo MCP Force

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

Executar uma versão específica do MCP Force

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

Executar o servidor MCP no modo padrão com todas as APIs selecionadas

npx @rapidocloud/mcp-force run-server

Executar o servidor MCP apenas com APIs especificadas para reduzir o número de ferramentas carregadas

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

Executar o servidor MCP com todas as APIs, exceto as especificadas

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

Executar o servidor MCP com todos os endpoints de API, exceto os nomes de ferramentas especificados

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

Executar o servidor MCP com uma versão específica do MCP Tools, APIs selecionadas e 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 isso na configuração do seu 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. Configuração do VS Code

Crie ou atualize .vscode/mcp.json para configurar o 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. Configuração do Claude Desktop

Adicione o servidor MCP ao arquivo de configuração do seu 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"
      }
    }
  }
}

Instalação

Nenhuma instalação necessária! O servidor MCP será baixado e executado automaticamente usando npx quando configurado no seu cliente MCP.

Para desenvolvimento ou testes, você também pode executá-lo diretamente:

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

Exemplos de Uso

Modo Agente no VS Code

No VS Code com a extensão MCP e o modo Agente habilitado:

  1. Abra a Paleta de Comandos (Cmd/Ctrl + Shift + P)
  2. Selecione "MCP: Start Agent Session"
  3. Pergunte ao agente:
Sum the amount of all open Salesforce opportunities

O agente irá:

  • Conectar-se à sua org Salesforce
  • Consultar oportunidades abertas usando SOQL
  • Calcular o valor total
  • Fornecer a você a soma e o detalhamento

Modo Agente no Claude Desktop

No Claude Desktop com o servidor MCP configurado:

  1. Inicie uma nova conversa
  2. Pergunte ao Claude:
Sum the total amount of all open Salesforce opportunities?
Connect to my Salesforce org and run a query to get this information.

Claude irá:

  • Usar as ferramentas MCP para conectar-se ao Salesforce
  • Executar uma consulta SOQL como: SELECT Amount FROM Opportunity WHERE IsClosed = false AND Amount != null
  • Somar os valores e fornecer um relatório detalhado

Exemplo de resposta:

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

Solução de Problemas

  • Certifique-se de que suas credenciais do Salesforce estejam corretas nas variáveis de ambiente
  • Verifique se o seu token de segurança está atualizado
  • Verifique se o servidor MCP está configurado corretamente no seu aplicativo cliente
  • Revise os logs do console para erros de conexão
  • Certifique-se de ter o Node.js 22+ instalado para que o npx funcione corretamente

Requisitos

  • Node.js 22+
  • Credenciais válidas do Salesforce
  • VS Code com extensão MCP (para uso no VS Code)
  • Claude Desktop (para uso no Claude Desktop)