Skip to main content
Glama
deenesjakoruzh
ZLeventer

salesforce-marketing-mcp

by ZLeventer
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

salesforce-marketing-mcp

MIT License Node.js MCP

Un servidor del Protocolo de Contexto de Modelo (MCP) listo para producción que brinda a los asistentes de IA (Claude, Cursor, etc.) acceso directo a los datos de Salesforce CRM. Creado para operaciones de marketing, operaciones de ingresos y equipos de marketing B2B que desean acceso asistido por IA a leads, contactos, campañas, miembros de campaña, tareas y 14 herramientas de informes, todo sin escribir SOQL.

Características

  • Leads — Buscar, obtener, crear, actualizar y convertir leads

  • Contactos — Buscar, obtener, crear, actualizar y buscar por correo electrónico

  • Cuentas — Buscar, obtener y listar contactos por cuenta

  • Campañas — Listar, obtener, crear y actualizar campañas

  • Miembros de campaña — Listar miembros, agregar individuos, agregar masivamente hasta 200, actualizar estados

  • Tareas — Crear tareas; listar por lead, contacto o campaña

  • Informes de análisis — Listar, ejecutar y describir informes de Salesforce Analytics

  • Análisis de campaña — Cálculo de ROI, desglose de estado de miembros, campañas principales, tendencias de rendimiento

  • Atribución — Desglose de fuente de leads, pipeline por campaña, CampaignInfluence, ingresos ganados por campaña, métricas de conversión de leads

  • Pipeline — Resumen de pipeline, pipeline por fuente de lead, tendencia de MQL, resumen de pronóstico

  • Actividad — Resumen de actividad por dimensión, actividades recientes por lead o contacto

  • Herramientas avanzadas — SOQL sin procesar, descripción de SObject, listar todos los objetos

Requisitos previos

  • Una organización de Salesforce (cualquier edición con acceso a API)

  • Tu nombre de usuario, contraseña y token de seguridad de Salesforce

    • Para obtener/restablecer tu token de seguridad: Configuración > Información personal > Restablecer mi token de seguridad

  • Node.js 20 o posterior

No se requiere configuración de aplicación conectada ni OAuth.

Configuración

1. Instalación

npm install -g salesforce-marketing-mcp
# or run directly with npx
npx salesforce-marketing-mcp

2. Variables de entorno

Variable

Requerido

Predeterminado

Descripción

SF_USERNAME

Sí

—

Correo electrónico de inicio de sesión de Salesforce

SF_PASSWORD

Sí

—

Contraseña de Salesforce

SF_SECURITY_TOKEN

Sí

—

Token de seguridad (se añade a la contraseña al iniciar sesión)

SF_LOGIN_URL

No

https://login.salesforce.com

Usa https://test.salesforce.com para entornos sandbox

SF_API_VERSION

No

60.0

Versión de la API de Salesforce

Crea un archivo .env o establécelas en tu terminal:

export SF_USERNAME="you@yourcompany.com"
export SF_PASSWORD="yourpassword"
export SF_SECURITY_TOKEN="yourtoken"
# For sandbox:
export SF_LOGIN_URL="https://test.salesforce.com"

Uso

Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken",
        "SF_LOGIN_URL": "https://login.salesforce.com"
      }
    }
  }
}

Claude Code

claude mcp add salesforce-marketing-mcp \
  -e SF_USERNAME=you@yourcompany.com \
  -e SF_PASSWORD=yourpassword \
  -e SF_SECURITY_TOKEN=yourtoken \
  -- npx salesforce-marketing-mcp

Cursor

En .cursor/mcp.json:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken"
      }
    }
  }
}

Referencia de herramientas

Herramienta

Descripción

sf_search_leads

Búsqueda SOSL en nombre de lead, correo electrónico y empresa

sf_get_lead

Registro completo de lead por ID

sf_create_lead

Crear un nuevo lead

sf_update_lead

Actualizar cualquier campo de lead

sf_convert_lead

Convertir lead en Cuenta / Contacto / Oportunidad

sf_search_contacts

Búsqueda SOSL en nombre de contacto y correo electrónico

sf_get_contact

Registro completo de contacto con nombre de cuenta

sf_create_contact

Crear un nuevo contacto

sf_update_contact

Actualizar cualquier campo de contacto

sf_contact_by_email

Encontrar contactos por dirección de correo electrónico (hasta 10 coincidencias)

sf_search_accounts

Búsqueda SOSL en nombre de cuenta

sf_get_account

Registro de cuenta con recuento de oportunidades abiertas y leads

sf_list_account_contacts

Contactos asociados con una cuenta

sf_list_campaigns

Listar campañas con filtros opcionales de estado/tipo/activo

sf_get_campaign

Registro completo de campaña con todas las métricas de rendimiento

sf_create_campaign

Crear una nueva campaña

sf_update_campaign

Actualizar cualquier campo de campaña

sf_get_campaign_members

Listar miembros de campaña con detalles de lead/contacto

sf_add_campaign_member

Agregar un solo lead o contacto a una campaña

sf_bulk_add_campaign_members

Agregar hasta 200 leads/contactos en una llamada

sf_update_campaign_member_status

Actualizar estado de miembro y bandera HasResponded

sf_create_task

Crear una tarea vinculada a un lead, contacto o campaña

sf_list_tasks_by_lead

Tareas asociadas con un lead

sf_list_tasks_by_contact

Tareas asociadas con un contacto

sf_list_tasks_by_campaign

Tareas asociadas con una campaña

sf_list_reports

Listar informes de Salesforce Analytics disponibles

sf_run_report

Ejecutar un informe y devolver filas estructuradas

sf_get_report_metadata

Definiciones de columna y agrupaciones para un informe

sf_campaign_roi

ROI, CPL, CPO y tasa de respuesta por campaña

sf_campaign_member_status_breakdown

Recuentos de estado de miembros para una campaña

sf_top_campaigns

Clasificar campañas por respuestas, oportunidades o ingresos ganados

sf_campaign_performance_trend

Adiciones de miembros a lo largo del tiempo (semana/mes)

sf_lead_source_breakdown

Volumen de leads, conversiones e ingresos por fuente de lead

sf_pipeline_by_campaign

Pipeline abierto agrupado por campaña y etapa

sf_campaign_influence

Registros de CampaignInfluence que vinculan campañas con oportunidades

sf_won_revenue_by_campaign

Ingresos cerrados-ganados agrupados por campaña principal

sf_lead_conversion_metrics

Tasas de conversión por fuente de lead o campaña

sf_pipeline_summary

Pipeline por etapa: recuento, cantidad, probabilidad, ponderado

sf_pipeline_by_lead_source

Pipeline agrupado por fuente de lead

sf_mql_trend

Volumen de MQL (o cualquier estado) a lo largo del tiempo

sf_forecast_summary

Ingresos esperados para oportunidades que cierran en un rango de fechas

sf_activity_summary

Recuentos de tareas/eventos por fuente de lead, campaña o propietario

sf_recent_activities_by_lead

Tareas y eventos para un lead específico

sf_recent_activities_by_contact

Tareas y eventos para un contacto específico

sf_run_soql

Ejecutar SOQL sin procesar (salida de emergencia para consultas personalizadas)

sf_describe_object

Metadatos de campo completos para cualquier SObject

sf_list_objects

Listar todos los SObjects consultables con filtro opcional

Ejemplos de prompts

Una vez conectado, haz preguntas a Claude como:

"¿Cuáles son mis 5 mejores campañas por ingresos ganados este trimestre?"

"Muéstrame el desglose de fuentes de leads de los últimos 90 días; incluye las tasas de conversión."

"Crea una tarea de seguimiento para el lead 00Q... para el próximo viernes."

"¿Qué campañas tienen el ROI más alto? Incluye el costo por lead."

"Muéstrame la tendencia de MQL por mes para este año."

"Agrega todos los leads de esta lista a la campaña de Webinar del Q2 con el estado 'Invited'."

"¿Cuál es nuestro resumen de pipeline actual por etapa con valores ponderados?"

Cómo funciona

  • Autenticación: Se conecta mediante nombre de usuario + contraseña + token de seguridad de Salesforce usando jsforce. La conexión se almacena en caché durante 25 minutos y se actualiza automáticamente ante errores INVALID_SESSION_ID.

  • Producción y sandbox: Establece SF_LOGIN_URL=https://test.salesforce.com para apuntar a un sandbox.

  • Límites de tasa: Todas las consultas respetan los límites de la API de Salesforce. Usa los parámetros limit para controlar el tamaño de los resultados.

Licencia

MIT

Install Server
A
license - permissive license
B
quality
C
maintenance

How are these scores calculated?

Resources

Tools

View all tools

Related MCP Connectors

  • Vee3

    Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

  • mcp-knowledge

    100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.

  • 11agents Cloud MCP

    Cloud MCP for project data, analytics, research, content planning, media generation, and growth.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/salesforce-marketing-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server