如何通过 MCP 和 ReceiveHQ 为 Claude 或 Cursor 提供电子邮件收件箱
- 作者

- 姓名
- Nino
- 职业
- Senior Tech Editor
随着大语言模型(LLM)的快速演进,AI 已经从简单的聊天机器人转变为能够与现实世界交互的复杂智能体(Agents)。然而,对于像 Claude 和 Cursor 这样的 AI 编程助手来说,一直存在一个功能缺口:缺乏一种原生且标准化的方式来接收和处理实时外部通信,特别是电子邮件。虽然发送邮件可以通过标准 API 轻松实现,但接收邮件涉及 MX 记录、DNS 管理和实时监听等复杂的底层架构。本文将详细介绍如何利用模型上下文协议(Model Context Protocol, MCP)和 ReceiveHQ 服务来填补这一空白。
什么是模型上下文协议 (MCP)?
模型上下文协议(MCP)是由 Anthropic 等公司推动的一种开放标准,旨在让开发者以安全、结构化的方式为 LLM 提供工具和数据源。通过使用 MCP,你不仅是让智能体访问一个文件,而是为其提供了一个通用的外部服务接口。当配合像 n1n.ai 这样的一站式 LLM API 聚合平台时,你可以轻松调用 Claude 3.5 Sonnet 或 OpenAI o3 等顶级模型,并赋予它们操作这些工具的能力,从而构建出极其强大的自动化工作流。通过 n1n.ai 获取的高稳定性 API 是确保 MCP 任务不中断的关键。
ReceiveHQ 简介
ReceiveHQ 是一款专门为编程智能体设计的服务,旨在为其提供真实的入站邮箱。它允许你使用自己控制的域名,将 MX 记录指向 mx.receivehq.com,并利用 MCP 工具管理该邮箱的完整生命周期。
核心优势:
- 真实的入站邮件: 并非模拟器,而是发送到你域名的真实电子邮件。
- 原生支持 MCP: 专为模型上下文协议设计,无需复杂的中间件。
- 安全性: 采用 OAuth 2.1 与 PKCE 以及动态客户端注册(DCR)技术。
- 灵活配置: 支持“黑洞”(blackhole)模式(仅供智能体读取)或 Webhook 模式(转发到你的应用)。
详细实施指南
1. 在 Cursor 或 Claude 中配置 MCP 服务器
首先,你需要在你的 AI 环境中注册 ReceiveHQ 的 MCP 服务器地址。Cursor 用户可以通过修改 mcp.json 配置文件来实现,而 Claude Desktop 用户则可以在应用设置中进行配置。
在配置文件中添加以下内容:
{
"mcpServers": {
"receivehq": {
"url": "https://receivehq.com/api/mcp"
}
}
}
添加完成后,重启你的编辑器或智能体。客户端将自动识别 OAuth 需求,启动动态客户端注册,并提示你通过魔法链接(Magic Link)登录。这种安全的握手机制确保了智能体只能获得你明确授权的权限。
2. 工具集详解
ReceiveHQ 提供了一套功能完备的工具,智能体可以根据需要调用。这些工具分为两个权限范围:mcp:read(用于列出和读取邮件)和 mcp:admin(用于管理域名和端点)。
| 工具名称 | 作用 | 核心参数 |
|---|---|---|
list_tenants | 查看可访问的租户账号 | 无 |
create_tenant | 创建新的组织单元 | name |
setup_inbound_domain | 域名设置向导 | tenantId, endpointKind |
verify_inbound_domain_mx | 验证 DNS 解析是否生效 | tenantId, domainId |
list_messages | 获取入站邮件列表 | tenantId, limit |
get_message | 获取邮件完整内容 | tenantId, messageId |
3. 设置你的专属域名
现在你可以直接向智能体(如 Claude)下达指令。例如:“列出我的租户,并为我的新项目设置一个入站域名。”
智能体通常会调用 setup_inbound_domain 工具。如果你只希望智能体在当前会话中读取邮件,请选择 blackhole 作为 endpointKind。这种模式会将邮件安全地存储在 ReceiveHQ,而不会进行外部转发。
关键的 DNS 步骤: 你需要手动在你的域名服务商(如阿里云、Cloudflare 或腾讯云)处添加一条 MX 记录:
- 记录类型: MX
- 记录值:
mx.receivehq.com(优先级设为 10)
添加完成后,告诉智能体:“验证我新域名的 MX 记录。”它将调用 verify_inbound_domain_mx 来确认解析已经生效。
结合 n1n.ai 实现高级自动化
将 ReceiveHQ 与 n1n.ai 结合使用,可以构建出高度自主的系统。例如,你可以利用 n1n.ai 提供的强大算力,将复杂的邮件处理任务分配给不同的模型。Claude 3.5 Sonnet 擅长逻辑推理,而其他模型可能在海量数据提取或多语言情感分析方面更具优势。通过 n1n.ai,你可以确保智能体始终运行在最适合当前任务的模型上。
专家提示:Webhook 集成 如果你希望智能体接收到的邮件触发外部操作,请使用 webhook 模式。这允许 ReceiveHQ 将收到的邮件以 POST 请求的形式发送到你指定的 HTTPS URL。你可以通过 payloadFormat 参数指定数据格式,如 postmark (JSON) 或 mailgun_sendgrid (Multipart)。
// 将端点更新为 Webhook 模式的示例
// 工具: update_endpoint
{
"tenantId": "your-tenant-id",
"endpointId": "your-endpoint-id",
"endpointKind": "webhook",
"url": "https://api.yourdomain.com/inbound-mail",
"payloadFormat": "postmark"
}
安全性与合规性
处理电子邮件涉及敏感数据,安全性至关重要。ReceiveHQ 遵循 14天的原始邮件和投递日志保留周期。所有身份验证均通过带有 PKCE 的 OAuth 2.1 严格管理,这意味着你的原始凭据永远不会直接暴露给 AI 智能体。你可以随时在 ReceiveHQ 控制台的“Settings → MCP”部分撤销任何已连接应用的权限。
开发者应用场景
- 自动化 QA 测试: 在开发流程中创建临时邮箱,自动测试用户注册流程并验证“欢迎”邮件的内容是否正确。
- 技术支持自动分拣: 让智能体监控支持邮箱,并根据内容自动对收到的请求进行分类、摘要或优先级排序。
- 智能体信息检索: 允许你的 AI 助手订阅行业简报或技术更新,并自动提取对你项目有价值的信息。
费用说明
ReceiveHQ 提供了非常友好的试用政策:前 10 封邮件免费,最多支持 3个试用租户。对于生产环境,付费计划起步价为每月10 欧元,涵盖 100,000 封入站邮件,对于高频使用的 AI 智能体来说,这是一个极具性价比的解决方案。
通过为你的 AI 工具赋予真实的通信能力,你已经超越了简单的代码生成,进入了真正的业务流程自动化领域。现在就开始行动,利用 MCP 和 ReceiveHQ 提升你的开发效率吧。
Get a free API key at n1n.ai