最新n1n v2.0.1 正式上线!企业级大模型接口聚合平台 (LLM API Gateway),为您接入 500+ AI Models,价格低至 1 折, 立即尝试

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

作者
  • avatar
    姓名
    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”部分撤销任何已连接应用的权限。

开发者应用场景

  1. 自动化 QA 测试: 在开发流程中创建临时邮箱,自动测试用户注册流程并验证“欢迎”邮件的内容是否正确。
  2. 技术支持自动分拣: 让智能体监控支持邮箱,并根据内容自动对收到的请求进行分类、摘要或优先级排序。
  3. 智能体信息检索: 允许你的 AI 助手订阅行业简报或技术更新,并自动提取对你项目有价值的信息。

费用说明

ReceiveHQ 提供了非常友好的试用政策:前 10 封邮件免费,最多支持 3个试用租户。对于生产环境,付费计划起步价为每月10 欧元,涵盖 100,000 封入站邮件,对于高频使用的 AI 智能体来说,这是一个极具性价比的解决方案。

通过为你的 AI 工具赋予真实的通信能力,你已经超越了简单的代码生成,进入了真正的业务流程自动化领域。现在就开始行动,利用 MCP 和 ReceiveHQ 提升你的开发效率吧。

Get a free API key at n1n.ai