Waitlister

Waitlister MCP 服务 — @waitlister/mcp

一个 MCP（Model Context Protocol） 服务，可将 Claude、Cursor 和 Windsurf 等 AI 助手连接到 Waitlister API。通过自然语言创建候补名单并管理订阅者。

这是官方软件包，取代了 waitlister-mcp（1.0.x）。现有的 waitlister-mcp 配置仍可使用，但新设置应使用 @waitlister/mcp——它新增了账户密钥支持、候补名单创建、统计和删除功能，并且适用于所有套餐。

可以用它做什么？

连接后，你可以向 AI 助手提出类似这样的请求：

• “我的 Waitlister 密钥是否有效？我还能再创建一个候补名单吗？”
• “为我的新产品创建一个候补名单，并提供注册表单 URL。”
• “为我的候补名单上线一个落地页，使用深色主题并发布。”
• “将页面标题改为‘加入其他 500 多人’。”
• “生成一个落地页：大胆、开发工具风格”（AI 构建器，1 个积分）
• “将 [email protected] 添加到我的候补名单。”
• “我有多少订阅者？”
• “查找订阅者 [email protected]。”
• “将 John 的积分更新为 500。”
• “显示推荐人数最多的前 10 位订阅者。”
• “将所有推荐人数不少于 3 人的订阅者标记为 beta，然后列出所有带有 beta 标签的人。”

工具

**AI 页面与标准页面：**使用 generate_landing_page 后，页面文案将保存在生成的页面中——update_landing_page 会拒绝文案／结构字段，并提示改用 generate_landing_page + is_edit（theme 和 seo 仍可正常更新）。生成的页面会保存为草稿，AI 对话也会同步到控制台的 AI 聊天中。

先决条件

• Node.js 18+
• 一个 Waitlister 账户——免费套餐即可使用
• 一个账户 API 密钥（推荐），或一个按候补名单生成的 API 密钥（Growth 套餐及以上）

获取密钥

账户密钥（推荐——适用于所有套餐，可访问你拥有的所有候补名单）：

1. 登录 Waitlister
2. 前往 设置 → API 密钥 → 创建密钥（wl_acct_…）

单个候补名单密钥（旧版，Growth 套餐及以上）：候补名单 → 集成 → API 访问权限。你还需要候补名单设置中的候补名单密钥。

安装

使用 npx（推荐）

无需安装——只需配置 MCP 客户端：

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_ACCOUNT_KEY": "wl_acct_your-key"
      }
    }
  }
}

使用账户密钥时，你可以选择添加 "WAITLISTER_WAITLIST_KEY": "your-waitlist-key" 来设置默认候补名单；否则，每次工具调用都可以通过 waitlist_key 参数指定你拥有的任意候补名单（请助手先运行 list_waitlists）。

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_API_KEY": "your-api-key",
        "WAITLISTER_WAITLIST_KEY": "your-waitlist-key"
      }
    }
  }
}

全局安装

npm install -g @waitlister/mcp

然后使用 "command": "waitlister-mcp" 和相同的 env 进行配置。

按客户端设置

Claude Desktop

使用上述 JSON 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。

Cursor

前往 设置 → MCP → 添加新的 MCP 服务，并使用相同的配置。

Claude Code

claude mcp add waitlister --env WAITLISTER_ACCOUNT_KEY=wl_acct_your-key -- npx -y @waitlister/mcp

环境变量

注意事项

• **唯一性：**候补名单名称和 URL 别名在整个 Waitlister 中必须唯一。若名称/别名已被占用，create_waitlist 会拒绝创建，并提示你需要修改的内容。
• **异步计数器：**注册和删除操作会在几秒内更新 get_stats 计数器和队列位置，而非即时更新。
• **套餐限制：**所有套餐均可创建候补名单、添加订阅者和查看统计数据（免费套餐的速率限制较低）。读取、更新或删除订阅者数据需要 Growth 或更高套餐——请参阅速率限制。
• 基于官方 waitlister SDK 构建（类型化错误、带退避机制的自动重试）。

开发

git clone https://github.com/ilpr/waitlister-mcp.git
cd waitlister-mcp
npm install
npm run build

使用 MCP Inspector 进行测试：

WAITLISTER_ACCOUNT_KEY=wl_acct_your-key npm run inspect

链接

• Waitlister — 为你的产品发布创建候补名单
• API 文档
• MCP 协议

隐私

完整政策：https://waitlister.me/privacy-policy

此扩展会收集什么。 本身不会收集任何信息。它在你的机器上本地运行，不使用数据库、不进行遥测，也不做分析。它只会存储你输入的凭据——你的 Waitlister 账户 API 密钥；Claude Desktop 会将其保存在操作系统的安全凭据存储中。

它会发送什么，以及发送到哪里。 此扩展会通过 HTTPS，向 Waitlister API（https://waitlister.me/api/v1）发送你要求它发出的 API 请求，并使用你的密钥进行身份验证。这意味着你（或按你指示的 Claude）传递给工具的参数：例如候补名单名称、落地页文案，或添加订阅者时使用的电子邮件地址。不会向其他任何地方发送信息。请求路径中没有第三方分析、错误跟踪或中间服务。

请求如何标识自身。 与任何 SDK 一样，这些请求会携带标识标头，以便 Waitlister 区分 Agent 流量和普通 API 流量并提供适当支持：此软件包的名称和版本（waitlister-mcp/1.4.0）、SDK 版本、Node 版本，以及 MCP 主机在协议握手中声明的名称和版本（例如 claude-ai/0.1.0）。不会发送提示词文本、文件路径、机器或用户标识符。不会发送任何额外信息——这些信息会随你已发起的请求一同传送。

这些数据的使用方式和保留期限。 到达 Waitlister API 的数据将按照上文链接的 Waitlister 隐私政策处理——与使用网页控制面板时适用的条款相同。候补名单和订阅者记录会保留在你的 Waitlister 账户中，直到你从控制面板或使用 delete_subscriber 工具将其删除。请求完成后，此扩展本身不会保留任何信息。

与第三方共享。 Waitlister 不会出售你的数据。通过 generate_landing_page 请求生成的落地页设计由 Waitlister 的 AI 页面构建器生成，该构建器会将你的设计提示词传递给第三方模型提供商；当前的子处理方名单请参阅隐私政策。

你的控制权。 你可以随时在 Waitlister 的 Settings → API keys 中撤销 API 密钥，这会立即阻止此扩展访问你的账户。卸载此扩展会从你的机器上移除已存储的密钥。账户和数据删除请求请按照隐私政策中的流程处理。

联系方式。 https://waitlister.me/contact

许可证

MIT — 详见 LICENSE。