SendRaven MCP Server已验证已精选

什么是 SendRaven MCP Server？

SendRaven MCP Server 是 SendRaven 的官方 MCP 服务器，SendRaven 是面向 AI 智能体的邮件基础设施。它让智能体能够发送邮件、以会话线程形式读取回复、运行营销活动和自动化流程，并处理审批，一切都在 API 密钥上设定的限制范围内进行。

SendRaven 按发送的邮件数量计费，从不按联系人数量计费。该 MCP 服务器（@sendraven/mcp，MIT 许可，由 Common Ninja Ltd. 发布）是 SendRaven 公共 REST API 的一层代理。它自身不持有任何数据库或服务商凭据，能访问的范围与调用方的密钥或 OAuth 授权完全一致。你可以把它当作托管的远程服务器使用，也可以用 npx 在本地运行。

如何使用 SendRaven MCP Server？

你需要一个 SendRaven 账号，并且在发出邮件之前需要一个已验证的发信域名。连接方式有两种。

远程服务器（OAuth）。 托管端点会在首次使用时通过浏览器让你登录：

https://mcp.sendraven.ai/mcp

本地进程（API 密钥）。 在 SendRaven 控制台的 Developers 下创建 API 密钥，并通过 SENDRAVEN_API_KEY 传入。本地包还会读取 SENDRAVEN_API_URL（默认 https://api.sendraven.ai）；如果设置了 PORT，它会改为通过 Streamable HTTP 监听，而不是 stdio。

Claude Code

远程，使用 OAuth：

claude mcp add --transport http sendraven https://mcp.sendraven.ai/mcp

本地，使用密钥：

claude mcp add sendraven -e SENDRAVEN_API_KEY=YOUR_SENDRAVEN_API_KEY -- npx -y @sendraven/mcp

Claude Desktop / claude.ai

添加一个自定义连接器，URL 填写 https://mcp.sendraven.ai/mcp，然后在浏览器中登录。在 Claude Desktop 的 JSON 配置中，也可以改用本地进程：

{
  "mcpServers": {
    "sendraven": {
      "command": "npx",
      "args": ["-y", "@sendraven/mcp"],
      "env": { "SENDRAVEN_API_KEY": "YOUR_SENDRAVEN_API_KEY" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "sendraven": {
      "url": "https://mcp.sendraven.ai/mcp"
    }
  }
}

对于无人值守运行的智能体，README 给出了用密钥代替 OAuth 连接远程服务器的写法：

{
  "mcpServers": {
    "sendraven": {
      "url": "https://mcp.sendraven.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_SENDRAVEN_API_KEY" }
    }
  }
}

VS Code

{
  "servers": {
    "sendraven": {
      "type": "http",
      "url": "https://mcp.sendraven.ai/mcp"
    }
  }
}

SendRaven MCP Server 的主要功能

• 按密钥设置护栏：每日发送上限、收件人白名单或审批暂缓。所有工具都遵守这三项限制，营销活动也不例外。
• 双向邮件：回复会进入会话线程，智能体可以读取并回复。
• 营销活动支持预览，并可针对主题、发件人名称或发送时间做 A/B 测试。
• 事件驱动的自动化流程，支持报名（enrolment）和基于主题的邮件偏好设置。
• 幂等发送。使用相同的 idempotency_key 重试时，会重放第一次的结果，而不是重复发送。
• 错误信息包含 API 自身的消息、HTTP 状态码和错误类型，智能体可以区分计费限制和 DNS 问题。

SendRaven MCP Server 工具

README 列出了从服务器注册表生成的 55 个工具：

• 事务邮件： send_email、send_template_email、list_emails、get_email（完整的事件时间线，用来排查"为什么这封邮件没送达？"）、cancel_scheduled_email 和 list_scheduled_emails。
• 域名与送达率： add_sending_domain、verify_sending_domain、list_sending_domains，以及退订/屏蔽名单（list_suppressions、add_suppression、remove_suppression、suppress_many）。
• 会话线程： list_threads、get_thread、reply_to_message 和 mark_thread_handled。
• 营销活动： create_broadcast、preview_broadcast、send_broadcast、pick_broadcast_winner、resume_broadcast 和 get_email_metrics。
• 自动化： create_automation、update_automation、set_automation_status、enroll_in_automation 和 emit_event。
• 联系人与受众： add_contact、import_contacts、find_contact、tag_contact、list_segments 和 count_segment。
• 审批与账户： list_pending_approvals、decide_approval 和 get_usage。

SendRaven MCP Server 的使用场景

• 客服智能体："查看未处理的会话，逐一回复客户，并把它们标记为已处理。"
• 送达排查："发给这个地址的密码重置邮件为什么没到？"智能体会使用 get_email 和 list_suppressions。
• 域名设置："把 example.com 添加为发信域名，并告诉我需要发布哪些 DNS 记录。"
• 营销活动："给新闻订阅受众起草一封群发邮件，预览一下，并对两个主题做 A/B 测试。"
• 受控外联：给智能体一个带审批暂缓的密钥，让每一次发送都等待人工放行。

SendRaven MCP Server 常见问题排查

• send_email 返回 pending_approval： 这不是失败。该密钥需要审批，必须由人来放行。不要重试。
• HTTP 402 错误： 这些是计费限制（plan_limit_reached、payment_method_required、billing_past_due、budget_exceeded），不是速率限制。调用 get_usage 查看情况，不要循环重试。
• 422 no_verified_identity： 发件域名没有已验证的发信域名。请添加并验证它，重试没有用。
• decide_approval 返回 403： 通过 OAuth 登录、起草该邮件的密钥，或带有任何护栏的密钥，都无法决定审批。请使用控制台。
• idempotency_key_reused： 同一个密钥搭配了不同的参数，因此没有发送任何邮件。只在完全相同的邮件上复用该密钥。