内容
# 邮件按钮 MCP 服务器
由 [模型上下文协议](https://modelcontextprotocol.io) 提供的 AI 代理邮件服务。在 [模型上下文协议](https://modelcontextprotocol.io) 上为 AI 代理提供受控的电子邮件服务。
给代理一个限定范围的邮箱，**服务器强制执行防护措施，而不是提示**：默认沙盒邮箱、每次发送的策略门控和防篡改审计日志。外部发送和范围更改由人工批准，代理本身永远不会被授予。
- 注册表：[`com.mailbuttons/mcp-server`](https://registry.modelcontextprotocol.io/v0/servers?search=com.mailbuttons)
- npm：[`@mailbuttons/mcp-server`](https://www.npmjs.com/package/@mailbuttons/mcp-server)
- 平台：**[mailbuttons.com](https://mailbuttons.com)** · 代理前门：**[mbag.ai](https://mbag.ai)**
## 使用它
**托管（推荐）** — 由平台提供的可流式 HTTP 端点：
```
https://mailbuttons.com/api/v1/mcp/rpc
Authorization: Bearer <您的 Mailbuttons MCP token> # mb_sandbox_... （或 mb_prod_...）
```
**本地（stdio）** — 运行 npm 包并让您的代理启动它：
```jsonc
{
"mcpServers": {
"mailbuttons": {
"command": "npx",
"args": ["-y", "@mailbuttons/mcp-server"],
"env": { "MAILBUTTONS_API_KEY": "mb_sandbox_..." }
}
}
}
```
从仪表板或 `POST /api/v1/mcp/sandbox-inboxes` 获取限定范围的令牌。沙盒令牌在被人工提升之前永远无法外部发送。
## 服务器强制执行的内容
- **入站** — 每个邮箱的发件人策略，关闭失败：默认情况下，来自陌生人的邮件会被退回，这样 nobody 可以通过电子邮件注入您的代理。
- **出站** — 代理可以读取但不能更改的收件人阻止列表；阻止的发送返回正常的 `{"status":"blocked"}` 结果，而不是错误。
- **上限 + 审计** — 每个帐户的发送上限和记录拒绝的哈希链审计日志。
- **升级** — 外部发送或扩大范围仅限于提议；命名的人工审批。代理不能批准自己的请求。
## 作为代理技能安装
此存储库附带一个根 `SKILL.md`，因此任何具有技能意识的代理都可以添加它：
```bash
npx skills add mailbuttons/mcp-server
```
## 文档
- 代理注册（适用于代理）：https://mbag.ai/docs/agent-signup.md
- 信任模型：https://mbag.ai/docs/trust-model.md
- OpenAPI：https://mbag.ai/api/openapi.json
- 框架配方：[`references/`](./references) （Claude Agent SDK、LangChain、plain SDK）
Mailbuttons 是 Code Cutter Limited（英国，编号 08453060）的交易名称。采用 MIT 许可。
