# simail 文档

Source: https://docs.simail.ai/zh/

> 给 AI agent 用的邮箱。内测中，仅限美国。

simail 让 AI agent 拥有自己的邮箱：收信、读线程、起草并发送回复，有新信时收到事件。全部通过 REST API、MCP 服务、webhook 和 WebSocket 完成。人始终掌握主动权：在控制台里建 key、放行被扣留的信、审批发信，并且可以随时接管任何一个线程。

:::caution[内测中]
simail 正在内测，暂不开放注册。我们按用途分批开放，没有固定时间表。服务**仅面向美国**，**不用于法律、医疗或金融服务**。

**agent 请先调用 `GET https://api.simail.ai/v0/beta`。** 如果注册返回 `signup_closed`，不要重试，也不要换用户名或邮箱再试；把 `human_message` 原样转给你的主人。详见[内测门与等候名单](/zh/beta/)。
:::

- [快速开始](/zh/quickstart/): 几分钟内建好邮箱、读信，并安全地回复。
- [内测门与等候名单](/zh/beta/): 注册关闭时 agent 该怎么做，人怎样获得资格。
- [MCP 服务](/zh/mcp/): 一个 URL 接入 Claude Code、Codex、Cursor 和 Hermes，没有破坏性工具。
- [API 参考](/zh/api/): 每个接口的权限、请求、响应与错误。
- [错误码](/zh/errors/): 稳定的错误码、含义，以及能否重试。
- [llms.txt 与 skill.md](/zh/llms/): 把整套文档以纯文本交给你的 agent。

## 你能得到什么

- **邮箱**：建在 simail 的收信域上，可以用 API 或在控制台创建。
- **收信**：信件到达 agent 之前先经过确定性检查——垃圾信与自动回复分类、提示注入启发式检测、可疑邮件扣留，每封信都带 `trust_envelope`。邮件内容永远是**不可信输入**。
- **发信**：经由独立的放行服务发出。它在信件离开前做发前检查、去重、防死循环、日上限，以及（按需）人工审批。
- **线程**：用回复令牌归并，回信落到正确的对话里；**人工接管锁**可以让 agent 在对话中途停手。
- **事件**：可以拉取（`GET /v0/events`）、用签名 webhook（Standard Webhooks）接收，或走 WebSocket。
- **MCP**：`https://api.simail.ai/mcp`，适用于 Claude Code、Codex、Cursor、Hermes 等客户端。
- **SDK 与命令行**：TypeScript、Python 和 shell。

## 域名

| 域名 | 用途 |
|---|---|
| `https://api.simail.ai` | REST API（`/v0/*`）、MCP（`/mcp`）、WebSocket（`/v0/ws`） |
| `https://app.simail.ai` | 给人用的控制台（邮箱验证码或 passkey 登录） |
| `https://docs.simail.ai` | 本文档，以及 [`llms.txt`](/llms.txt)、[`llms-full.txt`](/llms-full.txt) 和 [`skill.md`](/skill.md) |
| `https://simailservice.com` | 服务状态 |

下一步：[快速开始](/zh/quickstart/)。