Warm Inbox

Warm Inbox MCP 服务

为 Warm Inbox 提供的托管式 Model Context Protocol 服务。Warm Inbox 是一项邮件预热和送达率服务。它可让 AI 助手和应用构建者（Cursor、Claude Code、Lovable、Bolt、Replit、v0、Windsurf、Base44 等）检查预热状态和垃圾邮件率，通过安全的托管链接连接邮箱，并暂停、恢复或调整每日发送量。

• 端点： https://mcp.warminbox.org/mcp（Streamable HTTP，无状态）
• 身份验证： Authorization: Bearer wi_live_...，使用你自己的 Warm Inbox API 密钥：https://warminbox.org/public-api/keys.php
• 服务卡片： https://mcp.warminbox.org/.well-known/mcp/server-card.json
• MCP Registry 名称： org.warminbox/mcp
• 隐私： https://warminbox.org/privacy-policy · 条款： https://warminbox.org/terms-of-service · 支持： https://warminbox.org/contact-us

安全性

• AI 永远不会处理邮箱密码。 只能通过 create_connect_link 创建新的预热任务：AI 会显示一次性 URL（有效期 30 分钟），你可在 Warm Inbox 的托管页面上输入 SMTP/IMAP 或 Gmail 凭据。工具架构采用严格校验，会拒绝密码等未知字段。
• 服务不会存储任何内容：不存储密钥、会话、数据库或请求日志。每个请求的 bearer 密钥都会转发给 Warm Inbox REST API，然后立即丢弃。上游输出中的密钥会被删去。
• 不含格式有效密钥的请求会收到 401，并附带 WWW-Authenticate: Bearer。
• 在 Warm Inbox 控制面板中创建的活动可见，但为只读。

工具

工具	REST 操作	输入
get_account	GET /me	无
list_warmups	GET /warmups	无
get_warmup	GET /warmups/{id}	id
get_warmup_health	GET /warmups/{id}/health	id
create_connect_link	POST /connect-links	type（smtp/gmail）、email、first_name、last_name、emails_per_day（整数，0–200）、response_rate（整数，0–100）；均为必填
pause_warmup	POST /warmups/{id}/pause	id
resume_warmup	POST /warmups/{id}/resume	id
set_emails_per_day	PATCH /warmups/{id}	id、emails_per_day（整数，0–200）

成功的 JSON 对象会在 structuredContent 中原样返回，并序列化为文本（密钥删去后）。这会保留列表中的 {data:[...]}、账户/套餐字段、预热来源和 read_only 标志、可为空的健康指标，以及 {url,expires_at} 连接链接。API 返回的 {error:{code,message,...}} 错误会转换为 isError:true，并以易读的状态码/代码/消息文本和结构化错误详情呈现。网络、超时或无效 JSON 错误会转换为通用工具错误。超时时间为 15 秒；不会自动重试，因为连接失败前写入操作可能已成功。控制面板中的活动为只读，写入操作会返回 404 或 403。暂停、恢复和调整发送量均可撤销、非破坏且幂等；创建连接链接则非幂等。

可选提示词 setup_warmup 会指导用户确认账户、收集非机密字段、显示连接 URL、等待用户操作、列出预热任务并检查健康状况。

每个工具都有易读的 title 和完整注释（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。

客户端设置

使用端点 https://mcp.warminbox.org/mcp 和请求头 Authorization: Bearer <your-own-wi_live_key>。请在 Warm Inbox API keys 获取密钥。以下示例仅包含占位符。请在各应用中私下配置凭据，切勿提交已填入实际值的配置，或在安装链接中嵌入真实密钥。

文档审阅日期：2026-10-31。界面标签和套餐可用性可能有所不同；标记为 请在应用中核实 的项目无法通过当前可访问的官方文档确认。

Lovable

添加自定义 MCP 聊天连接器，将其命名为 Warm Inbox，输入端点，并选择 bearer-token/API-key 身份验证。将令牌设为你的 wi_live_... 密钥；如果界面提供原始标头选项，请使用 Authorization: Bearer ...。询问“使用 Warm Inbox 列出我的暖场邮件。”自定义 MCP 属于构建器上下文；它不会自动将运行时后端集成安装到生成的应用中。官方设置和身份验证选项。

Bolt.new

打开 Connectors，添加自定义 Connector，将 URL 设为端点，并将传输方式设为 HTTP。选择 API-key 身份验证并提供你的密钥，使发出的标头为 Authorization: Bearer ...（确切的字段/前缀行为：请在应用内验证）。Bolt 的官方公告确认支持远程自定义连接器以及 API-key/OAuth 凭据。如果此界面无法发送 bearer 标头，则在添加 OAuth 之前，无法通过此界面连接此服务。

Replit Agent

在 Integrations → MCP Servers → Add MCP server 中，将名称设为 Warm Inbox 并输入端点。在 Advanced settings 下添加 Authorization，值为 Bearer <your-own-wi_live_key>，然后点击 Test & save。官方自定义服务指南。

官方 Add to Replit 链接格式：https://replit.com/integrations?mcp=<URL-encoded-base64-JSON>。载荷：

{"displayName":"Warm Inbox","baseUrl":"https://mcp.warminbox.org/mcp","headers":[{"key":"Authorization","value":"Bearer <your-own-wi_live_key>"}]}

若要创建公开安装链接，请省略 headers，并让用户在安装后私下添加密钥。在本地生成不含密钥的链接：

const payload = { displayName: 'Warm Inbox', baseUrl: 'https://mcp.warminbox.org/mcp' };
console.log('https://replit.com/integrations?mcp=' + encodeURIComponent(Buffer.from(JSON.stringify(payload)).toString('base64')));

v0

打开 MCP Connections（或提示词表单中的 MCP 入口），添加 Warm Inbox 并输入端点。如果提供自定义标头控件，请设置 Authorization bearer 标头（请在应用内验证）。官方 MCP 集成页面确认了这两个入口；尚未确认是否支持任意 bearer 标头。仅支持 OAuth 的连接界面目前无法使用此服务。

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中：

{"mcpServers":{"warminbox":{"serverUrl":"https://mcp.warminbox.org/mcp","headers":{"Authorization":"Bearer <your-own-wi_live_key>"}}}}

在 Cascade 中重新加载 MCP 服务。Windsurf 现已更名为 Devin Desktop；在其中，将相同的 url + headers 块添加到 .devin/config.json 或 ~/.config/devin/config.json。

Cursor

在 .cursor/mcp.json 中（真实密钥建议使用私有用户配置）：

{"mcpServers":{"warminbox":{"url":"https://mcp.warminbox.org/mcp","headers":{"Authorization":"Bearer <your-own-wi_live_key>"}}}}

在 MCP 设置中启用该服务。官方配置说明。官方安装深链：

cursor://anysphere.cursor-deeplink/mcp/install?name=warminbox&config=<URL-encoded-base64-JSON-config>

使用官方生成器和单服务配置，或生成不含凭据的链接：

const config = { url: 'https://mcp.warminbox.org/mcp' };
console.log('cursor://anysphere.cursor-deeplink/mcp/install?name=warminbox&config=' + encodeURIComponent(Buffer.from(JSON.stringify(config)).toString('base64')));

安装后，私下添加 Authorization。不要在深链中分发 bearer 密钥。

Claude Code

claude mcp add --transport http warminbox https://mcp.warminbox.org/mcp \
  --header 'Authorization: Bearer <your-own-wi_live_key>'

使用 /mcp 检查连接。官方 HTTP 传输/标头文档。请私下填写密钥；Shell 历史记录和本地客户端设置可能会保留输入的凭据。

Claude.ai / Claude Desktop 自定义连接器

Settings → Connectors → Add custom connector → 端点 URL。官方远程连接器指南。限制：某些连接器界面仅支持 OAuth 或无身份验证，不提供任意 bearer 标头。此服务会拒绝无身份验证请求，且未实现 OAuth，因此这些界面无法直接连接。是否提供 bearer 标头字段请在应用内验证；同时可使用 Claude Code。不要将密钥放入 URL。

开发 / 自托管

Node 20+。

npm ci
npm test               # mocked fetch, never calls production
npm run build
npm run typecheck:worker
npm start              # Node entry on :3100 (PORT, WARMINBOX_API_BASE env)
npx wrangler deploy    # or deploy src/worker.ts to Cloudflare Workers (wrangler.jsonc)

src/core/ 包含共享 API 客户端、工具和服务卡片；src/node.ts（Express）和 src/worker.ts（Workers）是精简的入口点。ecosystem.config.cjs 是一个 PM2 示例，用于在反向代理后运行 Node 服务。

文件列表

server.json（MCP Registry）、.well-known/mcp/server-card.json（实时卡片快照）、glama.json（Glama 所有权）、.mcp.json / mcp.json / .cursor-plugin/plugin.json（Cursor 插件和 cursor.directory）。

许可证

MIT。请参阅 LICENSE。