Mailrith Email Marketing

Mailrith MCP 服务

Mailrith 官方 MCP 服务。

该服务使用稳定的 @modelcontextprotocol/sdk 包支持托管和 stdio 传输，同时保留 Mailrith 生成的操作架构。

托管式 Agent 集成请使用远程 MCP 端点 https://api.mailrith.com/mcp，也可以从此仓库运行本地服务，以使用 stdio 或可自托管的 HTTP。Claude Desktop 和其他由用户连接的远程 MCP 客户端通过 Mailrith OAuth 进行身份验证。能够安全存储凭据的代码优先客户端可以通过 Authorization: Bearer <credential> 发送工作区 API 密钥或 OAuth 访问令牌。

官方 MCP 注册表

注册表元数据中的 server.json 将此服务标识为 com.mailrith/mailrith。客户端可以使用规范的 Streamable HTTP 端点 https://api.mailrith.com/mcp，通过 OAuth 进行身份验证；也可以从 npm 安装本地 stdio 包。本地安装需要在 MAILRITH_API_KEY 中配置工作区 API 密钥。

默认情况下，托管服务会为通用 Agent 请求 Full Email Marketing Access。它涵盖所选工作区中的所有公开电子邮件营销操作，但不包括计费、团队、账户安全、凭据读取或内部管理操作。discovery_get_capabilities 连接检查会请求完整的公开权限目录，以便 Mailrith 显示所有 Work Profile，并默认选择 Full Email Marketing Access。用户也可以改为选择 Reporting、其他专用 Work Profile 或自定义权限。OAuth 只会保存用户批准的权限，并且每个工具在运行时都会再次检查这些权限。

MAILRITH_API_KEY="<secret>" pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio

本地 stdio 会从客户端的密钥环境中读取 MAILRITH_API_KEY。为避免凭据出现在进程列表或 shell 历史记录中，服务会拒绝通过命令参数传入凭据。如果缺少该环境变量，本地 stdio 会以明确的设置错误退出，因为它没有基于浏览器的 OAuth 流程。

可自托管的 HTTP 不会读取进程级 API 密钥。每个客户端都必须在 Authorization 标头中发送自己的工作区 API 密钥或 OAuth 访问令牌。内置 HTTP 监听器只接受 127.0.0.1 或 localhost；如果需要让其他机器访问，请在其前方部署 TLS 反向代理。

默认的 submitted 配置文件会公开一个经过审核的固定专用工具目录，例如：

• subscribers_list
• broadcasts_create
• broadcasts_preflight
• broadcasts_schedule
• broadcasts_send
• sequences_update_status
• automations_update_status

每个已提交的工具都有易于理解的顶层标题和 annotations.title、范围明确的描述、精确的输入和输出架构、明确的安全注解以及机器可读的操作权限。请求正文输入除了提供其精确引用的架构外，还会直接公开其 JSON 类型，以便连接器审核工具无需先展开 $ref 值即可进行验证。除连接检查外，其他工具都会公布其精确的 OAuth 权限。连接检查会公布完整的权限目录，以便 OAuth 提供所有 Work Profile；其结果仍会报告该连接获授的精确权限。所有用户看到的目录保持一致，以便客户端能够可靠地审核和选择工具。工作区角色、方案、产品就绪状态和已授予权限都会在工具运行时强制检查。 匿名客户端可以初始化并列出此静态目录，以便 ChatGPT 和其他宿主开始 OAuth 关联。匿名工具调用绝不会到达 Mailrith 产品 API，而是返回 HTTP 401，并附带基于标准的 WWW-Authenticate 质询。需要更多权限的已认证调用会返回 HTTP 403，并附带完整的替代权限集。单工具响应还包含 MCP 的工具级 OAuth 质询元数据，供客户端在关联或重新连接账户时使用。 每个匿名 HTTP 请求只接受一条 JSON-RPC 消息。已认证请求最多可批量发送 25 条消息。这些限制可确保每个已连接工作区的发现和工具响应始终可预测。

自动化读取绝不会返回已保存的 webhook 持有者令牌或自定义标头值，而只会返回每项值是否已配置。如果客户端读取某个自动化并在更新时发送经过脱敏的定义，Mailrith 会保留现有值，除非客户端明确替换或移除这些值。更改 webhook 目标地址时必须提供新的凭据值，以防旧密钥被带到其他服务。

该软件包还保留了两个明确的兼容配置：

• compact 暴露早期的七个发现与路由工具。
• custom 暴露根据调用方选择的 Work Profile、权限和只读筛选条件生成的专用工具。

这些配置仅供本地或专用客户端使用。公开的 ChatGPT、Codex、Claude 和 Cursor 软件包使用固定的 submitted 配置，并通过唯一的 /mcp 端点提供服务。

官方构建与分支

修改后的公开版本必须使用不同的软件包、注册表、插件和服务名称，并明确说明其为非官方版本。请参阅 Mailrith 商标与非官方分支政策。