如何把 nicemails 连接到 Claude Code

Q: /mcp 里 nicemails 显示失败或需要登录。

在 /mcp 里选择 nicemails 重新登录。还不行的话，在同一菜单里选 Clear authentication 再登录一次。运行 claude mcp get nicemails 检查地址是否为 https://nicemails.net/mcp。

Q: 怎样从 Claude Code 移除 nicemails？

运行 claude mcp remove nicemails。要在 nicemails 这边也结束访问，在「设置 → API 密钥 → 已连接的应用」里断开应用，或撤销密钥。

要给 Claude Code 一个邮箱，用 claude mcp add 以 HTTP 传输添加 nicemails 的 MCP 服务器，然后在 Claude Code 里运行 /mcp，在浏览器中登录 nicemails。批准权限后，Claude Code 就能搜索和阅读你的邮箱、整理邮件，并在你批准后发信。

开始前需要准备什么？

一个 nicemails 账号，以及给这项工作用的邮箱，比如 qa-signups。注册免费，用发到你邮箱的验证码登录，没有密码。
Claude Code。按 Claude Code 文档，远程服务器使用 HTTP 传输，旧的 SSE 传输已弃用。nicemails 使用 Streamable HTTP，不需要额外参数。

怎样把 nicemails 添加到 Claude Code？

在终端里把 nicemails 添加为远程 HTTP 服务器。不加 scope 参数时，只对你在当前项目里生效（local scope）：
```
claude mcp add --transport http nicemails https://nicemails.net/mcp
```
在这个项目里启动 Claude Code，运行 /mcp。选择 nicemails 并登录，浏览器会打开 nicemails 登录页。
用发到你邮箱的验证码登录。在授权页上勾选权限，选择 Claude Code 可以用全部邮箱还是只用一个，然后点「允许」。
回到 Claude Code，/mcp 会显示 nicemails 已连接。试着问「列出我的 nicemails 邮箱」。

scope 决定服务器在哪里可用。默认的 local scope 只对你、只在这个项目里。加 --scope user 可在你所有项目里使用。--scope project 会写进项目根目录的 .mcp.json，拉取项目的同事也会得到它：

{
  "mcpServers": {
    "nicemails": {
      "type": "http",
      "url": "https://nicemails.net/mcp"
    }
  }
}

这个文件里只有地址。每位同事都在 /mcp 里登录自己的 nicemails 账号。

已经在 Claude 里加过 nicemails 连接器？用 Claude 账号登录 Claude Code 时，这个连接器会自动出现在 /mcp 里。如果又用 claude mcp add 加了同一个地址，Claude Code 自己的条目优先，连接器会显示为 hidden。

怎样改用 API 密钥？

没有浏览器的会话适合用密钥，比如 CI 任务或远程机器。先创建密钥：

在 nicemails 打开「设置 → API 密钥」，点「创建 API 密钥」。
密钥用途选「AI 代理（MCP）」。
勾选权限，需要的话把密钥限定为一个邮箱。
复制密钥。它只显示这一次。

然后把密钥作为请求头添加服务器：

claude mcp add --transport http nicemails https://nicemails.net/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

共享的 .mcp.json 里不要写密钥本身。Claude Code 会展开 headers 里的环境变量，每个人在自己机器上设置 NICEMAILS_API_KEY 即可：

{
  "mcpServers": {
    "nicemails": {
      "type": "http",
      "url": "https://nicemails.net/mcp",
      "headers": {
        "Authorization": "Bearer ${NICEMAILS_API_KEY}"
      }
    }
  }
}

连接后 Claude Code 能对邮箱做什么？

Claude Code 能用你授权范围内的 nicemails 工具，共 8 个，每个都以 mcp__nicemails__<tool> 的名字出现：

list_mailboxes：列出这个连接能用的邮箱。
list_messages：列出某个邮箱一个文件夹里的邮件，最新的在前。
search：搜索所选邮箱的所有文件夹，包括垃圾邮件。
get_message：读取一封邮件，不会把它标为已读。
create_mailbox：新建邮箱（需要「管理」权限，且连接不限定单个邮箱）。
move 把邮件移到别的文件夹；flag 把邮件标为已读、未读、星标或已回复。
send_message：从你的某个邮箱发信（需要「发信」权限；新收件人要你先批准）。

测试注册流程时很方便。可以说：「新建一个叫 signup-test-42 的邮箱，用它在 staging 应用里注册，再找到验证邮件打开链接」，或者「在 qa 邮箱里找刚触发的重置密码邮件，检查链接是否指向 staging」。

Claude Code 做的事由谁批准？

权限：连接只拿到你勾选的权限：读取（列出、搜索、阅读邮件）、管理（新建邮箱、移动邮件、设置标记）和发信。连接还可以限定为只用一个邮箱。
发信确认：如果收件人不是你在最近 30 天内从网页版发过信、或在之前的确认中信任过的地址，就什么都不会发出，直到你登录 nicemails 在确认页上批准这封信。未批准的请求 15 分钟后失效。
Claude Code 自己的权限规则照常生效。nicemails 把 list_mailboxes、list_messages、search、get_message 标为只读，其余工具标为会改动数据，所以你可以放行读取、在 mcp__nicemails__send_message 之前继续询问。
不可信内容：工具结果会把邮件内容标为不可信数据，邮件里的任何文字都不能批准发信。
随时断开：在「设置 → API 密钥 → 已连接的应用」里断开 Claude Code，或撤销它的密钥，访问立即结束。

排查问题

/mcp 里 nicemails 显示失败或需要登录。

在 /mcp 里选择 nicemails 重新登录。还不行的话，在同一菜单里选 Clear authentication 再登录一次。运行 claude mcp get nicemails 检查地址是否为 https://nicemails.net/mcp。

Claude Code 里看不到我在 Claude 里加的 nicemails 连接器。

只有 Claude Code 用 Claude 订阅登录时才会加载 Claude 的连接器。按 Claude Code 文档，ANTHROPIC_API_KEY 或其他 API 凭据生效时不会加载。运行 /status 查看，或者直接用 claude mcp add 添加 nicemails。

怎样从 Claude Code 移除 nicemails？

运行 claude mcp remove nicemails。要在 nicemails 这边也结束访问，在「设置 → API 密钥 → 已连接的应用」里断开应用，或撤销密钥。