Salesforce Pardot MCP

Salesforce+Pardot MCP服务器

用户通过以下方式连接 MCP OAuth 2.1 --Claude Desktop自动处理身份验证，无需配置。

运作原理

1. In Claude Desktop: Settings → Connectors → Add custom connector
2. Enter server URL: https://your-server.up.railway.app/sse
3. Claude Desktop opens a Salesforce login popup
4. User logs in → Done. All tools appear automatically.

Claude Desktop通过PKCE安全的OAuth自动处理令牌管理（获取、存储、刷新）。服务器上的一个互联应用程序处理所有Salesforce组织中的所有用户。

可用工具（17个只读+5个写入）

服务器运行在 默认情况下为只读模式写入工具（更新/创建）仅在以下情况下注册 ENABLE_WRITE_TOOLS=true 已设置。

Salesforce工具(sf_*)

Pardot工具(pardot_*)

访客活动类型

pardot_get_visitor_activities 支持按友好名称过滤(activity_type_name)或数字代码(activity_type):

每个返回的活动都丰富了 activityLabel 和 category 领域。

安全

先决条件

• Python 3.10+ （使用 str | None 联合语法）
• Salesforce互联应用 启用OAuth

创建互联应用

1. 在Salesforce中： 设置→ 应用程序管理器→ 新连接的应用程序
2. 启用OAuth设置
3. 将回调URL设置为 https://your-server.up.railway.app/oauth/callback
4. 添加OAuth作用域： api, refresh_token, pardot_api
5. 保存并记录 消费者密钥 和 消费者秘密

设置

本地开发

git clone https://github.com/DaniilMai/salesforce-pardot-mcp.git
cd salesforce-pardot-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# Edit .env with your Connected App credentials

python server.py
# → Listening on http://0.0.0.0:8000 (SSE)
# → Health check: http://localhost:8000/health

铁路部署

1. 将仓库推送到GitHub（或直接将Railway连接到仓库）
2. 从仓库创建新的铁路服务
3. 将环境变量（见下表）设置为铁路服务变量
4. 将健康检查路径设置为 /health
5. 部署

包括 railway.toml 和 Dockerfile 处理剩下的。

# Or build and run manually:
docker build -t sf-mcp .
docker run -p 8000:8000 --env-file .env sf-mcp

连接克劳德桌面

1. 打开克劳德桌面： 设置→ 连接器→ 添加自定义连接器
2. 输入URL: https://your-server.up.railway.app/sse
3. 将OAuth客户端ID/密钥留空（动态客户端注册会处理它）
4. 点击添加→ Salesforce登录弹出窗口→ Done

环境变量

生成加密密钥：

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

看 .env.example 查看带有注释的完整模板。

运行测试

# Unit tests (no Salesforce connection needed)
python -m pytest tests/test_security.py -v

# MCP OAuth tests (PKCE, token exchange, security hardening)
python -m pytest tests/test_mcp_oauth.py -v

# Integration tests (starts server subprocess)
python -m pytest tests/test_integration.py -v

# All tests via Docker
docker build -f Dockerfile.test -t sf-pardot-mcp-tests .
docker run --rm sf-pardot-mcp-tests

项目结构

server.py              # Entry point — FastMCP + SSE + health + OAuth routes + security headers
auth.py                # Bearer token middleware (session tokens from MCP OAuth)
user_context.py        # ContextVar for per-request user identity
token_store.py         # Fernet-encrypted per-user OAuth token storage (HMAC-keyed)
oauth.py               # Shared OAuth utilities (SF config, instance URL validation, BUID detection)
mcp_oauth.py           # MCP OAuth 2.1 Authorization Server (RFC 9728, RFC 8414, RFC 7591)
tools/
  __init__.py          # Re-exports ALL_TOOLS list (17 read + 5 write, write opt-in)
  salesforce.py        # 10 Salesforce tools (SOQL, CRUD, pipeline, activities)
  pardot.py            # 12 Pardot tools (prospects, campaigns, activities, emails, config)
tests/
  test_security.py     # Unit tests — SOQL injection, field protection, auth, rate limiting, activity types
  test_mcp_oauth.py    # MCP OAuth tests — PKCE, token exchange, DCR, redirect validation
  test_integration.py  # Integration tests — server startup, health, SSE
Dockerfile             # Production container
Dockerfile.test        # Test runner container
railway.toml           # Railway deployment config
requirements.txt       # Python dependencies
.env.example           # Environment variable template

许可证

麻省理工学院——见 许可证 了解详情。