FreeCustom.Email MCP — AI Email + OTP Automation for Agents

FreeCustom.Email MCP 服务

这是 FreeCustom.Email API 的官方 Model Context Protocol (MCP) 服务。

该服务提供强大的临时邮箱 API和临时邮箱自动化功能，专为 AI Agent（Claude、Cursor、Windsurf、Kilo Code 等）设计。AI Agent 无需再构建复杂的轮询逻辑来等待邮件并提取 OTP，现在只需调用一次工具，即可创建收件箱、等待邮件并提取验证码。

专为 AI Agent 打造的强大临时邮箱

传统的临时邮箱 API 提供商（如 Mailinator、Maildrop、1secmail 或 Guerrilla Mail）面向人工使用或基础 REST 轮询。它们缺少高级 AI 工作流所需的上下文和连接能力。

FreeCustom.Email 更适合 AI 的原因：

功能	传统临时邮箱 API	FreeCustom.Email MCP
Agent 接口	手动发送 HTTP REST 请求	原生 MCP（Model Context Protocol）工具
等待邮件	持续轮询（触及速率限制）	长轮询与发布/订阅（无需额外请求）
操作效率	获取 OTP 需要 3-5 次操作	一次调用工具（create_and_wait_for_otp）
数据解析	AI 必须解析杂乱的 HTML/文本	服务会自动提取 4-6 位 OTP

无论您是在进行临时邮箱测试、自动化 QA，还是自主 AI Agent 注册，该 MCP 服务都会在后台处理复杂流程。

前提条件

要使用此 MCP 服务，您必须拥有 FreeCustom.Email 的 Growth 或 Enterprise 计划，因为这是一项高级 AI 自动化功能。

您需要 API 密钥，可在 FreeCustom.Email 控制面板中找到。

想在基于 Web 的 AI 工具中使用 MCP？ 我们托管了一个公共 MCP 端点 https://mcp.freecustom.email/mcp，可与 Claude Web、OpenAI Playground、Replit Agent 及其他云端 AI 平台配合使用，无需本地安装。只需通过 Authorization: Bearer 标头传入 API 密钥，或使用 OAuth。

安装与配置

用于 Claude Desktop（本地 Stdio）

1. 根据您的操作系统打开 Claude Desktop 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 将以下内容添加到配置中：

{
  "mcpServers": {
    "fce-mcp": {
      "command": "npx",
      "args": ["-y", "fce-mcp-server"],
      "env": {
        "FCE_API_KEY": "your_api_key_here"
      }
    }
  }
}

用于 Claude Web Chat（claude.ai）

Claude Web 界面需要远程 MCP 服务 URL。我们提供了一个托管的 MCP 端点 https://mcp.freecustom.email/mcp，通过 OAuth 可直接与 Claude Web 配合使用。

1. 打开 Claude Web（或手机上的 Claude 应用）。
2. 前往 Settings > Integrations > Add Custom Connector。
3. 填写以下信息：
   • 名称： FreeCustom.Email MCP
   • 远程 MCP 服务 URL： https://mcp.freecustom.email/mcp
4. 在 Advanced settings 中，将 API 密钥填写为 OAuth Client ID（或直接粘贴 FreeCustom.Email API 密钥）。
5. 点击 Connect。

用于 Cursor

1. 打开 Cursor 设置。
2. 前往 Features > MCP Servers。
3. 点击 Add New MCP Server。
4. 将 Type 设为 command。
5. 将其命名为 fce-mcp。
6. 命令：npx -y fce-mcp-server
7. 在系统环境变量中，确保已设置 FCE_API_KEY。

用于 Windsurf / Windsurf Editor

{
  "mcpServers": {
    "fce-mcp": {
      "command": "npx",
      "args": ["-y", "fce-mcp-server"],
      "env": {
        "FCE_API_KEY": "your_api_key_here"
      }
    }
  }
}

用于 Kilo CLI 和 Kilo Code

{
  "mcp": {
    "fce-mcp": {
      "type": "local",
      "command": ["npx", "-y", "fce-mcp-server"],
      "environment": {
        "FCE_API_KEY": "your_api_key_here"
      },
      "enabled": true
    }
  }
}

面向 Web AI 平台

许多 AI 平台需要 HTTP 端点。请使用我们托管的 MCP 端点：

平台	配置方法
Claude.ai（Web）	设置 → 集成 → 添加自定义连接器 → URL：https://mcp.freecustom.email/mcp
OpenAI Playground	使用自定义的 "OpenAI Agents"，并填入我们的 MCP URL
Replit Agent	添加 MCP 服务，URL：https://mcp.freecustom.email/mcp + Bearer 令牌身份验证
Agentops / LangChain	配置 MCP 客户端并填入我们的 URL，传入 Authorization: Bearer <YOUR_API_KEY>

可用工具

连接后，你的 AI Agent 将可以使用以下工具：

邮件操作

create_and_wait_for_otp（🔥 黄金功能）

生成一个随机收件箱，并保持连接打开，直到收到 OTP。

• domain（可选）：要使用的域名（默认为 ditube.info）
• timeout（可选）：最长等待时间，单位为秒（10-60，默认为 45）

get_latest_email

获取指定收件箱的最新邮件。

• inbox（必填）：完整的电子邮件地址（例如 [email protected]）

extract_otp

直接获取最新的 4-6 位代码或验证链接。

• inbox（必填）：收件箱的完整电子邮件地址

watch_email

通过长轮询等待现有收件箱收到新邮件。

• inbox（必填）：要监视的收件箱的完整电子邮件地址
• timeout（可选）：最长等待时间，单位为秒（10-60，默认为 30）
• since（可选）：等待此消息 ID 之后的新消息

get_messages

从收件箱中获取多封邮件。

• inbox（必填）：完整的电子邮件地址
• limit（可选）：邮件数量（1-100，默认值为 10）
• unread_only（可选）：仅获取未读邮件

delete_email

从收件箱中删除指定邮件。

• inbox（必填）：完整的电子邮件地址
• `message_id（必填）：要删除的消息 ID

收件箱管理

list_inboxes

列出 API 密钥账户拥有的所有收件箱。（无参数）

自定义域名管理

list_custom_domains

列出与账户关联的所有自定义域名。（无参数）

add_custom_domain

为账户添加新的自定义域名。

• domain（必填）：自定义域名（例如 mail.yourdomain.com）

verify_custom_domain

启动自定义域名的 DNS 验证。

• domain（必填）：要验证的自定义域名

delete_custom_domain

从账户中删除自定义域名。

• domain（必填）：要删除的自定义域名

套餐要求

MCP 访问需要 Growth 或 Enterprise 套餐：

• Growth：60 次操作/分钟，5 个并发会话
• Enterprise：200 次操作/分钟，10 个并发会话

故障排除

“我没有可用工具” 如果你的 AI Agent 提示没有可用工具，则表示 MCP 服务加载失败。

• **重启应用：**桌面 Agent 只会在启动时读取配置。请完全退出并重新打开应用。
• **检查日志：**对于 macOS 上的 Claude：tail -n 50 ~/Library/Logs/Claude/mcp*.log

“使用 Claude Web（claude.ai）” 如果遇到 OAuth/令牌错误：

• 使用 远程 MCP 服务 URL：https://mcp.freecustom.email/mcp（不要使用 /sse）
• 确保 API 密钥有效，并且你使用的是 Growth/Enterprise 套餐

“npx: command not found” GUI 应用可能无法继承你的 $PATH。请使用绝对路径：

{
  "mcpServers": {
    "fce-mcp": {
      "command": "/usr/local/bin/node", 
      "args": ["/absolute/path/to/fce-mcp-server/build/index.js"],
      "env": { "FCE_API_KEY": "your_api_key_here" }
    }
  }
}

许可证

MIT