machfive

MachFive MCP 服务

什么是 MachFive MCP 服务？

MCP（Model Context Protocol）是一种开放标准，让 Claude 等 AI 助手能够连接外部应用。你可以把它看作 AI 与软件之间的通用翻译器。

MachFive MCP 服务是一款连接器，可让你的 AI 助手直接与你的 MachFive 账户通信。你的 AI 可以列出营销活动、生成高度个性化的冷邮件序列、管理潜在客户列表并导出结果——全部通过自然对话完成。

你无需登录 MachFive、上传 CSV 文件并等待结果，只需告诉 AI 你需要什么：

• “使用我的 SaaS Founders 营销活动，为 [email protected] 生成包含 3 封邮件的序列”
• “显示我的 MachFive 营销活动”
• “提交这 50 条潜在客户以进行批量处理”
• “查看我最近一批任务的状态并导出结果”

你的 AI 会理解请求，通过 MCP 连接到 MachFive 并执行操作——全部只需几秒钟。

---

如何设置 MachFive MCP

第 1 步：获取 API 密钥（2 分钟）

1. 在 app.machfive.co 登录你的 MachFive 账户
2. 前往 Settings → API Keys
3. 点击 Create API Key
4. 复制密钥并妥善保存

⚠️ 请妥善保管此密钥——它相当于你 MachFive 账户的密码。

---

第 2 步：连接你的 AI 客户端

选项 A：Claude Desktop（最简单）

1. 打开 Claude Desktop 应用
2. 前往 Settings → Connectors
3. 点击 Add custom connector
4. 输入：
   • 名称： MachFive
   • 远程 MCP 服务 URL： https://mcp.machfive.co/mcp/YOUR_API_KEY
5. 将 YOUR_API_KEY 替换为你创建的 API 密钥
6. 点击 Add——无需重启！

选项 B：Claude Desktop（配置文件）

如果你更喜欢直接编辑配置文件：

1. 前往 Settings → Developer → Edit Config
2. 将以下内容添加到配置文件中（替换 YOUR_API_KEY）：

{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. 保存并重启 Claude Desktop

选项 C：Cursor

1. 打开 Cursor → Settings（⌘ + ,）
2. 搜索 MCP
3. 点击 Edit in settings.json
4. 添加以下内容（替换 YOUR_API_KEY）：

{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

5. 保存并重启 Cursor

选项 D：n8n（AI Agent 和工作流）

如需在 n8n 中使用 AI Agent 自动化工作流：

1. 将 MCP Client 节点添加到工作流
2. 选择 Streamable HTTP 作为传输选项
3. 输入 URL：https://mcp.machfive.co/mcp/YOUR_API_KEY
4. 连接到 AI Agent 节点

选项 E：其他 MCP 客户端

对于任何兼容 MCP 的客户端，请使用包含 API 密钥的 URL：

https://mcp.machfive.co/mcp/YOUR_API_KEY

此 URL 适用于支持 Streamable HTTP 传输的任何客户端。

---

第 3 步：测试！（30 秒）

打开你的 AI 助手并尝试：

“列出我的 MachFive 营销活动”

如果你看到营销活动列表，就说明已成功连接！🎉

---

身份验证

MachFive MCP 支持三种身份验证方式：

方法	格式	最适用场景
URL 路径	https://mcp.machfive.co/mcp/YOUR_API_KEY	不支持请求头的客户端、n8n
Authorization 请求头	Authorization: Bearer YOUR_API_KEY	Claude Desktop、Cursor
Authorization 请求头（无前缀）	Authorization: YOUR_API_KEY	简化集成

Authorization 请求头中的 Bearer 前缀是可选的。

---

可用工具

MachFive MCP 提供 6 个工具，用于生成冷邮件：

📋 营销活动

工具	描述
list_campaigns	列出工作区中的所有营销活动。请先调用此工具——生成内容需要营销活动 ID。

✉️ 邮件生成

工具	描述
generate_sequence	为一位潜在客户生成个性化邮件序列（同步，3-10 分钟）。
generate_batch	提交多位潜在客户进行批量生成（异步，立即返回列表 ID）。

📦 列表管理

工具	描述
list_lists	浏览潜在客户列表和批处理任务。
get_list_status	轮询批处理任务的状态，直至完成或失败。
export_list	批处理完成后，将结果下载为 JSON 或 CSV。

---

你可以做什么？

✉️ 邮件生成

• “使用我的 Gator 100 营销活动，为 [email protected] 生成一组冷邮件序列”
• “为 Acme Corp 的销售副总裁 John Smith 撰写 5 封个性化邮件”
• “为这位潜在客户生成邮件，重点突出我们的 ROI 案例研究角度”

📦 批量处理

• “提交这 20 位潜在客户，进行批量邮件生成”
• “查看我最新批次的状态”
• “将已完成的批次导出为 CSV”

📋 营销活动管理

• “列出我的 MachFive 营销活动”
• “我有哪些营销活动？”
• “显示我的营销活动 ID”

📊 结果与导出

• “将上一个批次的结果导出为 JSON”
• “下载我的 SaaS Founders 列表对应的 CSV”
• “显示列表 xyz 中生成的邮件”

---

对话示例

快速生成单个潜在客户的邮件

你：“使用我的 Marketing Agencies 营销活动，为 [email protected] 生成 3 封邮件的序列。她叫 Jane Doe，是增长副总裁。”

AI：“我现在就生成这组邮件。MachFive 会先研究这位潜在客户并撰写个性化邮件，因此通常需要 3-5 分钟……”

[3 分钟后]

AI：“这是为 Acme 的 Jane Doe 生成的 3 封邮件序列：

邮件 1 — 主题：有个小问题想请教，Jane 嗨，Jane，我注意到 Acme 最近拓展了业务……”

批量处理工作流

你：“我有 25 位潜在客户需要处理。名单如下：[粘贴潜在客户]。使用我的 SaaS Founders 营销活动。”

AI：“已提交批次！我拿到了列表 ID abc-123。让我查看一下状态……”

[自动轮询]

AI：“你的批次已完成——25 位潜在客户均已处理，共生成 75 封邮件。要我导出为 CSV 还是 JSON？”

晨间工作流检查

你：“我有哪些营销活动？还有正在处理的批次吗？”

AI：“你有 3 个营销活动：First Campaign、Gator 100 和 Marketing Agencies。所有当前批次均已完成——没有待处理任务。”

---

故障排除

问题	解决方案
连接失败	再次确认 API 密钥是否正确
“Invalid API key”错误	在 MachFive 设置中重新生成 API 密钥
无响应	重启 AI 客户端
generate_sequence 超时	这是正常现象——生成需要 3-10 分钟。请勿重试。
服务不可用	检查网络连接，然后重试

---

常见问题

1. 我需要懂编程吗？

不需要。设置约需 5 分钟，只需将 API 密钥粘贴到 AI 助手的设置中。

2. 哪些 AI 助手可以使用？

任何兼容 MCP 的客户端都可以，包括：

• Claude Desktop（Anthropic）
• Cursor（AI 代码编辑器）
• n8n（AI Agent 工作流）
• 任何支持 Streamable HTTP 传输的应用

3. 我的数据安全吗？

安全。连接通过加密的 HTTPS 使用你的个人 API 密钥。AI 只能访问 API 密钥所允许的内容。每位用户都使用自己的密钥进行身份验证——MachFive 从不在 MCP 服务上存储或共享 API 密钥。

4. 我的 AI 可以用 MachFive 做什么？

你的 AI 可以：

• 列出你的营销活动
• 为单个潜在客户生成个性化冷邮件序列
• 提交潜在客户批次以进行批量生成
• 查看批处理状态
• 将已完成的结果导出为 CSV 或 JSON

5. 费用是多少？

MCP 服务包含在你的 MachFive 订阅中，免费使用。邮件生成照常使用你账户中的额度。

6. 连接 URL 是什么？

https://mcp.machfive.co/mcp

7. 生成邮件需要多长时间？

生成单个潜在客户的邮件序列（generate_sequence）需要 3-10 分钟，因为 MachFive 会研究潜在客户并撰写真正个性化的邮件。批量生成（generate_batch）会立即返回——处理将在后台进行，你可以轮询查询是否完成。

8. 出现问题怎么办？

生成操作不会破坏现有数据——它会创建新的邮件序列，不会影响现有数据。如果批次失败，只需重新提交即可。

---

API 端点

端点	URL
健康检查	https://mcp.machfive.co/
MCP 协议	https://mcp.machfive.co/mcp
使用 API 密钥的 MCP	https://mcp.machfive.co/mcp/YOUR_API_KEY

---

需要帮助？ 请通过 [email protected] 联系我们。

MCP 文档： modelcontextprotocol.io