MCP Salesforce Server

Fornece integração perfeita com o Salesforce usando autenticação OAuth.

GitHub
17
Experimente este MCPPatrocinado

Documentação

MCP Salesforce Server

CI

Um servidor Model Context Protocol (MCP) que fornece integração perfeita com Salesforce usando autenticação OAuth. Este servidor permite que assistentes de IA como o Claude interajam com qualquer organização Salesforce através de uma interface segura e genérica.

✨ Recursos

  • 🎯 Autenticação Perfeita - O Claude detecta automaticamente quando a autenticação é necessária e a trata de forma transparente
  • 🚀 Zero Configuração Manual - Sem necessidade de executar comandos de terminal ou fluxos OAuth manuais
  • 🔐 Autenticação Somente via OAuth - Configuração segura baseada em navegador com renovação automática de tokens
  • 🌐 Integração Salesforce Universal - Funciona com qualquer organização Salesforce, incluindo objetos e campos personalizados
  • 🧠 Aprendizado Inteligente de Instalação - Analisa sua configuração completa do Salesforce para fornecer assistência inteligente
  • 🔍 Descoberta Dinâmica de Esquema - Adapta-se automaticamente à sua configuração Salesforce
  • 🔒 Armazenamento Seguro de Tokens - Armazenamento baseado em arquivos com permissões rigorosas para segurança de nível de produção
  • 🏠 Armazenamento no Diretório Inicial Multiplataforma - Credenciais e cache armazenados no diretório inicial do usuário
  • 📝 Operações CRUD Completas - Consultar, criar, atualizar e excluir qualquer registro Salesforce
  • 📊 Inspeção de Esquema - Obtenha informações detalhadas sobre objetos e campos
  • 💡 Sugestões Contextuais - Fornece sugestões inteligentes de nomes de campos e objetos
  • 💾 Sistema Abrangente de Backup - Backup completo de dados e arquivos com suporte a todos os sistemas de arquivos Salesforce
  • ⏰ Recurso Máquina do Tempo - Recuperação de dados em um ponto específico no tempo e análise histórica
  • 📁 Suporte a Arquivos em Múltiplos Formatos - Faz backup de ContentVersions, Attachments e Documents com metadados adequados

🚀 Início Rápido

Pré-requisitos

  • Node.js 18+
  • macOS (necessário para armazenamento seguro de credenciais)
  • Salesforce Connected App com OAuth configurado

Opções de Instalação

🎯 Recomendado: Uso via NPX (Sem Instalação Necessária)

Use NPX para executar o servidor MCP sem qualquer instalação permanente:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["@aiondadotcom/mcp-salesforce"]
    }
  }
}

✅ Benefícios do Uso via NPX:

  • 🔄 Sempre Atualizado: Usa automaticamente a versão publicada mais recente
  • 💾 Sem Ocupação de Disco: Sem instalação permanente necessária
  • 🛡️ Sem Conflitos: Sem conflitos de pacotes globais
  • ⚡ Atualizações Fáceis: Basta reiniciar - obtém a versão mais recente automaticamente
  • 📋 Configuração Simples: Configuração MCP pronta para copiar e colar

Uso via Linha de Comando NPX:

# Get version
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce --version

# Get help
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce --help

# Run OAuth setup
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce setup

🔧 Alternativa: Configuração de Desenvolvimento

Para desenvolvimento ou personalização:

  1. Clone e instale as dependências:

    git clone https://github.com/AiondaDotCom/mcp-salesforce.git
cd mcp-salesforce
npm install

  2. Configure as credenciais: Use a ferramenta salesforce_setup para configurar suas credenciais quando solicitado

  3. Adicione ao Claude Desktop usando o caminho local (veja Configuração abaixo)

🎯 Comece a Usar

É isso! O Claude lidará automaticamente com a configuração e autenticação quando você usar qualquer ferramenta Salesforce pela primeira vez.

✨ Processo de Configuração Interativo!

  • Use a ferramenta salesforce_setup para configurar suas credenciais
  • O Claude solicitará os detalhes do seu Salesforce Connected App
  • As credenciais são armazenadas com segurança no seu diretório inicial
  • Fluxo OAuth perfeito diretamente do Claude Desktop

🧠 Sistema de Aprendizado Inteligente

  • Use salesforce_learn para analisar sua instalação completa do Salesforce
  • O Claude aprende todos os seus objetos personalizados, campos e relacionamentos
  • Fornece sugestões inteligentes com base na sua configuração específica
  • Assistência contextual para ambientes Salesforce complexos

📦 Status do Pacote NPM

✅ Pacote Publicado com Sucesso!

O pacote @aiondadotcom/mcp-salesforce está ao vivo no NPM e pronto para uso.

Usando o Pacote Publicado

O uso via NPX agora está disponível para todos os usuários:

# Test the published package
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce --version
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce --help

# Run OAuth setup
npx -p @aiondadotcom/mcp-salesforce mcp-salesforce setup

Detalhes da Publicação

  • Nome do Pacote: @aiondadotcom/mcp-salesforce
  • Versão: 1.0.7 (mais recente)
  • Registro: Registro Público NPM
  • Organização: @aiondadotcom
  • Acesso: Público

Status:

  • ✅ Pacote publicado no NPM
  • ✅ Compatibilidade NPX verificada
  • ✅ Wrapper binário implementado
  • ✅ Comando de configuração funcional
  • ✅ Configuração MCP pronta
  • ✅ Disponível para uso imediato

🎉 Toda a funcionalidade NPX agora funciona para usuários finais em todo o mundo!

🔧 Configuração

Configuração do Salesforce Connected App

  1. No Setup do Salesforce, crie um novo Connected App:

    • Nome do App: MCP Salesforce Integration
    • Nome da API: mcp_salesforce_integration
    • E-mail de Contato: Seu e-mail
    • Habilitar Configurações OAuth: ✅ Sim
    • URL de Callback: http://localhost:9876/callback

      A porta 9876 foi escolhida deliberadamente para evitar conflitos com servidores de desenvolvimento comuns (8080, 8000, 3000) e serviços bem conhecidos.

    • Escopos OAuth Selecionados:
      • Gerenciar dados do usuário via APIs (api)
      • Executar solicitações a qualquer momento (refresh_token, offline_access)

  2. Após salvar, copie a Consumer Key e o Consumer Secret

Configuração de Credenciais

Configure suas credenciais usando a ferramenta salesforce_setup quando usar o aplicativo pela primeira vez:

  1. Configuração Interativa: O Claude solicitará suas credenciais Salesforce
  2. Client ID: Sua Salesforce Connected App Consumer Key
  3. Client Secret: Seu Salesforce Connected App Consumer Secret
  4. Instance URL: A URL da sua organização Salesforce (ex.: https://mycompany.salesforce.com)

A ferramenta validará sua entrada e armazenará as credenciais com segurança em ~/.mcp-salesforce.json com permissões restritas (600).

📁 Locais dos Arquivos:

  • Credenciais: ~/.mcp-salesforce.json (contém tokens OAuth e credenciais)
  • Cache: ~/.mcp-salesforce-cache/ (contém o esquema Salesforce aprendido e contexto)
  • Multiplataforma: Funciona em Windows, macOS e Linux

Exemplo de interação:

Claude: I need to set up your Salesforce credentials first. Please use the salesforce_setup tool with your credentials.

You: Use the salesforce_setup tool with clientId: "3MVG9...", clientSecret: "1234567890...", instanceUrl: "https://mycompany.salesforce.com"

Claude: ✅ Salesforce credentials configured successfully! You can now use other Salesforce tools.

Integração com Claude Desktop

🎯 Configuração NPX (Recomendada)

Adicione isto à sua configuração MCP do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["@aiondadotcom/mcp-salesforce"]
    }
  }
}

🔧 Configuração de Desenvolvimento/Local

Para desenvolvimento ou instalações personalizadas:

{
  "mcpServers": {
    "salesforce": {
      "command": "node",
      "args": ["/path/to/mcp-salesforce/src/index.js"]
    }
  }
}

🌐 Configuração MCP do VS Code

Para VS Code com extensão MCP:

{
  "servers": {
    "salesforce": {
      "command": "npx",
      "args": ["@aiondadotcom/mcp-salesforce"]
    }
  }
}

📸 Capturas de Tela de Demonstração

Aqui está um passo a passo do MCP Salesforce Server em ação, mostrando um caso de uso real de verificação e atualização de informações de endereço de empresa:

Passo 1: Solicitação de Verificação de Endereço

Address Verification Claude verificando se a conta Aionda GmbH no Salesforce tem o endereço correto, comparando-o com o endereço atual do site da empresa

Passo 2: Resultados da Comparação de Endereços

Address Analysis Claude identificando que o endereço no Salesforce está desatualizado, mostrando comparação detalhada entre os dados atuais do Salesforce e o endereço real do site da empresa

Passo 3: Atualização Automatizada de Endereço

Address Update Claude atualizando com sucesso a conta Salesforce com o endereço atual correto, mostrando exatamente quais campos foram alterados

Passo 4: Verificação no Salesforce

Salesforce Confirmation O registro de conta atualizado no Salesforce mostrando que as informações de endereço corrigidas agora estão precisas e atualizadas

🛠️ Ferramentas Disponíveis

salesforce_learn

🧠 Aprende sua instalação completa do Salesforce - Analisa todos os objetos, campos e personalizações uma vez e armazena essas informações localmente para assistência inteligente.

// One-time analysis of the Salesforce installation
{}

// Force complete re-analysis
{
  "force_refresh": true,
  "detailed_relationships": true
}

Por que é importante?

  • O Claude aprende seus Objetos Personalizados como "TimeTracking__c", "Project__c", etc.
  • Reconhece todos os Campos Personalizados e seus tipos de dados
  • Fornece sugestões inteligentes com base na sua configuração específica
  • Execute uma vez, e a IA se beneficia permanentemente

salesforce_installation_info

📊 Visão geral da sua instalação Salesforce aprendida - Mostra objetos disponíveis, Campos Personalizados e personalizações.

// Complete overview of the installation
{}

// Details about a specific object
{
  "object_name": "TimeTracking__c"
}

// Search for specific fields
{
  "field_search": "email",
  "show_custom_only": true
}

salesforce_query

Execute consultas SOQL contra qualquer objeto Salesforce.

// Example: Get recent contacts
{
  "query": "SELECT Id, FirstName, LastName, Email FROM Contact WHERE CreatedDate = THIS_MONTH ORDER BY CreatedDate DESC LIMIT 10"
}

🧠 Integração com Aprendizado Inteligente:

  • Avisa automaticamente quando a instalação ainda não foi aprendida
  • Sugere objetos e campos disponíveis
  • Ajuda com nomes de API corretos

salesforce_create

Crie novos registros em qualquer objeto Salesforce.

// Example: Create a new contact
{
  "sobject": "Contact",
  "data": {
    "FirstName": "John",
    "LastName": "Doe", 
    "Email": "john.doe@example.com",
    "Phone": "555-1234"
  }
}

🧠 Contexto Inteligente: Mostra automaticamente os campos obrigatórios para o objeto selecionado quando a instalação foi aprendida.

salesforce_update

Atualize registros existentes.

// Example: Update a contact's email
{
  "sobject": "Contact",
  "id": "003XX000008b6cYAQ",
  "data": {
    "Email": "new.email@example.com",
    "Phone": "555-5678"
  }
}

🧠 Contexto Inteligente: Considera permissões de campos e tipos de dados da instalação aprendida.

salesforce_delete

Exclua registros (⚠️ ação permanente).

// Example: Delete a record
{
  "sobject": "Contact", 
  "id": "003XX000008b6cYAQ"
}

salesforce_describe

Obtenha informações de esquema para objetos e campos.

// Example: Get Contact object schema
{
  "sobject": "Contact"
}

// Or get list of all available objects
{} // Empty parameters

salesforce_backup

💾 Sistema Abrangente de Backup para Salesforce - Cria backups completos de todos os dados e arquivos com informações detalhadas de recuperação.

// Create complete backup
{}

// Incremental backup since specific date
{
  "backup_type": "incremental",
  "since_date": "2025-01-01T00:00:00Z"
}

// Backup with specific options
{
  "options": {
    "include_files": true,
    "include_attachments": true,
    "include_documents": true,
    "parallel_downloads": 10
  }
}

O que é incluído no backup:

  • 📊 Todos os Dados de Objetos - Todos os objetos consultáveis com até 20 campos por objeto
  • 📁 Arquivos Modernos - ContentVersions com metadados completos
  • 📎 Attachments Legados - Anexos clássicos com extensões de arquivo corretas
  • 📄 Documents - Documentos baseados em pastas do sistema legado
  • 🏗️ Informações de Esquema - Estruturas completas de objetos e relacionamentos
  • 📋 Manifesto de Backup - Estatísticas detalhadas e informações de recuperação

Estrutura do Backup:

salesforce-backup-2025-06-04T16-16-35-660Z/
├── metadata/           # Schema and object definitions
├── data/              # JSON data of all objects
├── files/
│   ├── content-versions/  # Modern files
│   ├── attachments/       # Legacy attachments
│   └── documents/         # Legacy documents
└── backup-manifest.json   # Backup overview

salesforce_backup_list

📋 Mostrar Backups Disponíveis - Visão geral de todos os backups locais com estatísticas e metadados.

// List all available backups
{}

// Details about a specific backup
{
  "backup_name": "salesforce-backup-2025-06-04T16-16-35-660Z"
}

salesforce_time_machine

⏰ Viagem no Tempo pelos Dados Salesforce - Analisa mudanças de dados entre diferentes pontos de backup e permite recuperação direcionada.

// Compare current state with a backup
{
  "backup_timestamp": "2025-06-04T16:16:35.660Z",
  "object_name": "Account"
}

// Show all changes since a specific backup
{
  "backup_timestamp": "2025-06-04T16:16:35.660Z",
  "show_all_changes": true
}

// Detailed analysis for specific records
{
  "backup_timestamp": "2025-06-04T16:16:35.660Z",
  "object_name": "Contact", 
  "record_id": "003XX000008b6cYAQ"
}

Recursos da Máquina do Tempo:

  • 📊 Comparação de Dados - Mostra diferenças entre o backup e o estado atual
  • 🔍 Histórico de Alterações - Quais campos foram alterados e quando
  • 🗑️ Registros Excluídos - Encontra registros que foram excluídos desde o backup
  • 📈 Análise de Crescimento - Avaliação estatística do desenvolvimento dos dados
  • 🎯 Recuperação Direcionada - Identificação precisa de alterações

salesforce_auth

Autentique-se com o Salesforce. Detecta automaticamente se a autenticação é necessária e lida com o fluxo OAuth.

// Example: Standard authentication (detects if needed)
{}

// Example: Force re-authentication even if tokens appear valid
{
  "force": true
}

✨ Recursos Principais:

  • Detecção Automática: O Claude sugere automaticamente esta ferramenta quando a autenticação é necessária
  • Sem Configuração Manual: Elimina a necessidade de executar npm run setup manualmente
  • Autenticação Inteligente: Só autentica quando necessário, verifica tokens existentes primeiro
  • Integração Perfeita: Funciona de forma transparente em segundo plano

Esta ferramenta é sugerida automaticamente quando:

  • Você tenta usar ferramentas Salesforce sem autenticação
  • Seus tokens expiraram
  • Ocorrem erros de autenticação
  • A configuração inicial é necessária

🧠 Sistema de Aprendizado Inteligente

Por que o Aprendizado é Importante?

Cada instalação Salesforce é única, com:

  • Objetos Personalizados como "TimeTracking__c", "Project__c", "CustomerCare__c"
  • Campos Personalizados em objetos padrão
  • Workflows Específicos e regras de validação
  • Estruturas de Dados Individuais

O modelo de treinamento normal da IA só conhece objetos Salesforce padrão. Sem conhecimento da sua instalação específica, a IA não pode fornecer assistência inteligente.

Como Funciona o Aprendizado?

  1. Análise Única: salesforce_learn analisa sua instalação completa
  2. Documentação Local: Todos os objetos, campos e relacionamentos são armazenados localmente
  3. Suporte Inteligente: O Claude pode então fazer sugestões precisas e responder perguntas complexas

Exemplo de Fluxo de Trabalho:

You: "Are there any time tracking entries for July 2025?"

Without Learning:
❌ Claude: "I don't know any object called 'TimeTracking'"

With Learning:
✅ Claude: "I'm checking the 'TimeTracking__c' object for entries from July 2025..."
   Automatically executes the correct SOQL query

Quando Você Deve Usar o Aprendizado?

  • Durante a configuração inicial - Uma vez após a instalação
  • Após mudanças importantes - Quando novos Objetos Personalizados são adicionados
  • Quando tiver problemas - Quando o Claude não encontra objetos ou campos

O que é Aprendido?

  • Todos os SObjects (Padrão e Personalizados)
  • Todos os Campos com tipos de dados e permissões
  • Relacionamentos entre objetos
  • Valores de Picklist e regras de validação
  • Campos Obrigatórios para melhor validação

💡 O aprendizado é executado apenas uma vez e torna todas as interações futuras muito mais inteligentes!

💡 Exemplos de Uso

🚀 Primeiros Passos Após a Instalação

  1. Autenticação: Claude detecta automaticamente quando a autenticação é necessária
  2. Comece a Aprender: 
    You: "Learn my Salesforce installation"
Claude: Automatically uses the salesforce_learn tool
  3. Explore a Instalação: 
    You: "Show me an overview of my Salesforce installation"
Claude: Uses salesforce_installation_info for a summary

🔍 Consultas Inteligentes com Instalação Aprendida

You: "Show me all projects from this year"
Claude: Automatically recognizes your "Project__c" Custom Object and creates:
SELECT Id, Name, StartDate__c, Status__c FROM Project__c WHERE CALENDAR_YEAR(CreatedDate) = 2025

You: "Are there any time tracking entries for July 2025?"
Claude: Finds your "TimeTracking__c" object and queries:
SELECT Id, Name, Month__c, Hours__c FROM TimeTracking__c WHERE Month__c = 'July 2025'

Exemplos de Consultas

-- Get all accounts in the technology industry
SELECT Id, Name, Industry, Website FROM Account WHERE Industry = 'Technology'

-- Find contacts created this week
SELECT Id, Name, Email, CreatedDate FROM Contact WHERE CreatedDate = THIS_WEEK

-- Get opportunities closing this quarter
SELECT Id, Name, Amount, CloseDate FROM Opportunity WHERE CloseDate = THIS_QUARTER

Trabalhando com Objetos Personalizados

O servidor descobre automaticamente objetos personalizados:

// Describe a custom object
{
  "sobject": "CustomProject__c"
}

// Query custom object
{
  "query": "SELECT Id, Name, CustomField__c FROM CustomProject__c LIMIT 10"
}

// Create custom object record
{
  "sobject": "CustomProject__c",
  "data": {
    "Name": "New Project",
    "CustomField__c": "Custom Value"
  }
}

💾 Recursos de Backup e Máquina do Tempo

🚀 Sistema de Backup do Salesforce

O MCP Salesforce Server oferece um sistema de backup profissional que pode proteger sua instalação completa do Salesforce:

O que Torna o Sistema de Backup Especial?

  • 🎯 Cobertura Completa: Faz backup de todos os três sistemas de arquivos do Salesforce

    • Arquivos Modernos (ContentDocument/ContentVersion)
    • Anexos Legados (anexos clássicos)
    • Documentos (documentos legados baseados em pastas)

  • 📊 Coleta Inteligente de Dados:

    • Todos os objetos consultáveis (Padrão + Personalizado)
    • Até 20 campos por objeto para backup abrangente de dados
    • Filtragem automática de campos binários

  • ⚡ Alto Desempenho:

    • Downloads paralelos com concorrência configurável
    • Lógica de repetição com backoff exponencial
    • Processamento em lote para grandes volumes de dados

Criando um Backup

You: "Create a backup of my Salesforce data"
Claude: Automatically starts the salesforce_backup tool

Resultado do Backup:

✅ Backup successfully created!
📊 Statistics:
- 7 objects backed up
- 1,247 records exported  
- 6 files downloaded
- 4.07 MB total size
- Duration: 23 seconds

📁 Location: /backups/salesforce-backup-2025-06-04T16-16-35-660Z/

Estrutura do Backup

salesforce-backup-2025-06-04T16-16-35-660Z/
├── backup-manifest.json     # Backup overview with statistics
├── metadata/
│   ├── objects-schema.json  # All object definitions
│   └── file-manifest.json   # File download protocol
├── data/                    # JSON data of all objects
│   ├── Account.json         # Account records
│   ├── Contact.json         # Contact records
│   ├── Opportunity.json     # Opportunity records
│   └── CustomObject__c.json # Custom Object data
└── files/                   # All Salesforce files
    ├── content-versions/    # Modern files (.pdf, .docx, etc.)
    ├── attachments/         # Legacy attachments
    └── documents/           # Legacy documents

⏰ Recurso Máquina do Tempo

A Máquina do Tempo permite que você viaje no tempo e analise mudanças nos dados:

Principais Recursos

  • 🔍 Comparação de Dados: Compara o estado atual com backups históricos
  • 📊 Análise de Mudanças: Mostra exatamente quais campos foram alterados
  • 🗑️ Registros Excluídos: Encontra registros que foram excluídos desde o backup
  • 📈 Análise de Tendências: Avaliação estatística do desenvolvimento dos dados

Usando a Máquina do Tempo

You: "Compare the current Account data with the backup from June 4th"
Claude: Uses salesforce_time_machine for detailed analysis

Exemplo de Resultado:

⏰ Time Machine Analysis - Account Object
📅 Backup: 2025-06-04T16:16:35.660Z vs. Current

📊 Changes found:
• Modified records: 3
• New records: 2  
• Deleted records: 1

🔍 Details:
Account "Aionda GmbH" (001XX000003DHPF):
- BillingStreet: "Alte Straße 1" → "Königstraße 10a"
- BillingCity: "München" → "Stuttgart"
- LastModifiedDate: 2025-06-04 → 2025-06-04

Account "TechCorp Ltd" (001XX000003DHPG):
- Status: Active → Inactive
- LastModifiedDate: 2025-06-03 → 2025-06-04

Casos de Uso Práticos

  1. 📋 Conformidade e Auditoria: Evidência de mudanças nos dados
  2. 🔧 Análise de Erros: "O que era diferente antes do problema?"
  3. 📊 Qualidade de Dados: Monitoramento da integridade dos dados
  4. 🚨 Gerenciamento de Mudanças: Controle sobre mudanças críticas
  5. 💡 Inteligência de Negócios: Análise de tendências ao longo do tempo

🎯 Fluxo de Trabalho de Backup Recomendado

1. Initial Setup:
   You: "Learn my Salesforce installation"
   → Claude analyzes your complete org
   
2. Regular Backups:
   You: "Create a backup"
   → Claude backs up all data and files
   
3. Monitoring:
   You: "Show me all available backups"
   → Claude lists backup history
   
4. Analysis:
   You: "What has changed since the last backup?"
   → Claude uses Time Machine for comparison

💡 Dica Profissional: Combine Aprendizado + Backup + Máquina do Tempo para controle máximo do Salesforce!

🔒 Segurança

  • Armazenamento de Tokens: Tokens de atualização armazenados com segurança em cache/salesforce-tokens.json com permissões de arquivo restritas (600)
  • Sem Segredos em Texto Puro: Tokens de acesso mantidos apenas na memória
  • Atualização Automática: Tokens atualizados automaticamente antes da expiração
  • Limpeza Segura: Tokens removidos da memória após o uso
  • Validação de Entrada: Todas as entradas validadas e sanitizadas
  • Migração: Armazenamento de tokens baseado em arquivo com permissões 600 para gerenciamento seguro de credenciais

🧪 Testes

# Run tests
npm test

# Test authentication
npm run setup -- --test

# Validate configuration
npm run setup -- --validate

🐛 Solução de Problemas

Problemas de Autenticação

🎯 Autenticação Automática: Claude detecta automaticamente problemas de autenticação e sugere a ferramenta salesforce_auth. Nenhuma solução manual de problemas necessária!

Cenários Comuns:

  1. Primeiro uso: Claude sugerirá automaticamente a autenticação quando você tentar usar as ferramentas do Salesforce pela primeira vez
  2. Expiração de token: Quando os tokens expiram, Claude detecta isso e solicita reautenticação
  3. Credenciais inválidas: Mensagens de erro claras orientam você a corrigir problemas de configuração
  4. Sessão expirada: Detecção automática com avisos amigáveis para reautenticar

Segurança de Tokens

🔒 Armazenamento Seguro de Tokens: Os tokens de autenticação são armazenados com segurança no sistema de arquivos local com permissões estritas.

Recursos de Segurança:

  • Permissões de Arquivo: Os arquivos de token são criados com permissões 0600 (somente leitura/gravação pelo proprietário)
  • Localização: Tokens armazenados em cache/salesforce-tokens.json (excluídos do git)
  • Segurança Automática: Verificação de permissões e correção automática se necessário
  • Sem Exposição de Rede: Os tokens nunca saem da sua máquina local
  • Segurança Baseada em Arquivo: Armazenamento seguro de tokens com permissões estritas de arquivo para proteção de credenciais

Verificação de Segurança:

# Check token file security
ls -la cache/salesforce-tokens.json
# Should show: -rw------- (600 permissions)

# Run security test
node test-token-security.js

O que isso significa:

  • Outros usuários do seu sistema não podem ler seus tokens do Salesforce
  • Somente sua conta de usuário tem acesso aos dados de autenticação
  • Impede acesso não autorizado à sua organização Salesforce
  • Está em conformidade com as melhores práticas de segurança para armazenamento de credenciais

Correção Rápida no Claude Desktop

Se você receber erros de autenticação, basta dizer ao Claude:

Authenticate with Salesforce

Ou Claude sugerirá automaticamente: Use the salesforce_auth tool to authenticate with Salesforce

✨ Chega de configuração manual no terminal! Tudo acontece perfeitamente pelo Claude Desktop.

Problemas de Conexão

  1. "Não é possível conectar ao Salesforce": Verifique sua URL de Instância
  2. "Permissões insuficientes": Verifique as permissões do usuário no Salesforce
  3. "Erros de CORS": Garanta que a URL de callback do Connected App esteja correta

Erros Comuns de SOQL

  1. Campo não encontrado: Use nomes de API, não rótulos de campo
  2. Objeto não encontrado: Verifique a ortografia e o nome de API dos objetos
  3. Erros de sintaxe: Garanta a sintaxe correta de SOQL com aspas simples

📚 Documentação

🤝 Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de recurso: git checkout -b feature-name
  3. Faça suas alterações e teste minuciosamente
  4. Envie um pull request com descrição detalhada

📄 Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

🆘 Suporte

  • Problemas: Relate bugs e solicitações de recursos pelo GitHub Issues
  • Documentação: Consulte a pasta docs/ para obter guias detalhados
  • Comunidade: Participe das discussões no GitHub Discussions

Feito com ❤️ para o ecossistema MCP