prodesp-salesforce-mcp

name	prodesp-salesforce-mcp
description	Configura e usa Salesforce DX MCP Server no Cursor para verificações na org PRODESP (alias prodesp-dev), com fallback para sf CLI. Cobre mcp.json, toolsets enxutos (data,orgs), aliases DSP vs PRODESP, quando preferir MCP vs CLI e troubleshooting. Use ao pedir verificação em Salesforce, consulta SOQL, configurar MCP Salesforce, ou explorar OrderSummary/Credencial__c na org dev PRODESP.

PRODESP — Salesforce MCP e verificação (Cursor)

Complementa tarefas/.../sf-cli-dev.md (SOQL do job credenciais e login CLI).

Quando usar

Cenário	Preferir
Consulta/exploração no chat (pedido, campos, status)	MCP (salesforce-prodesp-dev)
Script/CI, pipe shell, reprodução exata no terminal	CLI (sf data query, sf sobject describe)
Deploy/metadata DX	CLI ou MCP com --toolsets metadata (se habilitado)
Governança OAuth por usuário na org	Hosted MCP (setup admin — ver abaixo)

Ordem no agente: se MCP salesforce-prodesp-dev estiver ativo no Cursor, usar tools MCP primeiro; CLI como fallback se MCP indisponível ou usuário pedir comando explícito.

Aliases de org (não confundir)

Alias	Escopo
prodesp-dev	Sandbox PRODESP Portal APIs (padrão verificações)
prodesp-hml	Homologação PRODESP
dsp-dev, dsp-hml	DesenvolveSP — outro projeto

Validar antes de consultar:

sf org list

Login dev PRODESP (se expirado):

sf org login web --alias prodesp-dev --instance-url https://test.salesforce.com

MCP configurado (global)

Arquivo: ~/.cursor/mcp.json — chave salesforce-prodesp-dev.

"salesforce-prodesp-dev": {
  "command": "npx",
  "args": [
    "-y",
    "@salesforce/mcp@latest",
    "-o",
    "prodesp-dev",
    "--toolsets",
    "data,orgs"
  ]
}

Notas:

• Pacote oficial: @salesforce/mcp (binário interno: sf-mcp-server). -o = --orgs.
• Não usar --toolsets all — 60+ tools; infla contexto e tokens.
• Windows: sempre npx; não usar path macOS (/opt/homebrew/bin/...).
• Ativar em Cursor → Settings → Tools & MCP. Primeira carga do npx pode levar 1–2 min (ponto amarelo → verde).

Toolsets recomendados

Necessidade	--toolsets
Verificar pedidos/dados (padrão)	data,orgs
+ retrieve/deploy metadata	data,orgs,metadata
Menos tokens (experimental)	adicionar -d / --dynamic-tools nos args

core é sempre habilitado pelo servidor.

CLI (fallback)

Mesmos aliases. Exemplos usados no workspace:

sf data query --query "SELECT Id, OrderNumber, Status FROM OrderSummary LIMIT 3" -o prodesp-dev --json
sf sobject describe --sobject OrderSummary -o prodesp-dev --json

Scripts que reutilizam o padrão:

• tarefas/.../teste-portal-apis/tests/helpers/salesforce-enrich.ts
• tarefas/.../teste-scope-acessos/scripts/salesforce-pedido-acesso.mjs

Objetos frequentes (Portal APIs)

Objeto	Uso
OrderSummary	Pedido portal (OrderNumber, Status, OriginalOrderId)
Order	Campos Wallet (NomeSistema__c, ClientId__c, IdWallet__c, …)
Credencial__c	Credenciais geradas pelo job Mule
OrderItem	Produtos/APIs do pedido

Hosted MCP (alternativa — não configurado por padrão)

Salesforce gerencia o servidor; OAuth via External Client App (mcp_api, callback cursor://anysphere.cursor-mcp/oauth/callback). App separado do CLI (JWT vs session token).

Sandbox exemplo:

"url": "https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all",
"auth": { "CLIENT_ID": "CONSUMER_KEY_ECA" }

Doc: Configure Cursor — Hosted MCP.

Usar quando admin exigir permissões por usuário e auditoria; para dev local PRODESP, DX MCP local (@salesforce/mcp) é suficiente.

Troubleshooting

Sintoma	Ação
Ponto amarelo persistente	Aguardar download npx; toggle off/on; ver logs do MCP
Org não autorizada	sf org login web --alias prodesp-dev
Campo SOQL inválido	describe do objeto; corrigir nome custom (__c)
MCP falha	Fallback sf data query com -o prodesp-dev --json

Tokens

• MCP com toolsets enxutos (data,orgs) < --toolsets all.
• CLI describe --json completo é caro — preferir MCP ou query com FIELDS(CUSTOM) / campos explícitos.
• Evitar carregar toolsets não usados (lwc, mobile, devops, …).