接入 AI 助手

nicemails 提供远程 MCP 服务。接入后，AI 助手可以列出你的邮箱、读取和搜索邮件、整理邮件、新建邮箱，并在你确认后发信。它只能使用你授予的权限和邮箱。

MCP 服务地址（Streamable HTTP）

https://nicemails.net/mcp

方式一：OAuth 登录（推荐）

  1. 在 Claude 中打开 Settings → Connectors，选择 Add custom connector。
  2. 填入上面的 MCP 服务地址并添加。
  3. 浏览器打开后登录 nicemails。
  4. 在授权页选择权限，以及助手可以使用全部邮箱还是只用一个，然后点「允许」。

其他支持远程服务 OAuth 登录的 MCP 客户端接入方式相同：填地址、登录、授权，不需要复制任何密钥。

方式二：API 密钥

适用于不支持 OAuth 登录的客户端和无人值守的程序。在 nicemails 打开「设置 → API 密钥」，点「创建 API 密钥」，密钥用途选「AI 代理（MCP）」，选好权限和邮箱后复制密钥。密钥只显示一次。

每个请求都带上这个 HTTP 头：

Authorization: Bearer <YOUR_API_KEY>

多数 MCP 客户端接受类似下面的配置。把占位符换成你的密钥，并妥善保管。

{
  "mcpServers": {
    "nicemails": {
      "type": "http",
      "url": "https://nicemails.net/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

权限

权限在授权页或创建密钥时选择。连接也可以限定到单个邮箱，此时所有权限都只作用于该邮箱。

工具

只读工具不会改动你的邮件。会改动数据的工具都有标注，客户端可以在每次调用前先问你。

工具类型作用
list_mailboxes
List mailboxes		只读列出这个连接可以使用的邮箱及其存储用量。
create_mailbox
Create mailbox		会改动数据在套餐额度内新建一个独立邮箱。
list_messages
List messages		只读列出某个邮箱一个文件夹里的邮件，最新的在前。
search
Search messages		只读在选定邮箱的所有文件夹中搜索。
get_message
Read message		只读读取一封邮件的正文、附件信息和投递状态，不会把它标为已读。
send_message
Send message		会改动数据从你的某个邮箱排队发出一封邮件。新收件人需要你先确认。
move
Move message		会改动数据把邮件移到同一邮箱的另一个文件夹。
flag
Set message flags		会改动数据把邮件标为已读或未读、星标或已回复。

安全

REST API 参考