CalendarBridge MCP

Kết nối agent AI của riêng bạn — Claude, ChatGPT, Cursor và các client tương thích MCP khác — trực tiếp với tài khoản CalendarBridge của bạn. Agent của bạn có thể đọc và quản lý lịch, sự kiện, bộ lập lịch và đồng bộ hóa thay cho bạn, với các quyền bạn kiểm soát.

Bring Your Own Agent sử dụng MCP (Giao thức Ngữ cảnh Mô hình) — một tiêu chuẩn mở cho phép trợ lý AI kết nối với các công cụ bên ngoài. CalendarBridge chạy một máy chủ MCP được lưu trữ, vì vậy bất kỳ client nào hỗ trợ MCP đều có thể kết nối với tài khoản của bạn và thao tác trên lịch của bạn thay cho bạn.

Điều này khác với Trợ lý Lập lịch AI của CalendarBridge, vốn lập lịch qua email. Với Bring Your Own Agent, bạn mang đến AI (cái bạn đã dùng và trả phí) và trỏ nó vào CalendarBridge.

Quản lý lịch của bạn bằng máy chủ MCP CalendarBridge

Ủy quyền cho một agent bên ngoài (MCP)

Máy chủ MCP CalendarBridge biến trợ lý AI của bạn thành một trình quản lý lịch. Sau khi kết nối một agent, bạn có thể quản lý lịch của mình bằng ngôn ngữ tự nhiên — kiểm tra lịch trình, tạo và dời lịch sự kiện, tạo liên kết đặt lịch và thiết lập đồng bộ hóa lịch — trên Google Calendar, Microsoft 365 / Outlook và iCloud, tất cả thông qua một điểm cuối Giao thức Ngữ cảnh Mô hình (MCP) duy nhất.

Thay vì nhấp qua bảng điều khiển, bạn nói cho agent biết bạn muốn gì và nó dùng các công cụ MCP của CalendarBridge để thực hiện — quản lý lịch bằng AI hoạt động cùng trợ lý bạn đã dùng.

Những gì agent của bạn có thể làm

Sau khi kết nối, agent của bạn có thể:

• Lịch & sự kiện — liệt kê lịch của bạn, đọc sự kiện trong bất kỳ khoảng thời gian nào, đồng thời tạo, chỉnh sửa hoặc xóa sự kiện.
• Bộ lập lịch — liệt kê, tạo, chỉnh sửa và xóa bộ lập lịch của bạn.
• Đồng bộ hóa — liệt kê, tạo, chỉnh sửa và xóa đồng bộ hóa lịch một chiều hoặc hai chiều.
• Tài khoản đã kết nối — liệt kê các tài khoản lịch đã kết nối của bạn và lấy liên kết để kết nối, xác thực lại hoặc gỡ tài khoản.
• Trợ lý AI — liệt kê cấu hình Trợ lý Lập lịch AI của bạn, xem lại các cuộc trò chuyện gần đây và gửi tin nhắn mới hoặc trả lời qua trợ lý của bạn.

Mỗi hành động agent của bạn thực hiện đều bị giới hạn trong các quyền bạn cấp khi kết nối (xem Chọn quyền).

Khả dụng & gói

info

Kết nối một agent khả dụng trên mọi gói, bao gồm cả Basic — không có token nào để mua và không có gì để sao chép. Thực hiện hành động qua agent của bạn (đọc hoặc thay đổi lịch, tạo đồng bộ hóa, v.v.) yêu cầu đăng ký CalendarBridge đang hoạt động. Nếu đăng ký của bạn hết hạn, agent của bạn vẫn kết nối nhưng mỗi hành động sẽ trả về một thông báo yêu cầu bạn kích hoạt lại.

Bước 1: Mở tab Bring Your Own Agent (MCP)

Đăng nhập tại https://app.calendarbridge.com/login/, mở AI Assistant từ thanh bên và chọn tab Bring Your Own Agent (MCP).

Bước 2: Sao chép URL máy chủ của bạn

Tab hiển thị Server URL của CalendarBridge của bạn. Nó trông giống như:

https://manageapi.calendarbridge.com/mcp

URL duy nhất này là tất cả những gì client của bạn cần. Không có khóa API hoặc token nào để sao chép — client của bạn đăng nhập cho bạn bằng cách đăng nhập trình duyệt an toàn khi kết nối (xem Chọn quyền).

Bước 3: Thêm CalendarBridge vào client của bạn

Mỗi client thêm máy chủ MCP từ xa một cách hơi khác nhau. Tab bao gồm hướng dẫn từng bước cho client bạn chọn; những cái phổ biến nhất được liệt kê bên dưới. Dùng Server URL từ Bước 2 ở bất cứ nơi nào cần URL. Tên client liên kết đến tài liệu chính thức của từng nền tảng.

Client	Cách thêm
Claude.ai (web)	Settings → Connectors → dấu + → Add custom connector. Nhập tên và dán Server URL, sau đó nhấp Add.
Claude Desktop	Settings → Connectors → Add custom connector. Nhập tên và dán Server URL.
Claude Code	Chạy claude mcp add calendarbridge --transport http <Server URL>, sau đó gõ /mcp và xác thực.
ChatGPT	Bật Developer Mode, sau đó Settings → Plugins, tạo plugin mới và dán Server URL.
Cursor	Settings → Cursor Settings → Tools & MCP, thêm máy chủ MCP mới với Server URL, sau đó nhấp Connect.
Codex CLI	Chạy codex mcp add calendarbridge --url <Server URL>, sau đó gõ /mcp và chọn calendarbridge.
Grok	Bắt đầu cuộc trò chuyện và nhấp + → Add connector → Custom. Dán Server URL và ủy quyền.
Manus	Settings → Connectors → Add connectors → tab Custom MCP → Add custom MCP → Direct configuration. Nhập tên, giữ loại truyền tải là HTTP, dán Server URL và nhấp Save, sau đó phê duyệt quyền truy cập trong trình duyệt.
Gemini CLI	Chạy gemini mcp add --transport http calendarbridge <Server URL>, sau đó đăng nhập khi Gemini CLI phát hiện máy chủ OAuth (hoặc chạy gemini mcp auth calendarbridge).
Antigravity IDE	Trong bảng agent: ⋯ → MCP Servers → Manage MCP Servers → View raw config. Thêm một mục dưới mcpServers với "serverUrl" được đặt thành Server URL (Antigravity dùng serverUrl, không phải url), lưu và làm mới.
OpenClaw	Chạy openclaw mcp add calendarbridge --url <Server URL> --transport streamable-http, sau đó openclaw mcp login calendarbridge và phê duyệt quyền truy cập trong trình duyệt.
Hermes	Chạy hermes mcp add calendarbridge (hoặc thêm máy chủ dưới mcp_servers trong ~/.hermes/config.yaml với auth: oauth), sau đó hermes mcp login calendarbridge và phê duyệt.
Bất kỳ client nào khác	Thêm máy chủ MCP tùy chỉnh hoặc từ xa (đôi khi gọi là connector, integration hoặc tool server): dán Server URL, chọn loại truyền tải HTTP / streamable HTTP nếu được hỏi và chọn OAuth / Sign in để xác thực — không có khóa API, client ID hoặc secret nào để nhập.

Dù bạn thêm theo cách nào, quy trình đều giống nhau — dán Server URL, đăng nhập vào CalendarBridge trong trình duyệt và chọn những gì bạn cho phép.

Bước 4: Đăng nhập và chọn quyền

Lần đầu client của bạn kết nối, nó mở trang đăng nhập CalendarBridge trong trình duyệt của bạn. Sau khi bạn đăng nhập, bạn sẽ thấy màn hình đồng ý liệt kê các quyền mà agent đang yêu cầu. Chỉ chọn những quyền bạn muốn cấp, sau đó nhấp Allow.

Quyền	Nó cho phép gì
Đọc sự kiện lịch của bạn	Liệt kê lịch của bạn và đọc sự kiện trên đó.
Tạo, chỉnh sửa và xóa sự kiện lịch	Tạo, chỉnh sửa và xóa sự kiện trên lịch của bạn.
Đọc tài khoản đã kết nối của bạn	Liệt kê các tài khoản lịch đã kết nối của bạn.
Kết nối và gỡ tài khoản	Lấy liên kết để kết nối hoặc xác thực lại tài khoản và gỡ các tài khoản đã kết nối.
Đọc bộ lập lịch của bạn	Liệt kê các bộ lập lịch của bạn.
Tạo, chỉnh sửa và xóa bộ lập lịch	Tạo, chỉnh sửa và xóa các bộ lập lịch của bạn.
Đọc đồng bộ hóa lịch của bạn	Liệt kê các đồng bộ hóa lịch của bạn.
Tạo, chỉnh sửa và xóa đồng bộ hóa lịch	Tạo, chỉnh sửa và xóa các đồng bộ hóa lịch của bạn.
Đọc trợ lý của bạn	Liệt kê cấu hình trợ lý và cuộc trò chuyện của bạn.
Tạo và sửa đổi trợ lý	Tạo, chỉnh sửa và xóa cấu hình trợ lý của bạn.
Gửi tin nhắn qua trợ lý của bạn	Cho phép agent gửi tin nhắn mới và trả lời qua trợ lý lập lịch AI của bạn.

verified_user

Quyền được thực thi trên mọi yêu cầu: một agent chỉ có thể dùng các công cụ bạn đã cho phép. Bạn có thể kết nối nhiều hơn một agent và cấp cho mỗi agent một bộ quyền khác nhau.

Bước 5: Thử nghiệm

Sau khi kết nối, hãy hỏi agent của bạn những điều như:

• "Lịch của tôi tuần này có gì?"
• "Lên lịch một cuộc họp 1 giờ tên Design review vào ngày mai lúc 2 giờ chiều và mời alex@example.com."
• "Dời cuộc họp 3 giờ chiều hôm nay của tôi lên 4 giờ chiều."
• "Tạo một bộ lập lịch 30 phút khả dụng vào các buổi chiều trong tuần và đưa tôi liên kết."
• "Thiết lập đồng bộ hóa một chiều từ lịch công việc sang lịch cá nhân của tôi, hiển thị sự kiện dưới dạng bận."
• "Liệt kê các tài khoản đã kết nối của tôi và cho tôi biết tài khoản nào cần xác thực lại."

Làm việc với Trợ lý Lập lịch AI của bạn

Nếu bạn đã thiết lập Trợ lý Lập lịch AI của CalendarBridge, agent đã kết nối của bạn có thể điều khiển nó thay cho bạn — bắt đầu một email lập lịch mới hoặc trả lời trong một cuộc trò chuyện hiện có.

• Bắt đầu một yêu cầu mới — ví dụ: "Hỏi trợ lý của tôi tìm một khung giờ 30 phút với alex@example.com vào tuần tới." Agent của bạn gửi email qua trợ lý của bạn, trợ lý sẽ tiếp tục xử lý từ đó.
• Trả lời một cuộc trò chuyện — ví dụ: "Trả lời cuộc trò chuyện trợ lý mới nhất của tôi và đề xuất thứ Năm lúc 10 giờ sáng." Agent của bạn kéo chuỗi hội thoại, suy ra người nhận và chủ đề, rồi gửi câu trả lời của bạn. schedule

Trợ lý hoạt động không đồng bộ, giống như qua email: gửi một tin nhắn sẽ bàn giao nó, và câu trả lời của trợ lý đến một chút sau đó. Hãy yêu cầu agent của bạn kiểm tra lại các cuộc trò chuyện của bạn để xem phản hồi.

Điều này cần một trợ lý được cấu hình cho một trong các tài khoản email đã kết nối của bạn và quyền Gửi tin nhắn qua trợ lý của bạn. Nếu bạn kết nối agent trước khi quyền này tồn tại, hãy kết nối lại và cấp quyền trên màn hình đồng ý.

Quản lý các agent đã kết nối

Phần Connected agents của tab liệt kê mọi agent đã kết nối, các quyền nó được cấp và lần sử dụng cuối. Để ngắt kết nối một agent, nhấp Revoke — nó mất quyền truy cập ngay lập tức. Kết nối lại từ client sẽ nhắc đăng nhập và chọn quyền lần nữa.

Khắc phục sự cố

• "Subscription is not active" — kết nối miễn phí, nhưng thực hiện hành động yêu cầu đăng ký đang hoạt động. Kích hoạt lại tại app.calendarbridge.com và thử lại. Xem Tài khoản của tôi đã trả phí nhưng không hoạt động.
• Agent không tìm thấy sự kiện để chỉnh sửa — hãy yêu cầu nó liệt kê sự kiện trước, sau đó thao tác trên một sự kiện từ danh sách đó.
• Một tài khoản lịch cần xác thực lại — agent của bạn có thể trả về một liên kết, hoặc xem Cấp lại quyền truy cập lịch.
• Client không kết nối được — đảm bảo bạn đã dán đầy đủ Server URL chính xác như hiển thị trên tab, bao gồm cả https://.