DarkFunnels documentation

DarkFunnels — MCP 服务

一个托管式、多租户的 MCP 服务，让你的助手能够操作 WhatsApp AI 销售 Agent：审查真实对话并找出销售流失之处、编辑带版本管理且支持撤销的销售手册、管理产品目录，以及读取订单、库存和指标——所有操作都限定在你自己的账户范围内。

此仓库是公开入口：服务本身为闭源。

请先阅读文档——无需账户

• 公开文档 MCP 服务（无需身份验证）：https://docs.darkfunnels.ai/mcp — 搜索所有页面，并浏览文档的只读虚拟文件系统。 注册表条目：ai.darkfunnels/docs。
• 技能文件：https://docs.darkfunnels.ai/skill.md — npx skills add https://docs.darkfunnels.ai。
• 纯文本：https://docs.darkfunnels.ai/llms.txt 和 https://docs.darkfunnels.ai/llms-full.txt；在任何文档 URL 后追加 .md。

连接

https://mcp.darkfunnels.ai/mcp?features=all

• 传输方式： Streamable HTTP，无状态。不支持 SSE；对 /mcp 的 GET/DELETE 请求会返回 405。
• 身份验证： OAuth 2.1，支持动态客户端注册。无需向我们申请，也没有等待名单——任何 DarkFunnels 账户都可以连接。
• 发现： https://mcp.darkfunnels.ai/.well-known/oauth-protected-resource/mcp （RFC 9728）。未通过身份验证的调用会返回 401，并附带 WWW-Authenticate: Bearer resource_metadata=… 标头，这会促使符合规范的客户端自行启动授权流程。

请使用与登录控制面板相同的账户进行授权。使用其他账户授权也能成功连接，但会连接到另一个很可能为空的工作区——如果你的助手说你没有产品，请先检查这一点。whoami 工具会告知当前连接的账户。

用途

DarkFunnels 在企业的 WhatsApp 上部署 AI 销售 Agent。企业通过在控制面板扫描二维码，连接现有号码；其机制与 WhatsApp Web 的关联设备相同：无需申请 Meta Cloud API 应用，也无需提交消息模板，且不收取按对话计费的费用。DarkFunnels 不是 Meta 产品，也不隶属于 Meta。

此服务让所有者自己的助手——Claude、ChatGPT、Codex 或任何 MCP 客户端——能够操作该工作区。

连接范围设置

四个查询参数决定助手可以执行哪些操作：

• ?features= — 显式列出的功能会替换默认功能集，而不是在其基础上扩展。推荐值为 ?features=all：它会启用整个目录，包括你连接后发布的功能组。_write 功能组始终会同时包含对应的读取功能组。
• ?read_only=true — 禁用所有写入操作，且优先级高于其他所有设置，包括 all。
• ?pii=full — 取消屏蔽默认脱敏的终端客户电话号码。
• ?agent=<uuid> — 将连接固定到一个销售漏斗。

如果未设置 ?features=，默认功能集为只读，仅包含一项非破坏性写入操作：为客户分配标签。

工具

共 14 个功能组、44 个工具。每个工具都声明了 title，以及适用的 readOnlyHint 或 destructiveHint，以便客户端向所有者展示即将执行的操作。

完整参考文档由源代码生成： https://docs.darkfunnels.ai/en/reference/tools

工具标题和描述以西班牙语编写。这是有意为之：这些文字就是连接器发送给模型的内容；它们是在真实运营故障中不断完善的，适用于用户为西班牙语企业所有者的产品。翻译这些文字，就会变成对一个并不存在的工具的描述。

它永远不会做什么

此连接器不会转移资金，也无法执行付款。订单和销售数据为只读：工具集中的任何操作都不会发起、扣款或退款。

有一个工具可以创建销售漏斗，这会占用一个订阅席位。它绝不会发起付款：达到席位上限时，调用会安全失败，所有者需在 DarkFunnels 控制面板中完成购买。

试试这些

1. “查看昨天的 WhatsApp 对话，告诉我我们在哪些环节正在流失销售。”
2. “阅读我的销售 Agent 手册，并提出对结尾章节的改进建议；待我批准后再保存。”
3. “列出超过 3 天没有收到回复的客户，并为每位客户起草一条 Agent 用来重新联系的话术。”

链接

• Agent 指南：https://darkfunnels.ai/agents
• 文档（英文）：https://docs.darkfunnels.ai/en
• 连接 URL 参数：https://docs.darkfunnels.ai/en/reference/connection-url
• 安全与隐私：https://docs.darkfunnels.ai/en/security
• 隐私政策：https://darkfunnels.ai/privacy
• Skills 和 Claude Code 插件：https://github.com/darkfunnels-ai/optimind-skills

注册表

已发布到官方 MCP 注册表，名称为 ai.darkfunnels/whatsapp-sales-agent。 请参阅 server.json。