Outreach

@mindstone/mcp-server-outreach

Outreach 销售互动 MCP 服务——通过 Outreach API 管理潜在客户、序列、账户、任务和邮件。

一键安装

点击按钮后，宿主将提示你填写：OUTREACH_CLIENT_ID、OUTREACH_CLIENT_SECRET、OUTREACH_ACCESS_TOKEN、OUTREACH_CONFIG_DIR、OUTREACH_OAUTH_PORT。

{
  "mcpServers": {
    "Outreach": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-outreach"
      ],
      "env": {
        "OUTREACH_CLIENT_ID": "",
        "OUTREACH_CLIENT_SECRET": "",
        "OUTREACH_ACCESS_TOKEN": "",
        "OUTREACH_CONFIG_DIR": "~/.mcp/outreach",
        "OUTREACH_OAUTH_PORT": "0"
      }
    }
  }
}

状态

• 版本： 0.2.1 · npm
• 身份验证： OAuth（本地 127.0.0.1 回调）(OUTREACH_CLIENT_SECRET)
• 工具： 22（潜在客户、序列、账户、任务、通话、邮箱）
• 接口： cloud-api
• 机器可读： STATUS.json

安装

npx -y @mindstone/mcp-server-outreach

配置

OAuth 模式（推荐）

设置以下环境变量以使用独立 OAuth 身份验证：

OUTREACH_CLIENT_ID=your_client_id
OUTREACH_CLIENT_SECRET=your_client_secret

然后调用 outreach_connect_account 工具以启动 OAuth 流程。

手动令牌模式

如果你有静态访问令牌：

OUTREACH_ACCESS_TOKEN=your_access_token

可选设置

OUTREACH_CONFIG_DIR=~/.mcp/outreach    # Custom config directory (default: ~/.mcp/outreach)
OUTREACH_OAUTH_PORT=0                   # OAuth callback port (default: OS-assigned)
OUTREACH_OAUTH_SCOPES="prospects.all sequences.all sequenceStates.all sequenceSteps.read sequenceTemplates.read templates.read accounts.all users.read tasks.all mailings.read calls.read mailboxes.read"

上述 OUTREACH_OAUTH_SCOPES 值是内置默认值，涵盖此连接器提供的所有工具。如果你在添加这些作用域之前连接了账户（或覆盖了该变量），请重新运行 outreach_connect_account，以便新令牌包含这些作用域。

可用工具（22）

账户管理

• outreach_connect_account — 通过 OAuth 连接 Outreach 账户
• outreach_list_connected_accounts — 列出已连接的账户及身份验证状态
• outreach_disconnect_account — 断开账户连接并移除凭据

潜在客户

• outreach_search_prospects — 按姓名、电子邮件、公司和标签搜索潜在客户
• outreach_get_prospect — 按 ID 获取潜在客户的完整详情
• outreach_create_prospect — 创建新的潜在客户（支持将 custom_fields 映射到 custom1..custom35）
• outreach_update_prospect — 更新现有潜在客户（支持 custom_fields）

序列

• outreach_list_sequences — 根据筛选条件列出序列
• outreach_get_sequence — 根据 ID 获取序列详情
• outreach_list_sequence_steps — 列出序列步骤（类型、间隔、顺序、模板链接）
• outreach_get_sequence_template — 读取序列模板的邮件主题和正文
• outreach_add_prospect_to_sequence — 将潜在客户加入序列
• outreach_remove_prospect_from_sequence — 暂停或结束潜在客户的加入状态

账户（公司）

• outreach_list_accounts — 列出公司账户
• outreach_get_account — 根据 ID 获取公司账户详情

任务

• outreach_list_tasks — 根据状态和潜在客户筛选条件列出任务
• outreach_create_task — 创建任务（备注、截止日期、潜在客户、负责人）
• outreach_complete_task — 将任务标记为已完成

邮件

• outreach_list_mailings — 列出已发送邮件及其投递状态

通话

• outreach_list_calls — 列出通话及其结果、备注和处置链接

邮箱

• outreach_list_mailboxes — 列出已连接的发件人邮箱（用于加入序列时提供 mailbox_id）

用户

• outreach_list_users — 列出 Outreach 团队成员

身份验证模式

连接器支持四种身份验证模式，并在启动时检测一次：

优先级：bridge > standalone_oauth > manual_token > unconfigured

输入与状态语义

• 资源 ID 必须为数字。 所有接受 Outreach 资源 ID 的工具参数（id、prospect_id、sequence_id、account_id、mailbox_id、user_id、owner_id）都只接受数字（/^\d+$/）。非数字值会在发起任何 API 请求前被拒绝，并返回 VALIDATION_ERROR——Outreach ID 始终为数字，因此其他值表示输入错误，而不是有效查询。
• outreach_remove_prospect_from_sequence 会操作当前有效的加入状态。 潜在客户可能被加入序列、完成序列后又重新加入，因此会有多条序列状态记录；该工具会筛选出未完成的（“有效”）记录，而不是操作返回的第一条记录。如果某个潜在客户与序列组合存在多条有效状态，工具会安全失败并返回 AMBIGUOUS_STATE（不会修改任何记录）；如果所有状态都已完成，则返回 NOT_FOUND。

不可信内容处理

Outreach API 返回的所有用户撰写文本（姓名、邮件地址、邮件主题、模板正文、任务备注、标签、自定义字段）都会封装在 <untrusted-content source="..."> 中，以便 MCP 主机和模型将第三方 CRM 内容视为数据，而非指令。供应商生成的结构（ID、时间戳、生命周期状态）则以原始形式返回。供应商错误文本（API 错误详情、非 JSON 错误正文和 OAuth 令牌交换失败信息）会截断至 500 个字符，并在出现在错误消息中之前以相同方式封装（source="outreach:api-error"）。

许可证

FSL-1.1-MIT