为你的 AI 编程智能体配置邮箱地址

为什么要给 AI 编程智能体配置邮箱？

能够读写邮件的 AI 编程智能体可以处理纯代码生成无法完成的任务——发送部署通知、从注册流程中提取 OTP 验证码、在代码审查后安排会议。邮件让一个只能写代码的智能体变成能够与代码仓库之外的人和服务交互的智能体。

智能体与邮件的结合正在成为核心开发者模式，因为智能体需要一种持久的方式与人、服务和其他智能体交换消息。大多数方案将你锁定在单一服务商：Gmail MCP 服务器只能连接 Google，Microsoft Graph 只能连接 Outlook。Nylas CLI 通过一次认证流程连接所有 6 家主要邮件服务商，并兼容任何支持 MCP 的编程智能体。

步骤 1：注册、连接账户并配置 CLI

在连接任何智能体之前，你需要一个 Nylas 账户（至少有一个邮箱 grant），并且 Nylas CLI 已通过 API 密钥认证。整个前置流程大约需要 2 分钟，且只需执行一次——之后连接的每个智能体都复用相同的凭据和 grant。

1. 注册 Nylas 并创建 API 密钥

访问 dashboard-v3.nylas.com，创建免费账户，然后在 Settings 中生成 API 密钥。Nylas 免费版最多可连接 5 个账户。

2. 在 Grants 中连接至少一个邮箱账户

在 Nylas 仪表盘中，进入 Grants 并连接 Gmail、Outlook、Exchange、Yahoo、iCloud 或 IMAP 账户。这就是你的 AI 智能体将要使用的邮箱地址。Nylas 会处理 Google 和 Microsoft 的 OAuth 流程，无需你自行注册 OAuth 应用。

3. 安装 Nylas CLI 并配置 API 密钥

Nylas CLI 是一个无运行时依赖的单一二进制文件。在 macOS 和 Linux 上，Homebrew 是最快的安装方式。安装后，运行 nylas auth config --api-key 将 API 密钥存储在本地，然后通过 nylas auth whoami 验证连接。

# 安装（macOS / Linux）
brew install nylas/nylas-cli/nylas

# 配置 API 密钥
nylas auth config --api-key YOUR_NYLAS_API_KEY

# 验证连接
nylas auth whoami

Windows 或 Shell 脚本和 Go 安装方式，请参阅入门指南。

将 YOUR_NYLAS_API_KEY 替换为 Nylas 仪表盘中的密钥。根据 Nylas MCP 文档，这将为你的智能体提供跨 6 家服务商的 16 个邮件、日历和联系人工具。

步骤 2a：为 Claude Code 配置邮箱

Claude Code 原生支持 MCP，因此将其连接到真实邮箱账户只需一条命令。Nylas CLI 会写入 MCP 服务器配置并在 Claude Code 的设置文件中预批准所有 16 个工具，省去了每次邮件操作都会弹出的逐工具权限确认提示。

nylas mcp install 命令直接操作 Claude Code 的配置文件。它会在 ~/.claude.json 中添加服务器条目，并在 ~/.claude/settings.json 中添加 mcp__nylas__* 通配符权限。

# 为 Claude Code 安装 MCP
nylas mcp install --assistant claude-code

运行此命令后，重启 Claude Code 以加载新的 MCP 服务器。所有 16 个 Nylas 工具均已预批准，无需交互式确认。试试这些自然语言请求：

• "读取我最近的 5 封邮件"
• "给 alice@example.com 发一封关于部署的邮件"
• "查看我明天的日历"

关于 MCP 的完整深入介绍——可用工具、区域端点、时区处理——请参阅 AI 智能体通过 MCP 访问邮件指南。

步骤 2b：为 Cursor 配置邮箱

Cursor 原生支持 MCP，Nylas CLI 只需一条命令即可完成配置。Cursor 提供两种连接方式：通过 CLI 的本地 STDIO 服务器，或绕过 CLI 的托管 HTTP 端点。两种方式都向 Cursor 的 Agent 模式暴露相同的 16 个工具。

本地方式运行 nylas mcp install --assistant cursor，会在 ~/.cursor/mcp.json 中写入服务器条目。CLI 进程作为本地 STDIO 服务器运行，处理所有对 Nylas 的 API 调用。

# 为 Cursor 安装 MCP
nylas mcp install --assistant cursor

安装完成后，重启 Cursor，打开 Settings，在 Tools & MCP 中检查 "nylas" 旁边是否显示绿点。

替代方案：托管 MCP 服务器（无需安装 CLI）。 Cursor 还支持 streamable HTTP MCP 服务器。此方式直接连接 Nylas MCP 端点 mcp.us.nylas.com，无需本地 CLI 进程。将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer YOUR_NYLAS_API_KEY"
      }
    }
  }
}

将 YOUR_NYLAS_API_KEY 替换为你在 Nylas 仪表盘中的 API 密钥。此方式完全绕过本地 CLI 代理。 Nylas MCP 文档 涵盖了两种方式的详细说明。

步骤 2c：为 OpenAI Codex CLI 配置邮箱

OpenAI Codex CLI 原生支持 MCP 服务器，提供三种连接方式：通过 Nylas CLI 的本地 STDIO、托管 HTTP 端点，或不使用 MCP 的直接 Shell 命令。根据 OpenAI Codex MCP 文档，Codex 在会话启动时自动启动 MCP 服务器，无需手动维护进程。

方式 A：通过 Nylas CLI 的本地 MCP

codex mcp add 命令将 Nylas 注册为本地 STDIO 服务器。Codex 将配置存储在 ~/.codex/config.toml 中，并在每次会话开始时启动服务器进程。

# 添加 Nylas 为 MCP 服务器（STDIO）
codex mcp add nylas -- nylas mcp serve

这会在 ~/.codex/config.toml 中添加一个 [mcp_servers.nylas] 条目。生成的配置如下所示：

# ~/.codex/config.toml
[mcp_servers.nylas]
command = "nylas"
args = ["mcp", "serve"]

方式 B：托管 MCP 服务器（无需安装 CLI）

托管方式通过 HTTP 将 Codex 直接连接到 Nylas MCP 端点，完全绕过本地 CLI 进程。Codex 从环境变量读取 Bearer Token，因此 API 密钥不会出现在配置文件本身中。将服务器条目添加到 ~/.codex/config.toml，并在 Shell 配置文件中设置 NYLAS_API_KEY 环境变量。

# ~/.codex/config.toml
[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"

# 设置环境变量
export NYLAS_API_KEY="your-api-key-here"

方式 C：Shell 命令（无需 MCP）

Codex 也可以在其沙箱 Shell 中直接运行 Nylas CLI 命令，无需 MCP。每条命令在 Codex 的沙箱中运行，执行前需要用户批准——为每个操作增加了一个手动确认步骤。CLI 命令默认返回纯文本，使用 --json 标志可返回结构化 JSON，供 Codex 解析并用于后续推理。

# 读取最近的邮件
nylas email list --limit 10

# 搜索特定邮件
nylas email search "deploy notification"

# 发送邮件
nylas email send --to alice@example.com --subject "Deploy complete" --body "v2.4.1 is live."

# 以 JSON 格式输出，用于结构化解析
nylas email list --limit 5 --json

关于围绕 Shell 命令构建结构化工具定义，请参阅 使用邮件工具构建 LLM 智能体。

步骤 2d：为 OpenClaw 配置邮箱

OpenClaw 使用插件系统而非 MCP，因此配置方式与其他 4 个智能体不同。Nylas 插件为 OpenClaw 提供原生邮件、日历和联系人工具，具备类型化 Schema 和多账户支持。安装需要 6 条命令：安装插件、授权插件、配置 API 密钥、重启网关、验证。

插件系统需要显式信任配置。安装插件包后，你必须将 "nylas" 添加到 plugins.allow 和 tools.alsoAllow，以便 OpenClaw 向智能体会话暴露这些工具。重启网关确保新的插件配置被加载。

# 安装 Nylas 插件
openclaw plugins install @nylas/openclaw-nylas-plugin

# 信任插件并向智能体会话暴露其工具
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# 配置 API 密钥
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# 重启网关以加载插件配置
openclaw gateway restart

# 验证插件能否看到你的已连接账户
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

安装完成后，OpenClaw 可以通过自然语言发送邮件、阅读邮件线程、管理日历事件和搜索联系人。插件会自动发现 Nylas 仪表盘中所有已连接的邮箱账户——无需逐个配置。

完整配置详情请参阅 安装 OpenClaw Nylas 插件 指南。初次使用 OpenClaw？从 OpenClaw CLI 配置指南开始。

对比：各 AI 编程智能体的邮箱配置

五款 AI 编程智能体可以通过 Nylas 连接邮箱，每款使用不同的配置文件和集成方式。其中四款——Claude Code、Cursor、Codex CLI 和 Windsurf——通过 MCP 连接，使用本地 STDIO 服务器或托管 HTTP 端点。OpenClaw 通过其自有插件系统连接。下表汇总了每个智能体的配置命令和配置文件位置。

所有五款智能体获得相同的 16 个邮件、日历和联系人工具。MCP 智能体（Claude Code、Cursor、Codex、Windsurf）通过 Nylas MCP 服务器连接。OpenClaw 通过其插件系统连接。每种方式都支持全部 6 家邮件服务商：Gmail、Outlook、Exchange、Yahoo、iCloud 和 IMAP。

你的智能体有了邮箱后能做什么

拥有邮箱访问权限的 AI 编程智能体可以处理 6 类原本需要切换到邮件客户端的任务：发送通知、阅读确认邮件、提取 OTP 验证码、安排会议、搜索邮件历史和起草回复。所有 16 个 MCP 工具都支持自然语言指令——无需记忆标志或命令语法。

• 发送部署通知——"给团队发邮件说 v2.4.1 已上线生产环境"
• 阅读确认邮件——"查看收件箱中的 AWS 注册确认邮件"
• 提取 OTP 验证码——"从最新邮件中获取 6 位验证码"（参见 邮件作为 AI 智能体的身份标识）
• 安排会议——"下周二下午 2 点与 alice@company.com 预约 30 分钟电话"
• 搜索邮件历史——"查找所有关于 Q4 合同的邮件并总结关键决策"
• 起草回复——"根据更新后的数据，起草回复 Sarah 的预算问题"

安全与访问控制

给 AI 智能体邮箱访问权限需要设置防护措施，以防止误发邮件和未授权的数据访问。Nylas CLI 和 MCP 执行两步发送模式：智能体先创建草稿，然后通过单独的确认步骤批准后邮件才会发出。此模式适用于所有 5 款支持的智能体，覆盖 100% 的出站邮件操作。

• 需要发送确认。MCP 工具在实际发送邮件前需要一个 confirm_send_draft 步骤。你的智能体先创建草稿，然后由你批准。
• 本地凭据存储。Nylas CLI 将 OAuth 令牌存储在本机。除非你运行命令，令牌不会离开你的系统。
• 沙箱执行。Codex CLI 在沙箱中运行 Shell 命令，每个操作都需要用户批准。
• 随时撤销。运行 nylas auth logout 断开连接，或运行 nylas auth list 查看已连接的账户。

关于 AI 智能体邮件操作的完整审计日志，请参阅 审计 AI 智能体活动指南。

后续步骤

配置好邮箱访问后，接下来的工作包括设置防护规则控制智能体可以发送的内容、审计智能体活动以确保合规、以及用 Python 或 TypeScript 构建自定义智能体工作流。以下指南涵盖了从初始邮箱接入到生产级智能体邮件基础设施的完整生命周期。

• 防止你的 AI 智能体失控 ——在策略层阻止高风险出站邮件和自动回复循环的管控规则
• AI 智能体通过 MCP 访问邮件 ——MCP 完整深入介绍，涵盖 16 个工具、区域端点和时区处理
• ChatGPT Gmail 连接器 vs MCP ——对比托管 ChatGPT 应用、自定义 MCP 应用和本地 CLI MCP
• MCP 邮件服务器安全清单 ——最小权限、令牌边界、Webhook 验证和写入控制
• AI 智能体的 MCP vs API ——基准测试和决策矩阵，帮助选择 MCP、直接 API 或 Skills
• 使用邮件工具构建 LLM 智能体 ——Python 和 TypeScript 中自定义智能体的子进程模式
• 为什么 AI 智能体需要邮件 ——认证、OTP、审计追踪和多线程对话
• 审计 AI 智能体活动 ——追踪 Claude Code、Copilot 和 MCP 智能体执行的每个操作
• 创建 AI 智能体邮件身份 ——为智能体分配专属托管 provider=nylas 收件箱，而非借用你自己的
• 完整命令参考——每个标志、子命令和示例
• Nylas MCP 文档 ——官方服务器配置和 API 参考