如何把 nicemails 连接到 VS Code

要给 VS Code 里的 GitHub Copilot 一个邮箱，先创建 nicemails API 密钥，再在 mcp.json 里把 nicemails 添加为 HTTP 服务器，用 Authorization 请求头发送密钥。VS Code 只询问一次密钥并安全保存；之后 Copilot 就能读取、搜索、整理你的邮件，并在你批准后发信。

开始前需要准备什么？

本指南使用 API 密钥。VS Code 的配置参考文档里，远程服务器的 OAuth 需要事先注册好的 client ID；nicemails 只通过自动注册发放 OAuth 客户端，没有固定的 client ID 可以给你，所以可靠的做法是把密钥作为请求头发送。

怎样创建 API 密钥？

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

每台机器或每个工作区各建一个密钥，这样撤销其中一个不会影响其他。

怎样把 nicemails 添加到 VS Code？

  1. 要在所有工作区使用，在命令面板运行 MCP: Open User Configuration；只在某个工作区用，就在工作区文件夹里新建 .vscode/mcp.json。加入密钥输入项和 nicemails 服务器：
    {
  "inputs": [
    {
      "type": "promptString",
      "id": "nicemails-key",
      "description": "nicemails API key",
      "password": true
    }
  ],
  "servers": {
    "nicemails": {
      "type": "http",
      "url": "https://nicemails.net/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nicemails-key}"
      }
    }
  }
}
  2. 保存文件。服务器第一次启动时，VS Code 会询问 nicemails API 密钥。粘贴密钥，VS Code 会安全保存，之后不再询问。
  3. 打开 Copilot Chat，问「列出我的 nicemails 邮箱」。出现工具请求时批准它。
  4. 之后要查看服务器和它的控制项，运行 MCP: List Servers。

VS Code 的顶层键是 servers，不是其他客户端用的 mcpServers。它会先尝试 Streamable HTTP，nicemails 支持这种传输。

不要把密钥填进 MCP: Add Server 表单、聊天或共享文件，VS Code 文档对这三种做法都有提醒。用 inputs 之后，密钥不会出现在 mcp.json 里，工作区文件可以放心共享。

连接后 Copilot 能对邮箱做什么？

Copilot 能用密钥权限范围内的 nicemails 工具，共 8 个：

例如：「在 billing-test 邮箱里找支付服务商沙箱发来的最新邮件，告诉我它提到了哪个 webhook」，或者「把 builds 邮箱里 CI 通知的邮件全部标为已读」。

Copilot 做的事由谁批准？

排查问题

VS Code 没有询问密钥，或者服务器启动不了。

检查 JSON：顶层键必须是 servers，type 必须是 http，${input:nicemails-key} 里的 id 要和 inputs 里的 id 一致。运行 MCP: List Servers 查看服务器和可执行的操作。

服务器启动了，但每次调用都提示未授权。

密钥错误、已被撤销，或粘贴时带了多余空格。新建一个密钥，然后把两处的输入 id 一起改掉，比如改成 nicemails-key-2，VS Code 就会询问新的值。

能不用密钥、改用 OAuth 登录吗？

VS Code 配置参考里的 OAuth 需要事先注册的 client ID。nicemails 只通过自动注册发放 client ID，所以本指南不介绍 VS Code 的 OAuth 配置，请使用密钥。

相关指南

免费开始