chatflow

ChatFlow MCP

将 AI Agent 连接到你的 WhatsApp CRM。

ChatFlow 是一款面向小型团队的 WhatsApp／Telegram／Instagram CRM，提供共享收件箱、拖放式销售管道、AI 自动回复和广播营销活动。这是其托管的 MCP（Model Context Protocol） 服务：将 Claude、Claude Code、Cursor 或任何兼容 MCP 的 Agent 指向你的工作区，即可搜索联系人、读取对话、管理销售管道，并在你允许时发送消息。

• 端点： https://valuable-sockeye-14.eu-west-1.convex.site/mcp
• 传输方式： Streamable HTTP（无状态）
• 身份验证： Authorization: Bearer <API key> — 在 ChatFlow → Settings → AI agents (MCP) 中创建

快速开始

1. 在 ChatFlow 中，打开 Settings → AI agents (MCP)（工作区所有者），然后点击 Create API key。复制密钥——它只会显示一次。也可以为其设置过期时间。
2. 将服务添加到你的客户端：

Claude Code

claude mcp add --transport http chatflow \
  https://valuable-sockeye-14.eu-west-1.convex.site/mcp \
  --header "Authorization: Bearer cfk_YOUR_KEY"

Claude.ai / Claude Desktop — Settings → Connectors → Add custom connector → 粘贴端点 URL，并设置 Authorization: Bearer cfk_YOUR_KEY 标头。

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "chatflow": {
      "url": "https://valuable-sockeye-14.eu-west-1.convex.site/mcp",
      "headers": { "Authorization": "Bearer cfk_YOUR_KEY" }
    }
  }
}

完整的设置和故障排查指南：docs/setup.md。

工具

工具	功能
search_contacts	按姓名／电话号码子字符串查找联系人
list_conversations	查看最近的聊天，包含预览、未读数量和 CRM 字段
get_conversation	查看单条聊天：联系人、备注、交易金额和近期消息
list_pipeline	查看看板列及各阶段的潜在客户
move_conversation	将潜在客户移至销售管道中的某一列
update_lead	设置对话的备注／交易金额
create_contact	根据电话号码创建 WhatsApp 联系人和对话
send_message	向客户发送文本（需主动启用——见下文）
get_usage	查看订阅层级、限制和当前月度用量

读取工具标记为只读；send_message 标记为会影响外部世界的写入操作，因此行为规范的客户端会在调用前进行确认。

发送消息需主动启用

send_message 会向真实客户发送消息，因此默认关闭。工作区所有者可在 Settings 中启用 "Allow agents to send messages" 开关。关闭时，Agent 可以读取所有内容并起草回复，但所有发送操作都会被拒绝，并附上说明该开关的消息。启用后，Agent 发送的消息会计入你的月度配额，在收件箱中显示 AI 徽标，并暂停该聊天的自动回复助手（避免两个 AI 同时回复），同时支持 idempotencyKey，确保重试不会重复发送。

提示词注入说明： Agent 读取的消息文本和备注由你的客户编写。除非你信任负责驱动它的 Agent，否则请保持发送开关关闭。

链接

• 产品：https://chatflow.biz
• 设置指南：docs/setup.md