教程：让 Agent 记住你的 Gmail（5 分钟）

本教程演示：连接 Gmail → 自动同步邮件到记忆库 → 在 Claude Code / Cursor 中检索回忆。

1. 准备

一个 Awareness 账号（awareness.market）
一个记忆库（Overview → New database，或使用已有）
Gmail 账号（建议用测试邮箱先验证）

2. 连接 Gmail

打开你的记忆库 → Documents 标签
在 Connectors 区域找到 Gmail → 点 Connect Gmail
在弹出的 Google 授权页选择账号并同意（只需 gmail.readonly + gmail.send）
授权完成后回到记忆页，Gmail 卡片会显示已连接
点 Sync 拉取最近的邮件（首次同步可能需要几分钟）

同步规则：

按 Message-ID 幂等，不会重复入库
邮件正文自动清洗（去除 HTML 样式/脚本）
每封邮件作为一条知识记录写入记忆库

3. 让 Agent 使用记忆

Claude Code（MCP）

{
  "mcpServers": {
    "awareness": {
      "type": "http",
      "url": "https://awareness.market/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

获取 token：记忆库 → Connect（成功页）或调用 POST /api/v1/tenants/{id}/token。

Cursor / OpenCode

同上，在各自的 MCP 配置中加入上面的 mcpServers.awareness 段。

4. 验证

在 agent 里提一个只有邮件里才有答案的问题，例如：

“我上次和供应商谈的付款条件是什么？”

agent 会调用 recall 检索记忆库，并引用来源邮件。

5. 常见问题

问题	解决
授权后没有邮件	点 Sync 手动触发；检查连接器状态是否 active
检索不到	确认邮件已同步（Documents 中可见），并等待向量索引完成
Token 失效	重新在 Connect 页获取（轮换后旧 token 立即失效）
连接器显示错误	断开后重新授权（令牌过期时会出现）

进阶

把 Drive / Notion / 飞书 也连上，agent 就能同时回忆文档与邮件
开启审计（Team/Enterprise）后，每条记忆都有状态链与锚定证明

Docs.items.gmailTutorial