Kết nối AI agent bằng MCP và OAuth

Kết nối AI agent bằng MCP và OAuth

Máy chủ MCP của Metricgram cho phép các client AI như Claude, ChatGPT, Cursor hoặc Claude Code làm việc với các nhóm Telegram của bạn: đọc số liệu phân tích và thành viên, đăng tin nhắn, kiểm duyệt và quản lý chủ đề. Với OAuth, bạn không cần sao chép khóa nào. Bạn chỉ cần dán một URL, đăng nhập vào Metricgram và phê duyệt quyền truy cập.

Máy chủ MCP có trong mọi gói trả phí và trong 14 ngày dùng thử miễn phí.

1. Sao chép URL máy chủ

Mở Tích hợp > MCP trong bảng quản lý và sao chép URL trong ô Kết nối bằng OAuth:

https://metricgram.com/api/v1/mcp

2. Thêm URL vào client AI

• Claude: vào Settings > Connectors > Add custom connector (Cài đặt > Trình kết nối > Thêm trình kết nối tùy chỉnh), dán URL và lưu.
• Claude Code: chạy claude mcp add --transport http metricgram https://metricgram.com/api/v1/mcp, sau đó gõ /mcp để đăng nhập.
• ChatGPT, Cursor và các client khác: thêm một máy chủ MCP mới (một số client gọi là trình kết nối) với cùng URL và chọn OAuth nếu client hỏi phương thức xác thực.

3. Đăng nhập và phê duyệt quyền truy cập

Client sẽ mở một trang Metricgram trong trình duyệt. Đăng nhập nếu cần, kiểm tra tên ứng dụng và các quyền của nó, rồi nhấp Cho phép. Bạn sẽ được đưa trở lại client và kết nối đã sẵn sàng.

Trang này hiển thị:

• Ứng dụng đang yêu cầu quyền truy cập và địa chỉ bạn sẽ được đưa trở lại.
• Những gì ứng dụng có thể làm: Đọc nhóm, thành viên, tin nhắn, số liệu phân tích và cài đặt của bạn, và Ghi, nghĩa là thao tác trong nhóm của bạn bằng cách đăng tin, kiểm duyệt hoặc thay đổi cài đặt.
• Cảnh báo khi Metricgram chưa xác minh ứng dụng. Chỉ tiếp tục nếu chính bạn đã bắt đầu kết nối.

4. Dùng thử

Hãy hỏi agent của bạn những câu như "Tóm tắt hoạt động tuần này trong nhóm của tôi" hoặc "Những thành viên nào không viết gì trong 30 ngày qua?".

Quản lý ứng dụng đã kết nối

Mỗi ứng dụng bạn phê duyệt sẽ xuất hiện trong mục Ứng dụng đã kết nối trên trang MCP, kèm theo các quyền và ngày bạn kết nối. Nhấp Ngắt kết nối để thu hồi quyền truy cập ngay lập tức.

OAuth hay khóa API?

Hãy dùng OAuth bất cứ khi nào client hỗ trợ: không có bí mật nào phải lưu trữ và bạn có thể ngắt kết nối ứng dụng bất cứ lúc nào. Với các client không hỗ trợ OAuth, hãy tạo khóa API trong Tích hợp > API và dùng các ví dụ cấu hình trên trang MCP. Bài viết Truy cập API & MCP giải thích cách hoạt động của khóa và phạm vi quyền.

Khắc phục sự cố

• "Tài khoản của bạn cần có gói Metricgram đang hoạt động để kết nối AI agent qua MCP.": MCP yêu cầu một gói đang hoạt động hoặc thời gian dùng thử miễn phí.
• "Yêu cầu kết nối này không hợp lệ": yêu cầu đã hết hạn hoặc đã bị thay đổi. Hãy bắt đầu kết nối lại từ client AI của bạn.
• Agent không thấy một nhóm: quyền truy cập chỉ giới hạn trong các nhóm Telegram bạn quản lý trên Metricgram. Kiểm tra xem nhóm đã được kết nối chưa và bot có còn là quản trị viên không.
• Agent không thể đăng tin hoặc kiểm duyệt: kết nối chỉ có quyền đọc. Hãy ngắt kết nối và kết nối lại từ một client có yêu cầu quyền ghi.