SmartTeenAI — OAuth và quyền truy cập MCP

Issuer, khám phá OAuth, phạm vi quyền và các bước cấu hình cần kiểm chứng trước khi kết nối MCP SmartTeenAI.

Resource server và authorization server

SmartTeenAI cung cấp MCP resource tại /mcp. Máy chủ cấp token là Supabase Auth của dự án, không phải tên miền SmartTeenAI. Đọc /.well-known/oauth-protected-resource để lấy authorization_servers. Đường /.well-known/oauth-authorization-server trên SmartTeenAI chuyển hướng tới metadata của issuer thật theo RFC 8414; không phát hành metadata giả mang issuer SmartTeenAI.

Kết nối bằng OAuth

Client MCP phải dùng Authorization Code với PKCE S256, state và redirect URI đã đăng ký với authorization server. Khám phá authorization_endpoint, token_endpoint và jwks_uri từ issuer; kiểm tra issuer khớp chính xác. Token gửi qua Authorization: Bearer tới /mcp, không đưa vào URL. Resource kiểm tra chữ ký, issuer, audience, thời hạn và dấu hiệu token cấp cho OAuth client; token đăng nhập trình duyệt thông thường không thay thế token OAuth.

Scope và giới hạn quyền

Các scope tài nguyên được lấy từ cấu hình server MCP_REQUIRED_SCOPES (cách nhau bằng dấu cách). Cùng danh sách đó được SDK kiểm tra trên token, công bố trong protected-resource metadata và tài liệu OpenAPI. Khi danh sách rỗng, chưa có scope tài nguyên được cấu hình: không được coi là đã hoàn thành phân quyền OAuth theo scope. Supabase openid, email, profile, phone là scope định danh, không phải quyền đọc điểm hoặc bảng dữ liệu. Không khai blog:read nếu issuer chưa thực sự cấp scope đó.

Những việc quản trị viên phải xác nhận

Trước khi công bố OAuth đã hoạt động, cần bật OAuth server trong Supabase, cấu hình trang consent, đăng ký client và redirect URI, dùng khóa ký phù hợp và thử đủ consent, đổi code lấy token, hết hạn, từ chối quyền và scope thiếu. Trang /oauth/consent có sẵn để tích hợp với Supabase; chỉ người dùng được quyền quyết định chấp thuận. Việc có URL metadata hoặc build thành công không chứng minh luồng cấp token đã chạy trên production.

Dữ liệu được phép

Ba tool hiện chỉ truy vấn bài blog đã xuất bản bằng Supabase publishable key. Không có tool đọc hồ sơ học sinh hoặc thay đổi điểm. Quyền RLS và danh sách tool vẫn là ranh giới dữ liệu; việc công khai danh sách tool không bỏ xác thực khi gọi tool. Tài liệu và sandbox không cần tạo tài khoản, không cần API key; khóa Gemini và service-role phải ở server.