MCP Actions

MCP (Model Context Protocol) là tiêu chuẩn mở cho phép AI trực tiếp dùng công cụ của dịch vụ khác. Thay vì tự mô tả endpoint và tham số, máy chủ MCP công bố công cụ để AI Agent khám phá và sử dụng.

Phần lớn dịch vụ chỉ cần một nhấp để kết nối. Vào Actions và MCPs, nhấp + Thêm Action, chọn MCP.

Kiểm tra kết nối MCP mẫu tới tài liệu Cloudflare hoặc endpoint Microsoft Learn. Phép kiểm tra chỉ khởi tạo và lấy danh sách công cụ, không đăng nhập hoặc thực thi công cụ.

Công cụ thiết lập tùy chọn

• Xem trước ánh xạ bộ nhớ MCP. Áp dụng quy tắc bộ nhớ được cung cấp lên kết quả công cụ mẫu mà không gọi công cụ hay đổi bộ nhớ đối thoại.

• So sánh danh sách công cụ MCP. So sánh hai danh sách và cài đặt kích hoạt khai báo để tìm thay đổi định nghĩa và điểm cần xem xét. Không kết nối máy chủ hay chứng minh tương thích.

• Kiểm tra hướng kết nối MCP. Soạn chi tiết thiết lập từ endpoint công khai và mục đích chọn. Không nhận thông tin xác thực, kết nối máy chủ hoặc đổi tài khoản.

Kết nối từ danh mục

Màn hình MCP mở danh mục dịch vụ phổ biến có thể tìm kiếm, chia theo nhóm (Phổ biến, Hỗ trợ khách hàng, CRM và bán hàng, Lên lịch, Thương mại điện tử, Thanh toán và lập hóa đơn, Tiếp thị và email, Giao tiếp, Năng suất, Dữ liệu và phân tích, Tìm kiếm và web, Du lịch và đặt chỗ, Thiết kế, Phát triển và hạ tầng).

1. Duyệt hoặc tìm dịch vụ cần dùng.
2. Nhấp ô dịch vụ. Quickchat kiểm tra máy chủ và khám phá công cụ.
3. Nếu cần đăng nhập, bảng Cần ủy quyền xuất hiện. Nhấp Kết nối với <service>, chấp thuận trong cửa sổ bật lên và bảng đổi sang đã kết nối.
4. Action được tạo, bật và liệt kê công cụ. AI Agent dùng được từ tin nhắn tiếp theo.

Ghi chú

Sau khi bắt đầu ủy quyền, Quickchat giữ Action và ủy quyền đang chờ nếu bạn đóng bảng Actions hoặc cửa sổ. Mở lại Action, nhấp Mở lại ủy quyền để tiếp tục hoặc Hủy để dừng. Nếu nhà cung cấp hoàn tất sau khi đóng bảng, Quickchat kết nối trong nền và bật Action khi gói còn chỗ.

Mẹo

Trình duyệt phải cho phép cửa sổ bật lên của bảng điều khiển Quickchat, nếu không cửa sổ ủy quyền không mở được. Khi bị chặn, bạn sẽ thấy thông báo yêu cầu cho phép rồi thử lại.

Kết nối máy chủ không có trong danh mục

Nhấp Nhập URL thủ công dưới danh mục, rồi:

1. Dán URL máy chủ MCP (phải bắt đầu https://).
2. Nếu máy chủ xác thực bằng token tĩnh thay vì đăng nhập, mở Header kết nối (không bắt buộc) và thêm header yêu cầu, ví dụ Authorization: Bearer <your-token>.
3. Nhấp Kết nối.

Dùng Xem danh mục để quay lại các ô. Nếu thiếu dịch vụ, Thiếu tích hợp? Đề xuất một tích hợp mở email điền sẵn gửi nhóm chúng tôi.

Chọn công cụ AI được dùng

Sau kết nối, Action liệt kê mọi công cụ máy chủ cung cấp, mỗi công cụ có công tắc. Tắt những gì không muốn AI gọi; chẳng hạn giữ tra cứu chỉ đọc của máy chủ đặt chỗ nhưng tắt hủy đặt chỗ.

Kích hoạt công cụ mặc định quyết định khi máy chủ thêm công cụ mới: bật thì dùng ngay; tắt thì bạn chủ động bật từng công cụ.

Một số mục có nhãn Được Quickchat tinh chỉnh. Quickchat đã kiểm thử toàn trình và cung cấp lựa chọn công cụ tập trung, quy tắc bộ nhớ cần thiết, Thông báo đang xử lý cho từng công cụ. Chọn Dùng đề xuất để xem thay đổi: hộp thoại Áp dụng thiết lập đề xuất? liệt kê công cụ bật/tắt, quy tắc bộ nhớ và cảnh báo nếu ghi đè quy tắc tự sửa. Không lưu gì cho đến khi lưu Action; sau đó vẫn chỉnh được từng công cụ.

Mẹo

Tên Action MCP và Mô tả Action MCP là nhãn cho bạn và nhóm để nhận diện trong danh sách; AI không đọc chúng. Thứ hướng dẫn AI là mô tả công cụ do máy chủ công bố cùng Prompt chính. Hãy nêu tình huống nên dùng công cụ (“trả lời mọi câu hỏi dự án bằng Linear”) và cố định giá trị mô hình sẽ phải đoán (“luôn tìm workspace acme-eng”). Khi kết nối cùng máy chủ hai lần, đặt tên theo việc làm (“Trung tâm trợ giúp Notion”, “Yêu cầu hỗ trợ Notion”) thay vì tên nhà cung cấp.

Đặt lịch với Calendly

Khi một Action kết nối máy chủ https://mcp.calendly.com và bật cả hai công cụ dưới, Quickchat cung cấp đầu vào giờ địa phương. Tên giữ nguyên và không thêm công cụ chuyển đổi. Nếu chỉ bật một công cụ, nó giữ đầu vào gốc Calendly.

• Lịch trống: event_types-list_event_type_available_times nhận local_start_time, local_end_time và IANA timezone, như Europe/London. Cung cấp ngày giờ địa phương theo YYYY-MM-DDTHH:MM:SS. Quickchat chuyển khoảng sang UTC theo quy tắc múi giờ đúng ngày, gồm ngày đổi giờ dài 23 hoặc 25 tiếng.
• Đặt lịch: meetings-create_invitee nhận local_start_time, booking_timezone của lựa chọn trong post_invitee_request. invitee.timezone vẫn là múi giờ khách, có thể khác múi giờ hẹn. Ví dụ người tại America/New_York đặt khung giờ biểu diễn bằng Europe/London.

Sao chép giờ địa phương và múi giờ trả về cùng lựa chọn. Nếu có độ lệch UTC, giữ nguyên vì nó phân biệt giờ lặp khi lùi đồng hồ. Giờ không hợp lệ/không tồn tại, giờ mơ hồ không có độ lệch và độ lệch không khớp múi giờ đều bị từ chối.

Đề xuất khung giờ chưa giữ chỗ. Trước khi tạo hẹn, Quickchat kiểm tra lịch trống lại và truyền nguyên dấu thời gian nhà cung cấp tương ứng tới Calendly. Nếu hết chỗ, không thử đặt. Kết quả có giờ địa phương để Agent xác nhận; các trường dùng cho Lưu vào bộ nhớ, như $.resource.event, vẫn khả dụng.

Giữ yêu cầu khách chấp thuận trong Prompt chính và chỉ xác nhận sau kết quả thành công từ nhà cung cấp. Làm rõ múi giờ hẹn trong đối thoại bất kể trình duyệt hay kênh. Nếu chưa rõ, hỏi khách trước khi kiểm tra hoặc đặt.

Lưu kết quả công cụ MCP vào bộ nhớ

Mở rộng công cụ, dùng Lưu vào bộ nhớ khi cần giá trị kết quả ở lượt sau. Thêm biểu thức JSONPath lấy giá trị và Khóa bộ nhớ để nhận diện. Một công cụ lưu tối đa 10 giá trị.

Khóa bộ nhớ dùng chung với API Actions. Nếu API Action đã lưu cùng khóa, trường Khóa bộ nhớ báo xung đột lúc lưu; hãy chọn khóa khác.

Giá trị đã lưu trở thành dữ liệu AI đọc ở lượt sau. Ví dụ công cụ đặt lịch lưu URI sự kiện để công cụ hủy biết đúng cuộc hẹn. Công cụ MCP không dùng placeholder {{metadata_<key>}} của API Actions vì AI cung cấp trực tiếp đối số.

Thao tác hàng loạt Bật tất cả, Tắt tất cả giữ nguyên quy tắc bộ nhớ. Kết nối lại cũng giữ lựa chọn công cụ và quy tắc khi làm mới danh sách máy chủ.

Khách nhìn thấy gì

Trong lúc công cụ chạy, widget hiển thị trạng thái ngắn mô tả AI đang làm gì. Mỗi công cụ có trường Thông báo đang xử lý trong bảng Công cụ: để trống để suy ra từ tên (công cụ search_flights hiện “Đang tìm chuyến bay…”), hoặc tự viết (“Đang tìm trung tâm trợ giúp”). Máy chủ tinh chỉnh đã điền sẵn cho công cụ đề xuất. Dòng này cho khách thông tin hữu ích lúc chờ thay vì chỉ chỉ báo đang nhập.

Kết nối lại và ngắt kết nối

• Kết nối lại: chạy lại ủy quyền. Dùng khi hết hạn, muốn cấp quyền tài khoản khác hoặc danh sách công cụ thay đổi và cần lấy công cụ mới.
• Ngắt kết nối: thu hồi ủy quyền lưu và đưa Action ngoại tuyến. Action vẫn trong danh sách để kết nối lại sau mà không thiết lập lại.

Đổi URL máy chủ MCP của Action đã kết nối sẽ xóa ủy quyền và tắt Action vì thông tin xác thực của máy chủ này không dùng lại cho máy chủ khác. Cấp quyền lại để hoạt động.

Xử lý sự cố

Bạn thấy gì	Ý nghĩa
Ủy quyền chưa hoàn tất	Nhấp Thử lại. Nếu đã từ chối, chấp thuận ở lần sau. Với lỗi khác, liên hệ hỗ trợ và gửi mã lỗi hiển thị.
Đã kết nối nhưng tải công cụ thất bại	Ủy quyền thành công nhưng danh sách chưa tải. Nhấp Kết nối lại.
Không tìm thấy công cụ trên máy chủ này. Thử kết nối lại.	Máy chủ đã ủy quyền nhưng không công bố công cụ. Kiểm tra tài khoản được cấp quyền có truy cập dữ liệu mong đợi.
Nhập URL hợp lệ bắt đầu bằng https://	Không đọc được URL. Dùng địa chỉ https:// đầy đủ. Quickchat luôn kết nối qua https nên không gửi thông tin xác thực không mã hóa.
Action tự tắt	Ủy quyền hết hạn hoặc bị thu hồi phía nhà cung cấp. Mở Action, nhấp Kết nối lại.

Ghi chú

MCP Actions tính vào hạn mức Actions tùy chỉnh của gói giống API Actions.