连接应用（插件）：Gmail、Slack、日历怎么接
上一课它记住了你；这一课给它发「工牌」。Grok Bot 插件（官方界面叫 Connect apps，帮助文档里也叫 app / plugin / connected app）是 Bot 和外部服务之间的结构化通道：连上 Gmail、Slack、Google 日历，Bot 就能直接搜邮件、发消息、建日程——不用打开网页一步步点。
全程约 12 分钟。连接属于你的账号：连一次，你名下的所有 Bot 都能用。
学完你能做什么
- 用官方 5 步连上 Gmail、Slack、Google 日历等插件（授权在浏览器里完成，约 10 分钟内）
- 分清 Added ≠ 已登录：看到 Needs auth / Disconnected 状态，知道点哪里救回来
- 说得出常用插件的能力边界：Calendar 加不了 Zoom 链接、Slack 以你的身份发帖、Gmail 一次只连一个邮箱
- 公司 Google 账号被拦时，把「Your admin needs to review Grok」的四步操作单转给 IT
- 在聊天里用
@把插件挂到具体任务上，并让 Bot 代装应用、添加 MCP server
你现在的困境
- 让 Bot 查个日历、发条 Slack，它默默开浏览器去点网页——慢，还时不时点岔
- 你说「帮我搜下邮件」，它回「没有 Gmail 权限」；设置翻遍了，搞不清连接状态到底看哪里
- 公司 Google 账号授权到一半弹出「Your admin needs to review Grok」——不知道该找谁、做什么
什么时候用这一招
当你需要：
- Bot 直接读写 Gmail、Slack、Google 日历、表格——搜索、起草、建日程，而不是爬网页
- 连一次、所有 Bot 共用，不用每个 Bot 重复登录
- 在任务里用
@精确指定这次用哪个应用
而且不想：
- 把密码交给 Bot——插件的 OAuth token 存在 Cursor 的 connector 后端，Bot 经手不了
- 每个任务都重新登录一遍
- 外发内容失控——邮件和 Slack 消息默认先出草稿等你审
🎒 开始前的准备
- 完成了 1.5 第一个 Bot：手上有至少一个自己的 Bot，派过一次活
- 准备好要连接的账号：Gmail、Slack 或 Google 账号，能在网页版正常登录
- 公司 Google 账号用户：知道你们的 Google 管理员是谁（可能需要 TA 审核一次）
- 一杯水 ☕——本课全程点界面，没有命令要跑
核心思路
插件给 Bot 一条结构化通道：不模拟点击网页，而是直接调用服务接口。官方原则很直白——有插件的服务用插件，更可靠；没有插件的服务、或插件没暴露的可视化操作，才让 Bot 走浏览器。
| 连接应用（插件） | 让 Bot 用浏览器 | |
|---|---|---|
| 怎么工作 | 调服务接口，结构化读写 | 打开网页，模拟点击输入 |
| 可靠性 | 高，官方推荐优先用 | 看页面脸色，改版就失效 |
| 适用 | Gmail、Slack、日历等有插件的服务 | 没插件的服务、可视化流程 |
| 登录 | 授权一次，token 存 Cursor connector 后端 | 云电脑浏览器里的持久会话 |
三条机制，决定你后面所有操作：
- 连接属于账号，不属于某个 Bot：一个插件连上，你账号下的每个 Bot 都能用；队友的 shared Bot 用你的账号前会先问你
- 登录凭据不落 Bot 手里：OAuth token 存在 Cursor 的 connector 后端，Bot 调用工具时拿不到 token 本身
- 能力以你授权的账号为上限：插件只能做这个账号本来就能做的事——不能提权，也不能改分享；团队策略可以禁用某个插件（显示 Disabled by team admin），但禁插件不等于封网站
常用插件能做什么、不能做什么（官方边界）：
| 插件 | 能做 | 不能做 / 注意 |
|---|---|---|
| Gmail | 搜索、读邮件，起草、发送，打标签 | 一次只连一个邮箱；换邮箱要先断开当前的再授权另一个 |
| Slack | 以你连接的 Slack 用户身份发帖 | 只能在该用户能发的频道发；换 workspace 要另连 |
| Google Calendar | 读你可见的日历，创建/更新日程，查空档，回应邀请（限你可编辑的日历） | 改不了 Google Meet 设置（等候室、主持人控制）；加不了 Zoom 链接 |
| Google Sheets | 读写连接账号可编辑的表格单元格 | Viewer 分享的文件只读；找文件要靠 Google Drive 插件 |
| Google Drive | 搜索、读取该账号能打开的文件 | — |
| X 插件 | 读你的 DM、书签、时间轴、谁赞过你的帖 | 需要你自己 X 开发者账号上有 X API credits |
💡 连上云盘类插件还有个福利
连接 Google Drive / OneDrive / SharePoint / Gmail / Outlook 后，Bot 可以在云电脑和这些账户之间互传文件（Google Docs 会转成 .docx 等格式）——见 2.2 文件与可审阅结果。
跟我做
第 1 步：打开 Connect apps（Grok Bot 插件的总入口）
为什么：所有插件的添加、授权、状态检查都集中在一个地方。聊天里出现 Connect 卡时也能顺手连，但入口始终是这里。
三种打开方式，任选其一：
- 桌面版：侧栏点 Connect apps，或按快捷键
Cmd/Ctrl+Shift+M（Cmd/Ctrl+Shift+W也行） - 聊天中：Bot 发来 Connect 卡，直接跟着走
- 手机版：点左上角头像 → Connect apps
你应该看到：应用目录，可以浏览或搜索；标题旁有一个已连接计数（connected count）——第 3 步查状态时会用到它。
- 打开了 Connect apps，能看到应用目录
第 2 步：添加并授权一个插件（以 Gmail 为例）
为什么：添加（add）只是把插件装到账号上，授权（Authorize / Authenticate）才是真正登录。两步连着做，一次完成。
官方 5 步：
- 打开 Connect apps（或跟着聊天里的 Connect 卡走）
- 浏览或搜索应用，添加它
- Grok Bot 提示 Authorize 或 Authenticate 时，在浏览器里完成服务商登录
- 登录没完成？在应用上点 Reconnect，或在聊天卡上点 Reopen，把登录页调回来
- 确认应用出现在 Installed 下
授权这一步发生在你自己的浏览器里（不是云电脑的浏览器），用目标账号登录，大约 10 分钟内完成。
💡 国内用户
授权要在你的浏览器里打开 Google / Slack 的登录页。网络环境的整体注意事项，见 1.7 国内使用指南。
你应该看到：浏览器完成 Google 登录后回到 Grok Bot，Gmail 出现在 Installed 列表里。
- Gmail 出现在 Installed 下
第 3 步：检查状态，分清 Added 与已登录
为什么：最容易踩的坑在这里——Added 只代表「已安装」，不代表「已登录」。Bot 说「应用缺失」时，多半是状态没到 Connected。
点 Connect apps 标题旁的已连接计数，逐个核对状态：
| 状态 | 含义 | 你要做的 |
|---|---|---|
| Added（在 Installed 下） | 已安装，未必已登录 | 看有没有登录提示，别急着派活 |
| Needs auth / Disconnected | 需要登录 / 登录已断开 | 打开该应用点 Authenticate（手机上叫 Authorize），完成登录 |
| Connected | 已连接，可用 | 回聊天发条新消息，让 Bot 重试 |
| Disabled by team admin | 被团队连接器策略禁用 | 找你们的 Cursor 团队管理员开启 |
你应该看到：目标插件状态为 Connected。此时发一条新消息让 Bot 重试，它就能用上这个应用了。
- 目标插件显示 Connected，Bot 重试后用上了它
第 4 步：再连 Slack 和 Google 日历（能力边界速查）
为什么：Gmail 跑通后，Slack 和 Google Calendar 的流程基本一样——但官方各自写明了边界，先了解清楚，免得之后误以为「连了怎么还不行」。
连 Slack：Connect apps → 搜索 Slack → 添加 → 授权时登录你的 Slack 账号。两个注意点：
- 它以你连接的那个 Slack 用户身份发帖——不是一个需要被拉进频道的机器人；也只能在那个用户能发的频道里发
- 要用另一个 workspace？把那个 workspace 也连上（一个 workspace 一次连接）
顺带分清：Slack 消息触发 routine（自动化）是另一套机制，和这个插件无关——见 3.3 Routines。
连 Google Calendar：同样三步。连好后 Bot 能读你可见的日历、创建和更新日程、查空档、回应邀请（限你可编辑的日历）。
两个「不是 Bug」的边界：
- 改不了 Google Meet 设置，比如等候室和主持人控制
- 加不了 Zoom 链接（Google 的 Zoom 附加组件对应用不可用）——把 Zoom 链接自己填进日程的地点或描述里，或者反过来：你先在日历里建好日程，让 Bot 补其他字段
你应该看到：Slack 和 Calendar 都出现在 Installed 下且状态 Connected；跟 Bot 说「查一下我明天下午的空档」，它能报出结果。
- Slack / Calendar 至少连上一个，并让 Bot 用过一次
第 5 步：用 @ 把插件挂到任务上派活
为什么：连接是账号级的，但具体任务里可以精确点名用哪个应用——在聊天输入框打 @，从弹出列表选中应用，它就挂到这条任务上。
三个可以直接抄的例子（选中对应应用后再写任务）：
搜一下收件箱里过去一周带「发票」的邮件，按金额列个清单
把今天的站会纪要发到 #daily 频道，先给我草稿
看我周四下午有没有两小时的空档，有就在日历上建一个「复盘会」
你应该看到：外发的邮件和 Slack 消息默认先出可编辑的草稿卡（显示 Needs approval），你审完点 Send / Send message 才发出去；查日历这类只读操作直接出结果。想让它免草稿直接发，可以在草稿卡菜单里 Disable drafts for Bot——之后仍受 Auto Review 约束，见 3.1 审批与 Auto Review。
- 用
@挂着插件跑通了至少一个任务
检查点 ✅
- 在 Connect apps 里添加过一个插件，并在 Installed 下看到它
- 能说出「Added ≠ 已登录」，知道 Needs auth / Disconnected 要点 Authenticate
- 至少一个插件（Gmail / Slack / Calendar）状态 Connected，且让 Bot 用
@挂着跑通了一次 - 知道公司 Google 账号被拦时，把哪四步转给 IT
- 知道公开 X 内容不用连插件；DM / 书签才需要 X 插件 + X API credits
踩坑提醒
❌ Bot 说「应用缺失」，你干等 Connect 卡
现象：Bot 回复说缺某个应用，你等它弹连接卡片，一直没等到。
原因：官方明确——Bot 只在应用需要你登录时才发 Connect 卡，别干等（"Don't wait for one"）。
正确做法：主动打开 Connect apps，点标题旁的已连接计数，确认插件在 Installed 里；状态是 Needs auth / Disconnected 就点 Authenticate；还不行就 Remove 后重新添加、重新登录（授权在服务商那边被撤销时也会这样）。
❌ 公司 Google 账号连不上：Your admin needs to review Grok
现象：Gmail / Calendar / Drive 授权到一半，Google 页面显示 Your admin needs to review Grok 或 Access blocked。
原因：Grok 还没被你们公司的 Google Workspace 信任。注意：Grok Bot 登录 Google 用的应用名是 Grok，不是 Cursor——这和 Cursor 侧的 Disabled by team admin 是两码事。
正确做法：把下面四步转给 Google 管理员（在 Google Admin console 操作）：
- 打开 Security → Access and data control → API controls
- 打开 App access control → Manage third-party app access
- 添加名为 Grok 的应用（搜不到就用拦截页或审核邮件里的 client ID）
- 把 Grok 对使用 Grok Bot 的人设为 Trusted
页面有 Request access 按钮就先点它，等审核通过后再 Authorize。换浏览器、重试连接不会清除 Google 管理员拦截；还不行就带着 Google 账号邮箱和拦截页截图找支持（support@x.ai）。
❌ Zoom error 4700 / SharePoint AADSTS50011：官方已知问题
现象：Zoom 授权报 error 4700（Invalid redirect）；团队管理员连 SharePoint 时 Microsoft 报 AADSTS50011（redirect URI 不匹配）。
原因：都是官方已知问题。Zoom 4700 目前没有解法，你这边做什么都不会好；SharePoint 报错是管理员用 Application-level permissions 连接触发的，不是你们租户配置的问题。
正确做法：Zoom 只能等官方修复，别浪费时间反复重装。SharePoint 改用 Delegated permissions：在 SharePoint 卡上点 Connect team（或 Reconnect），选 Delegated permissions，输入 Microsoft tenant ID 后登录；多数工作/学校租户还需要 Microsoft 管理员先对 Sites.Read.All 同意一次。更多报错见 R2 报错速查。
❌ X 插件连上了，私有请求还是失败
现象：X 插件显示已连接，但 Bot 读不了你的 DM、书签、时间轴。
原因：X 插件跑在你自己的 X 开发者账号上，需要 X API credits，余额 $0.00 就失败。重连插件、换 Grok Bot / Cursor 计划都不会增加 credits；连接 X 也不一定会自动带上 starter X API credits。
正确做法：打开 console.x.com，用你连接的同一个 X 账号登录，查看 X API credit 余额；显示 $0.00 就在那里充值（credits 向 X 购买），然后回 Grok Bot 重试——不需要重连插件。
进阶技巧（可选）
让 Bot 自己装插件。直接说 "Add the Linear app."——Bot 会搜索目录、把应用装到你的账号上，需要登录时给你一张 Connect 卡；装好后，下一条消息就能用它的工具。Bot 也能添加目录之外的 MCP server：给一个 URL，或给一条在它云电脑上运行的命令（命令启动的 server，你的其他 Bot 也能用）；私有网络或私有 CA 的 server 会先请求你的审批。
公开 X 内容不用连任何插件。搜帖、读账号动态、看提及和引用、统计话题帖子数、查趋势新闻——这些公开内容 Bot 内置就能查，只读、不以你的身份登录。X 插件只为你自己的 DM、书签、时间轴和点赞而设。
删除插件 = 全部重来。让 Bot 帮你移除应用时，它添的东西一并消失、你会被登出——重装就得重新登录；团队强制要求的应用删不掉。
1Password 也在 Connect apps 里。在 Password Managers 分区连接 1Password，Bot 就能用你逐条批准的登录项在云电脑上登录网站，值不会进聊天——详见 5.2 Vault 与安全登录。
手机本机授权是另一回事。手机上 Settings → Connect apps 里的 iPhone / iPad / Android，授权的是你手机本机的日历、通讯录等（见 1.6 手机端），和这一课的云端 Google Calendar 插件不是一回事。
本课小结
✅ Grok Bot 插件（Connect apps）= Bot 和服务之间的结构化通道：有插件用插件、没插件走浏览器；连接属于账号，一次连接全 Bot 共用；OAuth token 存 Cursor connector 后端，Bot 拿不到。
✅ 官方 5 步：打开 Connect apps → 添加应用 → 浏览器里 Authorize / Authenticate（约 10 分钟内）→ 没完成就 Reconnect / Reopen → 在 Installed 下确认。
✅ Added ≠ 已登录：Needs auth / Disconnected → 点 Authenticate；Connected → 发新消息让 Bot 重试；Disabled by team admin → 找 Cursor 团队管理员。
✅ 能力边界以授权账号为上限：Gmail 一次一邮箱；Slack 以你的身份发帖、一个 workspace 一连；Calendar 加不了 Zoom 链接、改不了 Meet 设置；Sheets 的 Viewer 文件只读、找文件靠 Drive 插件。
✅ 公司 Google 被拦是 Google 侧的事（应用名 Grok）：Admin console 四步设 Trusted；换浏览器、重试连接没用。
✅ 任务里用 @ 点名插件；外发邮件和 Slack 消息默认先出草稿卡；Bot 还能代装应用、加 MCP server；公开 X 内容免连接。
关键状态与操作回顾：
| 状态 / 操作 | 含义或场景 | 你要做的 |
|---|---|---|
| Added | 已安装 ≠ 已登录 | 检查是否需要 Authenticate |
| Needs auth / Disconnected | 没登录，或登录断了 | 点 Authenticate（手机：Authorize） |
| Connected | 可用 | 发新消息让 Bot 重试 |
| Disabled by team admin | 被团队策略禁用 | 找 Cursor 团队管理员 |
| Reconnect / Reopen / Retry | 登录页丢了、授权没完成 | 调回登录页或重试 |
| Remove | 授权被撤销、彻底重连 | 删掉重装，重新登录 |
下一课预告
Connect apps 里有个不一样的 Email 应用：它不连接你现有的邮箱，而是给 Bot 认领一个它自己的地址（你的名字@mail.grokbot.com）。下一课 2.6 Bot 专属邮箱。
你会学到：
- 认领 Bot 专属邮箱地址：命名规则与保留字
- 收件怎么触发 routine（新邮件不会自动叫醒 Bot）
- 发送限额：每封最多 50 个收件人、附件怎么算
- 为什么「邮件是信息，不是指令」