自带 AI 智能体(MCP)
将你自己的 AI 智能体——Claude、ChatGPT、Cursor 以及其他兼容 MCP 的客户端——直接连接到你的 CalendarBridge 账户。在你掌控的权限范围内,你的智能体可以代表你读取和管理你的日历、事件、调度器和同步。
自带智能体使用 MCP(模型上下文协议,Model Context Protocol)——一个让 AI 助手连接外部工具的开放标准。CalendarBridge 运行一个托管的 MCP 服务器,因此任何支持 MCP 的客户端都可以连接到你的账户并代你操作日历。
这与 CalendarBridge AI 调度助手不同,后者通过电子邮件进行调度。使用自带智能体时,你自带 AI(你已经在使用并付费的那一个),并将其指向 CalendarBridge。
使用 CalendarBridge MCP 服务器管理你的日历
CalendarBridge MCP 服务器把你的 AI 助手变成一个日历管理器。连接智能体后,你可以用自然语言管理日历——查看日程、创建和重新安排事件、生成预约链接、设置日历同步——覆盖 Google Calendar、Microsoft 365 / Outlook 和 iCloud,全部通过单一的模型上下文协议(MCP)端点完成。
你无需在仪表板中逐项点击,只需告诉智能体你想要什么,它就会使用 CalendarBridge 的 MCP 工具来完成——AI 日历管理,与你已经在用的助手协同工作。
你的智能体能做什么
连接后,你的智能体可以:
- 日历与事件——列出你的日历,读取任意日期范围内的事件,以及创建、编辑或删除事件。
- 调度器——列出、创建、编辑和删除你的调度器。
- 同步——列出、创建、编辑和删除单向或双向日历同步。
- 已连接的账户——列出你已连接的日历账户,并获取连接、重新认证或移除账户的链接。
- AI 助手——列出你的 AI 调度助手配置、查看最近的会话,并通过你的助手发送新消息或回复。
你的智能体所采取的每个操作都受限于你在连接时授予的权限(参见选择权限)。
可用性与套餐
连接智能体在所有套餐(包括基础版)上均可使用——无需购买令牌,也无需复制任何内容。通过你的智能体执行操作(读取或更改日历、创建同步等)则需要有效的 CalendarBridge 订阅。如果你的订阅失效,智能体仍保持连接,但每个操作都会返回一条消息,要求你重新激活。
第 1 步:打开自带智能体(MCP)标签页
在 https://app.calendarbridge.com/login/ 登录,从侧边栏打开 AI Assistant,然后选择自带智能体(MCP)标签页。
第 2 步:复制你的服务器 URL
该标签页会显示你的 CalendarBridge 服务器 URL。它看起来像这样:
https://manageapi.calendarbridge.com/mcp
这个单一 URL 就是你的客户端所需的全部内容。无需复制 API 密钥或令牌——客户端连接时会通过安全的浏览器登录为你登录(参见选择权限)。
第 3 步:将 CalendarBridge 添加到你的客户端
每个客户端添加远程 MCP 服务器的方式略有不同。该标签页包含针对你所选客户端的分步说明;最常见的几种如下所列。在任何需要 URL 的地方,请使用第 2 步中的服务器 URL。
| 客户端 | 如何添加 |
|---|---|
| Claude.ai(网页版) | Settings → Connectors → + → Add custom connector。输入名称并粘贴服务器 URL,然后点击 Add。 |
| Claude Desktop | Settings → Connectors → Add custom connector。输入名称并粘贴服务器 URL。 |
| Claude Code | 运行 claude mcp add calendarbridge --transport http <Server URL>,然后输入 /mcp 并进行认证。 |
| ChatGPT | 启用开发者模式,然后进入 Settings → Connectors,创建一个新的连接器,并粘贴服务器 URL。 |
| Cursor | Settings → Cursor Settings → Tools & MCP,使用服务器 URL 添加一个新的 MCP 服务器,然后点击 Connect。 |
| Codex CLI | 运行 codex mcp add calendarbridge --url <Server URL>,然后输入 /mcp 并选择 calendarbridge。 |
| Grok | 开始一个聊天,点击 + → Add connector → Custom。粘贴服务器 URL 并授权。 |
| Gemini CLI | 运行 gemini mcp add --transport http calendarbridge <Server URL>,然后在 Gemini CLI 检测到 OAuth 服务器时登录(或运行 gemini mcp auth calendarbridge)。 |
| Antigravity IDE | 在智能体面板中:⋯ → MCP Servers → Manage MCP Servers → View raw config。在 mcpServers 下添加一个条目,将 "serverUrl" 设置为服务器 URL(Antigravity 使用 serverUrl,而非 url),保存并刷新。 |
| OpenClaw | 运行 openclaw mcp add calendarbridge --url <Server URL> --transport streamable-http,然后运行 openclaw mcp login calendarbridge 并在浏览器中批准访问。 |
| Hermes | 运行 hermes mcp add calendarbridge(或在 ~/.hermes/config.yaml 的 mcp_servers 下添加该服务器并设置 auth: oauth),然后运行 hermes mcp login calendarbridge 并批准。 |
| 任何其他客户端 | 添加一个自定义或远程 MCP 服务器(有时称为connector、integration 或 tool server):粘贴服务器 URL,如有提示则选择 HTTP / streamable HTTP 传输方式,并为认证选择 OAuth / Sign in——无需输入 API 密钥、客户端 ID 或密钥。 |
无论你如何添加,流程都是一样的——粘贴服务器 URL,在浏览器中登录 CalendarBridge,然后选择允许哪些操作。
第 4 步:登录并选择权限
你的客户端首次连接时,会在浏览器中打开一个 CalendarBridge 登录页面。登录后,你会看到一个授权确认界面,列出智能体请求的权限。只勾选你想要授予的项,然后点击允许。
| 权限 | 它允许什么 |
|---|---|
| 读取你的日历事件 | 列出你的日历并读取事件。 |
| 创建和修改日历事件 | 创建、编辑和删除事件。 |
| 读取 / 修改你的调度器 | 列出、创建、编辑和删除调度器。 |
| 读取 / 修改你的日历同步 | 列出、创建、编辑和删除同步。 |
| 读取你已连接的账户 | 列出账户并获取连接 / 重新认证 / 移除链接。 |
| 读取你的助手 | 列出助手配置和会话。 |
| 通过你的助手发送 | 通过你的 AI 调度助手发送新消息和回复。 |
权限在每次请求时都会强制执行:智能体只能使用你允许的工具。你可以连接多个智能体,并为每个智能体授予不同的权限集。
第 5 步:试试看
连接后,可以向你的智能体提出这样的请求:
- “我这周的日历上有什么安排?”
- “明天下午 2 点安排一个名为 Design review 的 1 小时会议,并邀请 alex@example.com。”
- “把我今天下午 3 点的会议改到 4 点。”
- “创建一个 30 分钟、在工作日下午可预约的调度器,并把链接给我。”
- “设置一个从我的工作日历到个人日历的单向同步,把事件显示为忙碌。”
- “列出我已连接的账户,并告诉我是否有任何账户需要重新认证。”
与你的 AI 调度助手协作
如果你已经设置了 CalendarBridge AI 调度助手,你已连接的智能体可以代你驱动它——或是发起一封新的调度邮件,或是在现有会话中回复。
- 发起新请求——例如“让我的助手找一个下周与 alex@example.com 的 30 分钟时段。”你的智能体会通过你的助手发送邮件,然后由助手接手处理。
- 回复会话——例如“回复我最近的助手会话,并提议周四上午 10 点。”你的智能体会调取该邮件线程,推断收件人和主题,并发送你的回复。
该助手以异步方式工作,就像通过电子邮件一样:发送一条消息会将其交接出去,助手的回复会稍后到达。让你的智能体再次查看你的会话以查看回复。
这需要为你已连接的某个电子邮件账户配置助手,并具备通过你的助手发送权限。如果你在该权限出现之前就连接了智能体,请重新连接并在授权确认界面上授予该权限。
管理已连接的智能体
标签页的已连接的智能体部分列出了每个已连接的智能体、它被授予的权限以及上次使用时间。要断开某个智能体,点击撤销——它会立即失去访问权限。从客户端重新连接时会再次提示登录和授权权限。
安全与隐私
- 连接使用标准的 OAuth 2.1 登录流程并配合 PKCE——没有需要复制、泄露或粘贴到配置文件中的长期密钥。
- 每个连接都限定在你授予的权限范围内,并且可随时从已连接的智能体列表中撤销。
- 你的智能体仅在这些权限范围内以你的身份行事。它无法看到其他 CalendarBridge 账户。
疑难解答
- “订阅未激活”——连接是免费的,但执行操作需要有效的订阅。在 app.calendarbridge.com 重新激活后再试。参见我的账户已付费但未激活。
- 智能体找不到要编辑的事件——先让它列出事件,然后对该列表中的某个事件进行操作。
- 某个日历账户需要重新认证——你的智能体可以返回一个链接,或参见重新授权日历访问。
- 客户端无法连接——确保你完全按照标签页上显示的内容粘贴了完整的服务器 URL,包括
https://。