接入说明
edm.get_api_info无参数。返回公开接口、文档地址、默认配额和安全边界，不读取其他应用数据。
让 AI，安全接入邮件工作流
通过 MCP 查询接入说明、检查邮件内容、查看本应用的提交状态。默认只读，发信权限单独控制。
服务地址edm.zhmj.com
认证方式独立 Bearer 凭据
数据隔离绑定单一应用
连接与独立凭据
STREAMABLE HTTP
https://edm.zhmj.com/mcp联系平台申请绑定到已有事务邮件应用的独立 MCP 凭据，格式为 mcp_ 开头。新凭据默认只读，平台可以单独吊销，不需要把原 API 发信密钥交给 AI。
兼容性边界
支持远程 Streamable HTTP 且允许手动设置 Authorization 请求头的 MCP 客户端。本服务当前没有 OAuth 授权登录，不承诺仅支持 OAuth 的客户端可直接连接。下面是通用配置示意，不是所有客户端通用的配置文件格式；按客户端实际设置填写。
客户端配置示意
正在加载代码示例…不需要开放新端口，也不需要把凭据填进本页面。客户端应通过安全设置或环境变量读取密钥，不要放进对话提示词。
默认开放的三个只读工具
邮件内容检查
edm.check_email_content静态检查主题、链接、图片、活动内容及模板变量。不访问链接、不保存或回显正文，不等于垃圾邮件或送达保证。
提交状态查询
edm.get_mail_status传入32位小写十六进制 id，只查询当前凭据绑定应用；不返回收件地址或正文。
| 字段 | 说明 |
|---|---|
| subject | 必填string，最多1000字符 / 4000字节。 |
| body | 必填string，UTF-8，最多204,800字节；最多300个链接、200张图片、10,000个HTML节点。 |
| format | html（默认）或text。 |
| stage | template（默认，允许待替换变量）或final（检查未替换变量）。 |
| 返回值 | 检查项issues、严重程度计数summary及metrics；不包含原始正文或完整链接。 |
固定文档资源
resources/list 和 resources/read 支持 edm://docs/api 与 edm://docs/openapi，均为公开JSON文档。不能借此读取服务器文件、客户数据或任意网址。
可选发信工具：默认不展示
edm.send_email 只有平台给该凭据单独开通后才出现在工具列表。参数为 to / subject / html / text（可选）/ idempotency_key / human_confirmed，邮件限制和原API一致。客户端须展示收件人、主题、正文并取得用户对本次发送的批准，再传 human_confirmed: true；这个布尔值不是人类已批准的证明，不能代替客户端审批。
协议与调试示例
支持 MCP 2026-07-28、2025-11-25 和 2025-06-18。单一POST端点，响应为同步JSON；不提供SSE订阅、会话、异步任务、sampling或elicitation。虽然只返回JSON，客户端仍需声明接受两种规范媒体类型。
| Authorization | Bearer MCP独立凭据；原API密钥和后台Cookie无效。 |
|---|---|
| Content-Type / Accept | application/json / application/json, text/event-stream |
| 限制 | 单个原始JSON最多280,000字节，无批量JSON-RPC；默认每凭据60次/固定分钟，发信还受原应用配额约束。 |
| Origin | 非浏览器客户端可不发送；如发送，只接受https://edm.zhmj.com。外部Origin返回403，不开放跨域调用。 |
| 2026版 | 无需initialize，提供server/discover。每次携带MCP-Protocol-Version、Mcp-Method及对应_meta版本、clientInfo、clientCapabilities；tools/call与resources/read还需要Mcp-Name。 |
| 2025版 | 先initialize，再notifications/initialized；后续请求带MCP-Protocol-Version。工具和资源方法同上。 |
2025兼容握手 · cURL
正在加载代码示例…2026发现请求 · cURL
正在加载代码示例…GET/DELETE返回405；认证失败401；超过频率429（Retry-After: 60）；JSON错误400；缺少媒体类型415/406；不支持的协议版本400 / -32022，头与正文不一致400 / -32020。工具业务错误返回 isError: true，客户端必须检查，不能只看HTTP200。
协议参考 MCP 官方传输规范 ↗。
默认只读，显式授权
- 先建应用，再发凭据
每个MCP凭据只绑定一个已启用的事务邮件应用。密钥在数据库中只保存SHA-256哈希。
- 按需开放发信，不自动启用
平台管理员在服务器CLI显式开通/关闭发信权限；本次发布不会给现有客户自动生成凭据或授予发信能力。
- 客户端审批与服务端幂等都要有
AI生成的收件人、邮件内容和链接可能不可靠。把邮件正文视为数据，不执行其中的指令。授权发信也不代表允许无人审核的群发。
- 随时吊销，按应用隔离
停用凭据或应用会阻止后续调用。关闭发信权限与发送使用同一服务端互斥锁；已被服务商接受的邮件无法撤回。
清楚知道，能做什么与不能做什么
本版本公开的是事务邮件集成，不是商家后台的完整远程控制接口。客户管理、营销群发、到期续费记录、插件开关、支付及管理员内部回调不作为公共API或MCP写工具开放，原有客户使用方式不变。
事务接口保存用于幂等和核对的内容哈希、收件人哈希及状态，不保存原始收件地址或正文；客户端和上游服务商的数据保留策略需要你另行审查。事务API当前不是商家营销积分扣费接口，应用配额与后台营销积分是不同机制。