内容
# 销售线索 MCP 服务器
一款提供完整访问 Salesloft REST API v2 权限的模型上下文协议（MCP）服务器。使 Claude 和其他 MCP 客户端能够管理人员、账户、节奏、活动、机会等。
> **首页：** `spread-ai/salesloft-mcp-server` （于 2026-05-22 从 `Spread-Out/salesloft-mcp-server` 迁移至此处，最初为 `alyce-spreadai/salesloft-mcp-server`）。如果您从旧 URL 克隆，请重新设置远程仓库：`git remote set-url origin https://github.com/spread-ai/salesloft-mcp-server.git`。
## 设置
### 1. 克隆并安装依赖项
```bash
git clone https://github.com/spread-ai/salesloft-mcp-server.git
cd salesloft-mcp-server
npm install
```
### 2. 构建
```bash
npm run build
```
### 3. 获取您的 Salesloft API 密钥
在 https://accounts.salesloft.com/oauth/applications 生成 API 密钥
### 4. 在 Claude Code 或 Claude Desktop 中配置
将以下块添加到任一客户端 - 两个客户端都会自动拾取并运行服务器。无需额外设置。
> ⚠️ **您必须将 `<ABSOLUTE_PATH_TO_REPO>` 替换为机器上的实际路径。** 相对路径和 `~` 不起作用 - Claude 需要绝对路径。从克隆的仓库内部运行 `pwd` 以打印它，例如 `/Users/jane/code/salesloft-mcp-server`。
```json
{
"mcpServers": {
"salesloft": {
"command": "node",
"args": ["<ABSOLUTE_PATH_TO_REPO>/dist/index.js"],
"env": {
"SALESLOFT_API_KEY": "your-api-key-here"
}
}
}
}
```
**放置位置：**
- **Claude Code** - 在终端中运行 `claude mcp add-json salesloft '<the JSON object above, just the inner block>'`，或在 `~/.claude.json` 中的 `mcpServers.salesloft` 下粘贴内部块。
- **Claude Desktop** - 将整个块粘贴到：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
保存后，Salesloft 工具（`salesloft_*`）将在客户端下次启动时可用。
## 可用工具（约 60 个工具）
### 人员
- `salesloft_list_people` - 列出/搜索/筛选人员
- `salesloft_get_person` - 按 ID 获取人员
- `salesloft_create_person` - 创建人员
- `salesloft_update_person` - 更新人员
- `salesloft_delete_person` - 删除人员
- `salesloft_upsert_person` - 按电子邮件地址更新或插入人员
### 账户
- `salesloft_list_accounts` - 列出/搜索/筛选账户
- `salesloft_get_account` - 按 ID 获取账户
- `salesloft_create_account` - 创建账户
- `salesloft_update_account` - 更新账户
- `salesloft_delete_account` - 删除账户
- `salesloft_upsert_account` - 按域名更新或插入账户
### 节奏
- `salesloft_list_cadences` - 列出节奏
- `salesloft_get_cadence` - 按 ID 获取节奏
- `salesloft_list_cadence_memberships` - 列出节奏成员
- `salesloft_create_cadence_membership` - 将人员添加到节奏
- `salesloft_delete_cadence_membership` - 从节奏中移除人员
### 活动
- `salesloft_list_activities` - 列出所有活动
- `salesloft_list_calls` / `salesloft_get_call` - 通话
- `salesloft_list_emails` / `salesloft_get_email` - 电子邮件
- `salesloft_list_tasks` / `salesloft_create_task` / `salesloft_update_task` - 任务
- `salesloft_list_notes` / `salesloft_create_note` - 笔记
### 机会
- `salesloft_list_opportunities` / `salesloft_get_opportunity`
- `salesloft_list_opportunity_stages`
### 用户和团队
- `salesloft_get_me` - 当前用户
- `salesloft_list_users` / `salesloft_get_user`
- `salesloft_list_groups` / `salesloft_get_team`
- `salesloft_list_custom_roles`
### 日历和会议
- `salesloft_list_calendar_events` / `salesloft_get_calendar_event`
- `salesloft_list_meetings` / `salesloft_get_meeting`
### 会话
- `salesloft_list_conversations` / `salesloft_get_conversation`
- `salesloft_list_pending_emails` / `salesloft_update_pending_email` / `salesloft_delete_pending_email`
- `salesloft_list_live_feed_items`
### 工作流
- `salesloft_list_bulk_jobs` / `salesloft_get_bulk_job` / `salesloft_list_bulk_job_results`
- `salesloft_list_imports` / `salesloft_get_import`
### 管理
- `salesloft_list_custom_fields` / `salesloft_create_custom_field`
- `salesloft_list_tags`
- `salesloft_list_email_templates` / `salesloft_get_email_template`
- `salesloft_list_call_dispositions` / `salesloft_list_call_sentiments`
- `salesloft_list_webhooks`
- `salesloft_list_person_stages` / `salesloft_list_account_stages` / `salesloft_list_account_tiers`
- `salesloft_list_saved_list_views`
- `salesloft_list_successes`
- `salesloft_list_crm_activities` / `salesloft_list_crm_activity_fields`
- `salesloft_list_actions` / `salesloft_list_caller_ids`
- `salesloft_list_steps` / `salesloft_get_step`
## API 详情
- **基准 URL**：`https://api.salesloft.com/v2`
- **身份验证**：通过 `SALESLOFT_API_KEY` 环境变量的 Bearer 令牌
- **分页**：所有列表工具都支持 `page` 和 `per_page` 参数（每页 1-100）
- **速率限制**：每分钟 600 次团队级；错误显示剩余配额
- **排序**：大多数列表工具都支持 `sort_by` 和 `sort_direction`
