ManyContacts - WhatsApp Business MCP

Name: ManyContacts - WhatsApp Business MCP
Author: ManyContacts

本地服务

github.com/manycontacts商业与营销028 周前更新

代码仓库

关于 ManyContacts - WhatsApp Business MCP

ManyContacts - WhatsApp Business MCP 是供 AI Agent 使用 ManyContacts WhatsApp Business CRM 的 MCP 服务，提供联系人管理、消息处理、营销活动和 AI 自动回复工具。

主要功能

01管理和筛选联系人
02分配、标记和整理联系人
03读取并发送 WhatsApp 消息
04运行营销活动
05配置 AI 自动回复

适用场景

01更新 CRM 联系人和销售阶段
02通过 Agent 处理 WhatsApp 对话
03配置营销活动与自动回复

MCP 相关

该服务向 MCP 客户端提供 ManyContacts CRM 操作工具，涵盖联系人、WhatsApp 消息、营销活动和 AI Agent 设置。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "manycontacts-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "@manycontacts/mcp"
      ],
      "env": {
        "MC_CLI_TOKEN": "<MC_CLI_TOKEN>"
      }
    }
  }
}

启动命令npx -y @manycontacts/mcp

需要配置的环境变量

MC_CLI_TOKEN密钥ManyContacts CLI authentication token. Get one at https://manycontacts.com or via: npx @manycontacts/cli auth login

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@manycontacts/mcp1.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

ManyContacts MCP 服务

面向 ManyContacts（WhatsApp Business CRM）的 MCP（Model Context Protocol）服务。支持 AI Agent（Claude、Cursor、Windsurf 等）以编程方式管理联系人、发送 WhatsApp 消息、运行营销活动、配置 AI 自动回复，以及执行所有 CRM 操作。

快速开始

1. 获取 CLI 令牌

npm install -g @manycontacts/cli

已有账户？ 登录：

mc auth login --email [email protected] --password mypassword
mc auth whoami   # verify it works

刚开始使用 ManyContacts？ 创建账户并连接 WhatsApp 渠道：

# Register a new account
mc auth register --email [email protected] --name "My Company"

# Connect a WhatsApp Business channel (choose one method):
mc channels connect whatsapp-api      # WhatsApp Cloud API (recommended)
mc channels connect coexistence       # ManyContacts coexistence mode
mc channels connect qr                # QR code pairing

# Verify everything is set up
mc auth whoami
mc channels list

2. 在 MCP 客户端中配置

Claude Desktop / Claude Code

将以下内容添加到 MCP 设置（~/.claude/claude_desktop_config.json 或类似文件）：

{
  "mcpServers": {
    "manycontacts": {
      "command": "npx",
      "args": ["@manycontacts/mcp"],
      "env": {
        "MC_CLI_TOKEN": "your-cli-token-here"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "manycontacts": {
      "command": "npx",
      "args": ["@manycontacts/mcp"],
      "env": {
        "MC_CLI_TOKEN": "your-cli-token-here"
      }
    }
  }
}

提示： 如果你已通过 CLI 登录（mc auth login），令牌会存储在 ~/.manycontacts/config.json 中，MCP 服务将自动读取，无需设置 MC_CLI_TOKEN 环境变量。

可用工具（共 55 个）

账户与上下文

`manycontacts.context`

全面了解你的 ManyContacts 账户：已连接的 WhatsApp Business 渠道、联系人／用户／标签数量、活跃 AI Agent 以及已启用的功能。执行其他操作前，请先使用此工具了解账户状态。

参数	类型	必填	说明
(无)	—	—	无需参数

`manycontacts.org.get`

获取 WhatsApp Business 组织／账户信息，包括名称、时区和所有配置设置。

参数	类型	必填	说明
(无)	—	—	无需参数

`manycontacts.org.update`

更新组织级设置，例如时区、自动回复消息、自动关闭行为和 webhook 配置。

参数	类型	必填	说明
`timezone`	`string`	否	时区标识符（例如 `Europe/Madrid`、`America/New_York`）
`auto_reply_open`	`boolean`	否	启用新聊天开启时的自动回复
`auto_reply_open_text`	`string`	否	聊天开启时发送的自动回复消息
`auto_reply_close`	`boolean`	否	启用聊天关闭时的自动回复
`auto_reply_close_text`	`string`	否	聊天关闭时发送的自动回复消息
`auto_reply_close_minutes`	`number`	否	自动关闭前的无活动分钟数
`auto_reply_away`	`boolean`	否	启用离开／非工作时间自动回复
`auto_reply_away_text`	`string`	否	离开时发送的自动回复消息
`webhooks_forward`	`boolean`	否	启用将 webhook 转发到外部 URL
`webhooks_forward_url`	`string`	否	用于接收 webhook 事件转发的外部 URL

`manycontacts.org.schedule.get`

获取营业时间安排。返回每周各天配置的工作时间，用于确定“离开”自动回复的启用时间。

参数	类型	必填	说明
(无)	—	—	无需参数

`manycontacts.org.apikey`

获取组织的 REST API 密钥，用于直接 API 集成。

参数	类型	必填	说明
(无)	—	—	无需参数

`manycontacts.channels.list`

列出所有已连接的 WhatsApp Business 和 Instagram 渠道。对于 WhatsApp 渠道，会显示电话号码和连接状态；对于 Instagram 渠道，会显示用户名。

参数	类型	必填	说明
(无)	—	—	无需参数

联系人

所有联系人操作均使用电话号码作为标识符（包含国家代码，不带 + 前缀，例如 34600000000）。

`manycontacts.contacts.list`

使用高级筛选条件列出 WhatsApp Business 联系人。返回分页结果，并包含 has_more 指示项。筛选条件可自由组合。

参数	类型	必填	描述
`page`	`number`	否	页码（默认值：`1`）
`limit`	`number`	否	每页结果数，最大为 `200`（默认值：`50`）
`open`	`"true"` \| `"false"`	否	按对话开启／关闭状态筛选
`assigned_to`	`string`	否	按指派的用户 ID 筛选
`tags`	`string`	否	逗号分隔的标签 ID — 联系人必须拥有所有指定标签
`team`	`string`	否	按团队 ID 筛选
`stages`	`string`	否	逗号分隔的漏斗阶段 ID
`date_from`	`string`	否	筛选在此日期之后更新的联系人（`YYYY-MM-DD`）
`date_to`	`string`	否	筛选在此日期之前更新的联系人（`YYYY-MM-DD`）
`unread`	`"true"`	否	仅显示有未读消息的联系人
`blacklist`	`"true"`	否	仅显示已拉黑的联系人
`scheduled`	`"true"`	否	仅显示有待发送定时消息的联系人

注意： 同时使用 date_from 和 date_to 时，日期范围不能超过 90 天。

响应：

{
  "ok": true,
  "data": [
    {
      "name": "John Doe",
      "number": "34600000000",
      "open": true,
      "last_user_id": "uuid-of-assigned-user",
      "source": "whatsapp",
      "notes": "VIP customer",
      "customFields": {},
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "has_more": true }
}

`manycontacts.contacts.get`

获取特定联系人的详细信息，包括其标签、团队、漏斗阶段和自定义字段。

参数	类型	必填	描述
`phone`	`string`	是	带国家代码的电话号码（例如 `34600000000`）

`manycontacts.contacts.create`

在 CRM 中创建新的 WhatsApp Business 联系人。电话号码将自动标准化（移除开头的 +）。

参数	类型	必填	描述
`phone`	`string`	是	带国家代码的电话号码（例如 `34600000000`）
`name`	`string`	否	联系人显示名称
`notes`	`string`	否	联系人的自由文本备注

`manycontacts.contacts.update`

更新现有联系人的姓名、备注或自定义字段。

参数	类型	必填	描述
`phone`	`string`	是	要更新的联系人的电话号码
`name`	`string`	否	联系人的新姓名
`notes`	`string`	否	联系人的新备注
`customFields`	`string`	否	JSON 字符串格式的自定义字段（例如 `'{"company":"Acme"}'`）

`manycontacts.contacts.delete`

从 CRM 中永久删除联系人。

参数	类型	必填	描述
`phone`	`string`	是	要删除的联系人的电话号码

`manycontacts.contacts.assign`

将联系人指派给特定团队成员。被指派的用户会在个人收件箱中看到此联系人。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`userId`	`string`	是	要将联系人指派给的用户 ID（使用 `manycontacts.users.list` 获取 ID）

`manycontacts.contacts.unassign`

移除联系人的当前用户指派。该联系人将返回到未指派的公共收件箱。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码

`manycontacts.contacts.close`

关闭 WhatsApp 对话。已关闭的对话会被归档，不会显示在活动收件箱中。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码

`manycontacts.contacts.open`

重新打开之前关闭的 WhatsApp 对话。该联系人会再次显示在活动收件箱中。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码

`manycontacts.contacts.tag.add`

为联系人添加标签。使用 manycontacts.tags.list 获取可用的标签 ID。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`tagId`	`string`	是	要添加的标签 ID

`manycontacts.contacts.tag.remove`

移除联系人的标签。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`tagId`	`string`	是	要移除的标签 ID

`manycontacts.contacts.team.add`

为联系人添加团队。使用 manycontacts.teams.list 获取可用的团队 ID。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`teamId`	`string`	是	要添加的团队 ID

`manycontacts.contacts.team.remove`

移除联系人的团队。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`teamId`	`string`	是	要移除的团队 ID

`manycontacts.contacts.set_stage`

将联系人移至销售漏斗/管道中的指定阶段。使用 manycontacts.funnels.list 获取漏斗和阶段 ID。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`funnel_id`	`string`	是	漏斗 ID
`stage_id`	`string`	是	漏斗中的目标阶段 ID

`manycontacts.contacts.bulk`

一次对多个联系人执行批量操作。支持关闭、打开、分配、添加标签和分配团队。

参数	类型	必填	描述
`action`	`"close"` \| `"open"` \| `"assign"` \| `"add_tag"` \| `"add_team"`	是	要执行的批量操作
`phones`	`string`	是	以逗号分隔的电话号码（例如 `"34600000000,34600000001"`）
`value`	`string`	否	操作所需的值：`assign` 使用用户 ID，`add_tag` 使用标签 ID，`add_team` 使用团队 ID。`close` 或 `open` 无需此值。

消息

`manycontacts.messages.list`

列出联系人的 WhatsApp 对话消息。以便于阅读对话的格式返回消息，包括时间戳、状态和发送者信息。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`page`	`number`	否	页码（默认值：`1`）
`limit`	`number`	否	每页消息数（默认值：`50`）

`manycontacts.messages.send.text`

向联系人发送 WhatsApp 文本消息。仅在 24 小时对话窗口内有效。若要在此窗口之外发起对话，请使用 manycontacts.messages.send.template。

参数	类型	必填	描述
`phone`	`string`	是	接收消息的电话号码
`body`	`string`	是	消息文本内容

`manycontacts.messages.send.note`

在联系人的对话中创建内部备注。备注仅对团队成员可见，不会发送给 WhatsApp 联系人。

参数	类型	必填	描述
`phone`	`string`	是	联系人的电话号码
`body`	`string`	是	内部备注文本

`manycontacts.messages.send.template`

发送 WhatsApp Business 模板消息。要在 24 小时窗口之外发起对话或批量发送外发消息，必须使用模板。模板必须经过 Meta 预先批准。

参数	类型	必填	描述
`phone`	`string`	是	要向其发送模板的电话号码
`templateId`	`string`	是	模板 ID（使用 `manycontacts.templates.list` 获取 ID）
`variables`	`string`	否	以 JSON 数组字符串表示的模板变量（例如，`'["John","20%"]'`）

模板

WhatsApp Business 模板是预先批准的消息格式，用于在 24 小时对话窗口之外发送外发消息。

`manycontacts.templates.list`

列出所有 WhatsApp Business 消息模板。显示模板名称、代码、状态、组件和媒体标记。

参数	类型	必填	描述
`status`	`"approved"` \| `"pending"` \| `"rejected"`	否	按审批状态筛选模板

`manycontacts.templates.get`

获取特定模板的完整详情，包括其组件（页眉、正文、页脚、按钮）、配置和媒体附件。

参数	类型	必填	描述
`id`	`string`	是	模板 ID

`manycontacts.templates.sync`

通过 Meta Cloud API 同步 WhatsApp Business 模板。从已连接的 WhatsApp Business 账户获取最新模板。在 Meta Business Manager 中创建或修改模板后，此操作很有用。

参数	类型	必填	描述
(无)	—	—	无需参数

活动

活动可在预定时间向电话号码列表批量发送 WhatsApp 模板消息。

`manycontacts.campaigns.list`

列出所有 WhatsApp Business 批量消息活动及其统计数据（已发送、已送达、已读和失败的数量）、模板名称和预定日期。

参数	类型	必填	描述
(无)	—	—	无需参数

`manycontacts.campaigns.create`

创建新的 WhatsApp Business 批量消息活动。活动将在预定时间向指定电话号码发送模板消息。

参数	类型	必填	描述
`name`	`string`	是	活动名称
`templateId`	`string`	是	要使用的 WhatsApp 模板 ID（必须为 `approved`）
`phones`	`string`	是	以逗号分隔的电话号码（例如，`"34600000000,34600000001,34600000002"`）
`date`	`string`	是	ISO 格式的预定发送日期（例如，`"2026-12-01T09:00:00"`）
`variables`	`string`	否	以 JSON 数组字符串表示的模板变量（例如，`'["John","20%"]'`）

`manycontacts.campaigns.delete`

删除 WhatsApp Business 活动。只能删除待处理（尚未发送）的活动。

参数	类型	必填	描述
`id`	`string`	是	要删除的活动 ID

团队

团队将用户分组，以便进行分配路由和联系人整理。

`manycontacts.teams.list`

列出组织中的所有团队。

Parameter	Type	Required	Description
(none)	—	—	无需参数

`manycontacts.teams.create`

创建新团队。

Parameter	Type	Required	Description
`name`	`string`	Yes	团队名称

`manycontacts.teams.add_member`

将用户添加到团队。

Parameter	Type	Required	Description
`teamId`	`string`	Yes	团队 ID
`userId`	`string`	Yes	要添加到团队的用户 ID

`manycontacts.teams.remove_member`

从团队中移除用户。

Parameter	Type	Required	Description
`teamId`	`string`	Yes	团队 ID
`userId`	`string`	Yes	要从团队中移除的用户 ID

`manycontacts.teams.delete`

删除团队。团队成员不会被删除，仅删除团队分组。

Parameter	Type	Required	Description
`id`	`string`	Yes	要删除的团队 ID

销售漏斗 / 管道

漏斗可帮助你跟踪联系人在多阶段销售或支持管道中的进展（例如，“新线索” -> “已确认” -> “已发送提案” -> “已成交”）。

`manycontacts.funnels.list`

列出所有销售漏斗 / 管道及其阶段。

Parameter	Type	Required	Description
(none)	—	—	无需参数

`manycontacts.funnels.create`

创建新的销售漏斗 / 管道。

Parameter	Type	Required	Description
`name`	`string`	Yes	漏斗名称

`manycontacts.funnels.add_stage`

向现有漏斗添加新阶段。

Parameter	Type	Required	Description
`funnelId`	`string`	Yes	漏斗 ID
`name`	`string`	Yes	阶段名称（例如，“已确认”、“已发送提案”）
`order`	`number`	Yes	阶段在管道中的位置（从 0 开始）

`manycontacts.funnels.update_stage`

更新漏斗中阶段的名称。

Parameter	Type	Required	Description
`funnelId`	`string`	Yes	漏斗 ID
`stageId`	`string`	Yes	要更新的阶段 ID
`name`	`string`	No	新阶段名称

`manycontacts.funnels.contacts`

列出当前位于指定漏斗中的联系人，可选择按阶段筛选。返回分页结果。

Parameter	Type	Required	Description
`funnelId`	`string`	Yes	漏斗 ID
`stage_id`	`string`	No	按指定阶段 ID 筛选
`page`	`number`	No	页码
`limit`	`number`	No	每页结果数

`manycontacts.funnels.delete`

删除销售漏斗 / 管道及其所有阶段。漏斗中的联系人不会被删除。

Parameter	Type	Required	Description
`id`	`string`	Yes	要删除的漏斗 ID

用户 / 团队成员

管理有权访问 WhatsApp Business CRM 的团队成员。

`manycontacts.users.list`

列出组织中的所有团队成员 / 用户及其角色和详细信息。

参数	类型	必填	说明
(none)	—	—	无需参数

`manycontacts.users.get`

获取特定团队成员的详细信息。

参数	类型	必填	说明
`id`	`string`	是	用户 ID

`manycontacts.users.update`

更新团队成员的个人资料信息。

参数	类型	必填	说明
`id`	`string`	是	要更新的用户 ID
`name`	`string`	否	新的用户显示名称

`manycontacts.users.invite`

通过电子邮件邀请新团队成员加入组织。对方将收到加入邀请邮件。

参数	类型	必填	说明
`email`	`string`	是	用于发送邀请的电子邮件地址

`manycontacts.users.delete`

将团队成员从组织中移除。分配给该成员的联系人将变为未分配状态。

参数	类型	必填	说明
`id`	`string`	是	要移除的用户 ID

AI Agent

AI Agent 会根据可配置的指令和场景自动回复收到的 WhatsApp 消息。这里只列出已启用的 Agent。

`manycontacts.ai_agents.list`

列出所有已启用的 AI 自动回复 Agent 及其配置。

参数	类型	必填	说明
(none)	—	—	无需参数

`manycontacts.ai_agents.get`

获取特定 AI Agent 的完整详细信息，包括其场景（对话流程）、指令区块和配置。

参数	类型	必填	说明
`id`	`string`	是	AI Agent ID（UUID）

`manycontacts.ai_agents.update`

更新 AI Agent 的配置。可以启用 / 停用 Agent，或修改其指令区块。

参数	类型	必填	说明
`id`	`string`	是	AI Agent ID（UUID）
`active`	`boolean`	否	启用（`true`）或停用（`false`）Agent
`block_1`	`string`	否	Agent 指令 — 区块 1
`block_2`	`string`	否	Agent 指令 — 区块 2
`block_3`	`string`	否	Agent 指令 — 区块 3

`manycontacts.ai_agents.feedback`

获取 AI Agent 的反馈和对话日志，查看 Agent 的回复情况和用户满意度数据。

参数	类型	必填	说明
`id`	`string`	是	AI Agent ID（UUID）

可用提示词（共 6 个）

预先构建的提示词，可引导 AI Agent 执行常见工作流。使用这些提示词可快速完成多步骤任务。

`contact-lookup`

查找 WhatsApp 联系人，并获取其个人资料、标签、销售漏斗阶段和近期消息的完整摘要。

参数	必填	说明
`phone`	是	国际格式的电话号码（例如 `+34612345678`）

`send-campaign`

创建 WhatsApp 群发活动的分步指南：列出可用模板、询问收件人和发送时间，然后创建活动。

参数	必填	说明
(none)	—	交互式引导工作流

`daily-dashboard`

生成 ManyContacts 账户的完整概览，包括渠道、待处理会话、团队结构和销售漏斗。

参数	必填	描述
(none)	—	无需参数

`reply-to-contact`

查看与联系人的近期会话记录，然后在完整上下文的基础上发送 WhatsApp 消息。

参数	必填	描述
`phone`	是	国际格式的电话号码（例如：`+34612345678`）
`message`	是	要发送的消息文本

`manage-funnel`

显示所有销售漏斗及其阶段和每个阶段的联系人数量，直观呈现销售管道概览。

参数	必填	描述
(none)	—	无需参数

`bulk-tag-contacts`

一次为多个联系人添加标签——查找或创建标签，然后批量应用。

参数	必填	描述
`phones`	是	以逗号分隔的电话号码（例如：`+34612345678,+34698765432`）
`tagName`	是	要应用的标签名称

环境变量

变量	必填	描述
`MC_CLI_TOKEN`	是*	ManyContacts CLI 身份验证令牌。通过 `mc auth login` 获取。
`MC_API_URL`	否	API 基础 URL（默认值：`https://api.manycontacts.com`）

*如果你已通过 CLI 登录，令牌会保存在本地的 ~/.manycontacts/config.json 中，MCP 服务会自动读取。

身份验证

MCP 服务使用 CLI 令牌进行身份验证。每个令牌都限定于一个组织，并且权限可配置。

# Login to get a token
mc auth login --email [email protected] --password mypassword

# The token is stored at ~/.manycontacts/config.json
# Or set it explicitly via environment variable:
export MC_CLI_TOKEN=your-token-here

速率限制

**付费账户：**每分钟 60 个请求
**免费／试用账户：**每分钟 10 个请求

达到速率限制时，服务会返回 429 错误，并附上升级链接。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

参数	类型	必填	描述
`name`	`string`	是	标签名称
`color`	`string`	否	以十六进制代码表示的标签颜色（例如，`"#ff0000"`）。默认为 `#fab1a0`

ManyContacts - WhatsApp Business MCP

关于 ManyContacts - WhatsApp Business MCP

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

ManyContacts MCP 服务

快速开始

1. 获取 CLI 令牌

2. 在 MCP 客户端中配置

Claude Desktop / Claude Code

Cursor

可用工具（共 55 个）

账户与上下文

manycontacts.context

manycontacts.org.get

manycontacts.org.update

manycontacts.org.schedule.get

manycontacts.org.apikey

manycontacts.channels.list

联系人

manycontacts.contacts.list

manycontacts.contacts.get

manycontacts.contacts.create

manycontacts.contacts.update

manycontacts.contacts.delete

manycontacts.contacts.assign

manycontacts.contacts.unassign

manycontacts.contacts.close

manycontacts.contacts.open

manycontacts.contacts.tag.add

manycontacts.contacts.tag.remove

manycontacts.contacts.team.add

manycontacts.contacts.team.remove

manycontacts.contacts.set_stage

manycontacts.contacts.bulk

消息

manycontacts.messages.list

manycontacts.messages.send.text

manycontacts.messages.send.note

manycontacts.messages.send.template

模板

manycontacts.templates.list

manycontacts.templates.get

manycontacts.templates.sync

活动

manycontacts.campaigns.list

manycontacts.campaigns.create

manycontacts.campaigns.delete

标签

manycontacts.tags.list

manycontacts.tags.create

manycontacts.tags.update

manycontacts.tags.delete

团队

manycontacts.teams.list

manycontacts.teams.create

manycontacts.teams.add_member

manycontacts.teams.remove_member

manycontacts.teams.delete