Skip to main content
Glama
deenesjakoruzh
ZLeventer

salesforce-marketing-mcp

by ZLeventer
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

salesforce-marketing-mcp

MIT License Node.js MCP

AI 어시스턴트(Claude, Cursor 등)가 Salesforce CRM 데이터에 직접 액세스할 수 있도록 지원하는 프로덕션급 Model Context Protocol (MCP) 서버입니다. 마케팅 운영, 수익 운영, B2B 마케팅 팀을 위해 구축되었으며, SOQL을 작성할 필요 없이 AI를 통해 리드, 연락처, 캠페인, 캠페인 멤버, 작업 및 14개의 보고 도구에 액세스할 수 있습니다.

기능

  • 리드 — 리드 검색, 가져오기, 생성, 업데이트 및 변환

  • 연락처 — 연락처 검색, 가져오기, 생성, 업데이트 및 이메일로 조회

  • 계정 — 계정 검색, 가져오기 및 계정별 연락처 나열

  • 캠페인 — 캠페인 나열, 가져오기, 생성 및 업데이트

  • 캠페인 멤버 — 멤버 나열, 개인 추가, 최대 200명 일괄 추가, 상태 업데이트

  • 작업 — 작업 생성; 리드, 연락처 또는 캠페인별 나열

  • 분석 보고서 — Salesforce 분석 보고서 나열, 실행 및 설명

  • 캠페인 분석 — ROI 계산, 멤버 상태 분석, 상위 캠페인, 성과 추세

  • 기여도 — 리드 소스 분석, 캠페인별 파이프라인, CampaignInfluence, 캠페인별 수주 수익, 리드 전환 지표

  • 파이프라인 — 파이프라인 요약, 리드 소스별 파이프라인, MQL 추세, 예측 요약

  • 활동 — 차원별 활동 요약, 리드 또는 연락처별 최근 활동

  • 파워 도구 — 원시 SOQL, SObject 설명, 모든 개체 나열

사전 요구 사항

  • Salesforce 조직 (API 액세스가 가능한 모든 에디션)

  • Salesforce 사용자 이름, 비밀번호, 보안 토큰

    • 보안 토큰을 가져오거나 재설정하려면: 설정 > 개인 정보 > 내 보안 토큰 재설정

  • Node.js 20 이상

연결된 앱이나 OAuth 설정이 필요하지 않습니다.

설정

1. 설치

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

2. 환경 변수

변수

필수

기본값

설명

SF_USERNAME

예

—

Salesforce 로그인 이메일

SF_PASSWORD

예

—

Salesforce 비밀번호

SF_SECURITY_TOKEN

예

—

보안 토큰 (로그인 시 비밀번호 뒤에 추가)

SF_LOGIN_URL

아니요

https://login.salesforce.com

샌드박스의 경우 https://test.salesforce.com 사용

SF_API_VERSION

아니요

60.0

Salesforce API 버전

.env 파일을 생성하거나 셸에서 설정하세요:

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"

사용법

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %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

.cursor/mcp.json 파일에 추가하세요:

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

도구 참조

도구

설명

sf_search_leads

리드 이름, 이메일, 회사에 대한 SOSL 검색

sf_get_lead

ID별 전체 리드 레코드

sf_create_lead

새 리드 생성

sf_update_lead

리드 필드 업데이트

sf_convert_lead

리드를 계정/연락처/기회로 변환

sf_search_contacts

연락처 이름 및 이메일에 대한 SOSL 검색

sf_get_contact

계정 이름이 포함된 전체 연락처 레코드

sf_create_contact

새 연락처 생성

sf_update_contact

연락처 필드 업데이트

sf_contact_by_email

이메일 주소로 연락처 찾기 (최대 10개 일치)

sf_search_accounts

계정 이름에 대한 SOSL 검색

sf_get_account

진행 중인 기회 수와 리드 수가 포함된 계정 레코드

sf_list_account_contacts

계정과 연결된 연락처

sf_list_campaigns

상태/유형/활성 필터가 포함된 캠페인 나열

sf_get_campaign

모든 성과 지표가 포함된 전체 캠페인 레코드

sf_create_campaign

새 캠페인 생성

sf_update_campaign

캠페인 필드 업데이트

sf_get_campaign_members

리드/연락처 세부 정보가 포함된 캠페인 멤버 나열

sf_add_campaign_member

캠페인에 단일 리드 또는 연락처 추가

sf_bulk_add_campaign_members

한 번의 호출로 최대 200개의 리드/연락처 추가

sf_update_campaign_member_status

멤버 상태 및 HasResponded 플래그 업데이트

sf_create_task

리드, 연락처 또는 캠페인에 연결된 작업 생성

sf_list_tasks_by_lead

리드와 연결된 작업

sf_list_tasks_by_contact

연락처와 연결된 작업

sf_list_tasks_by_campaign

캠페인과 연결된 작업

sf_list_reports

사용 가능한 Salesforce 분석 보고서 나열

sf_run_report

보고서 실행 및 구조화된 행 반환

sf_get_report_metadata

보고서에 대한 열 정의 및 그룹화

sf_campaign_roi

캠페인별 ROI, CPL, CPO 및 응답률

sf_campaign_member_status_breakdown

캠페인별 멤버 상태 수

sf_top_campaigns

응답, 기회 또는 수주 수익별 캠페인 순위

sf_campaign_performance_trend

시간 경과에 따른 멤버 추가 (주/월)

sf_lead_source_breakdown

리드 소스별 리드 볼륨, 전환 및 수익

sf_pipeline_by_campaign

캠페인 및 단계별로 그룹화된 진행 중인 파이프라인

sf_campaign_influence

캠페인을 기회와 연결하는 CampaignInfluence 레코드

sf_won_revenue_by_campaign

기본 캠페인별로 그룹화된 수주 수익

sf_lead_conversion_metrics

리드 소스 또는 캠페인별 전환율

sf_pipeline_summary

단계별 파이프라인: 수, 금액, 확률, 가중치

sf_pipeline_by_lead_source

리드 소스별로 그룹화된 파이프라인

sf_mql_trend

시간 경과에 따른 MQL(또는 기타 상태) 볼륨

sf_forecast_summary

날짜 범위 내에 마감되는 기회에 대한 예상 수익

sf_activity_summary

리드 소스, 캠페인 또는 소유자별 작업/이벤트 수

sf_recent_activities_by_lead

특정 리드에 대한 작업 및 이벤트

sf_recent_activities_by_contact

특정 연락처에 대한 작업 및 이벤트

sf_run_soql

원시 SOQL 실행 (사용자 지정 쿼리용)

sf_describe_object

모든 SObject에 대한 전체 필드 메타데이터

sf_list_objects

선택적 필터가 포함된 모든 쿼리 가능한 SObject 나열

예시 프롬프트

연결 후 Claude에게 다음과 같이 질문해 보세요:

"이번 분기 수주 수익 기준 상위 5개 캠페인은 무엇인가요?"

"지난 90일간의 리드 소스 분석을 보여주세요. 전환율을 포함해 주세요."

"리드 00Q에 대한 후속 작업을 생성하세요... 마감일은 다음 주 금요일입니다."

"ROI가 가장 높은 캠페인은 무엇인가요? 리드당 비용을 포함해 주세요."

"올해 월별 MQL 추세를 보여주세요."

"이 목록의 모든 리드를 'Invited' 상태로 Q2 웨비나 캠페인에 추가하세요."

"현재 단계별 파이프라인 요약과 가중치를 알려주세요."

작동 방식

  • 인증: jsforce를 사용하여 Salesforce 사용자 이름 + 비밀번호 + 보안 토큰을 통해 연결합니다. 연결은 25분 동안 캐시되며 INVALID_SESSION_ID 오류 발생 시 자동으로 새로 고쳐집니다.

  • 프로덕션 및 샌드박스: 샌드박스를 대상으로 하려면 SF_LOGIN_URL=https://test.salesforce.com을 설정하세요.

  • 속도 제한: 모든 쿼리는 Salesforce API 제한을 준수합니다. 결과 크기를 제어하려면 limit 매개변수를 사용하세요.

라이선스

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