Hướng dẫn thêm MCP vào Loa AI — ví dụ kết nối Notion qua External MCP

External MCP trên Loa AI là gì?

MCP (Model Context Protocol) là giao thức giúp AI gọi công cụ bên ngoài — ghi chú, tìm kiếm, điều khiển thiết bị, v.v. Trên Loa AI, tính năng External MCP cho phép bạn kết nối MCP server trên cloud (Notion, dịch vụ OAuth…) trực tiếp từ Bảng điều khiển, không cần cài script trên máy tính.

Sau khi cấu hình, bạn có thể nói chuyện với loa để AI tự gọi tool — ví dụ ghi todo vào Notion, đọc lại ghi chú hôm qua, tạo trang mới trong workspace.

Trước khi bắt đầu

• Có tài khoản Loa AI và đã đăng nhập
• Thiết bị Loa AI đã kết nối Wi-Fi và online
• Tính năng External MCP thuộc gói VIP (hiển thị trên dashboard)
• Tài khoản Notion nếu làm ví dụ trong bài

Mỗi tài khoản thêm tối đa 5 MCP server. Hỗ trợ xác thực Token hoặc OAuth (server lưu refresh token; thiết bị ESP32 chỉ nhận access token).

Bước 1 — Vào Bảng điều khiển

Đăng nhập Loa AI → menu bên trái → chọn Bảng điều khiển.

Link trực tiếp: loaai.me/quan-ly/bang-dieu-khien

Bước 2 — Mở cài đặt External MCP

Trên dashboard, tìm thẻ External MCP (góc có nhãn VIP) → bấm Cài đặt.

Thẻ mô tả: Kết nối MCP server bên ngoài qua URL và token.

Bước 3 — Bật MCP và thêm server mới

1. Bật công tắc Kích hoạt External MCP
2. Bấm + Thêm MCP trong mục Danh sách MCP server

Ô Ghi chú cho AI rất quan trọng — mô tả ngắn giúp AI biết khi nào nên gọi server này (ví dụ: dùng Notion để ghi chú hằng ngày).

Bước 4 — Cấu hình Notion MCP (ví dụ)

Điền các trường như sau:

Trường	Giá trị gợi ý
Tên server	Notion ghi chú (tên AI dùng khi gọi tool)
Ghi chú cho AI	Sử dụng Notion để ghi lại những ghi chú hằng ngày
URL MCP Server	https://mcp.notion.com/mcp
Loại xác thực	OAuth

Với Notion MCP, Client ID / Client Secret thường để trống — bật Tự discovery từ MCP URL để hệ thống lấy Authorize/Token URL từ metadata.

Bước 5 — Kết nối OAuth

Sau khi nhập URL, bấm Kết nối OAuth. Trình duyệt mở popup đăng nhập — trang quản lý Loa AI không bị chuyển hướng.

Trong hộp vàng, hệ thống hiển thị Redirect URI (dạng https://loaai.me/api/quan-ly-thiet-bi/.../external-mcp/oauth/callback). URI này dùng khi Notion hỏi xác nhận — bạn không cần tự tạo app Notion riêng cho flow chuẩn.

Bước 6 — Xác nhận trên Notion

Trang Notion hiện Connect with Notion MCP → chọn workspace → đọc quyền truy cập → tick I recognize and trust this URL (URL callback của loaai.me) → bấm Continue.

Bước 7 — Lưu và khởi động lại loa

Quay lại popup Loa AI, trạng thái OAuth chuyển Đã kết nối (có thể bấm Làm mới token hoặc Kết nối lại nếu cần).

1. Bấm Lưu Cài Đặt (nút xanh)
2. Khởi động lại Loa AI (tắt nguồn/bấm reset hoặc reboot trong cài đặt thiết bị) để loa tải cấu hình MCP mới

Sau reboot, AI sẽ discovery tool từ Notion MCP và có thể gọi khi bạn nói các câu liên quan ghi chú.

Video hướng dẫn chi tiết

Xem clip từng bước cấu hình External MCP và kết nối Notion trên Loa AI:

https://www.youtube.com/watch?v=rfMTksJ_25s

Ví dụ câu nói với loa

• "Ghi vào Notion: hôm nay mình hoàn thành bài MCP"
• "Tạo ghi chú trên Notion — cuộc họp 9h sáng mai"
• "Đọc lại ghi chú hôm qua trên Notion"

AI chọn server Notion ghi chú dựa trên tên và phần ghi chú bạn đã điền ở bước 4.

Thêm MCP khác ngoài Notion

Quy trình tương tự: Thêm MCP → điền URL server + ghi chú rõ ràng → OAuth hoặc Token → Lưu → reboot loa. Một số dịch vụ cần Client ID/Secret — điền theo tài liệu nhà cung cấp MCP.

Dev tự host MCP trên máy tính (calculator, GPIO…): xem thêm cấu hình MCP endpoint truyền thống cho firmware Xiaozhi DIY.

Lỗi thường gặp

• Loa không gọi Notion — chưa reboot sau khi Lưu; kiểm tra VIP External MCP đã kích hoạt
• OAuth thất bại — popup bị chặn; thử trình duyệt khác; bấm Kết nối lại
• AI không hiểu khi nào dùng Notion — sửa Ghi chú cho AI mô tả cụ thể hơn
• Token hết hạn — bấm Làm mới token trong cài đặt MCP

Tóm tắt

Thêm MCP vào Loa AI: Bảng điều khiển → External MCP → bật → Thêm MCP → điền URL + ghi chú → OAuth → Lưu → khởi động lại loa. Ví dụ Notion: URL https://mcp.notion.com/mcp, OAuth, ghi chú giúp AI biết dùng Notion cho ghi chú hằng ngày.