/mcp yêu cầu một access_token Supabase được truyền dưới dạng một mã thông báo Bearer. Hầu hết các máy khách MCP lấy điều này tự động thông qua OAuth 2.1 PKCE flow. Bạn cũng có thể cung cấp một mã thông báo theo cách thủ công để thử nghiệm.
OAuth 2.1 PKCE flow
Flowstep thực hiện một máy chủ ủy quyền OAuth 2.1 đầy đủ tạihttps://api.flowstep.ai. Các máy khách MCP khám phá và hoàn thành luồng tự động: chúng mở một cửa sổ trình duyệt để bạn đăng nhập và phê duyệt truy cập, sau đó xử lý trao đổi mã thông báo phía sau các cảnh.
Các phương pháp đăng nhập được hỗ trợ
Trang ủy quyền tại/oauth/authorize hỗ trợ:
- Email/password — bất kỳ tài khoản Flowstep nào có mật khẩu được đặt
- Google SSO — chuyển hướng qua xác thực xã hội Supabase, trả lại máy khách tự động
Xem lại và phê duyệt truy cập
Sau khi bạn đăng nhập, Flowstep hiển thị một màn hình đồng ý trước khi cấp một mã thông báo — không có máy khách nào có thể hoàn thành kết nối mà không có sự phê duyệt rõ ràng của bạn. Màn hình được tiêu đề Authorize access và đặt tên cho máy khách yêu cầu truy cập — tên máy khách in đậm, theo sau là “is requesting access to your Flowstep account” — sau đó hiển thị You’ll be redirected to và máy chủ đích. Chọn Allow để hoàn thành kết nối hoặc Deny để hủy. Từ chối sẽ trả về máy khách một lỗiaccess_denied và không phát hành mã thông báo.
Tạo tài khoản cho người dùng kết nối claude.ai
Trang đăng nhập OAuth không bao gồm biểu mẫu đăng ký. Nếu bạn kết nối qua trình kết nối tùy chỉnh claude.ai và chưa có tài khoản Flowstep, hãy tạo một tài khoản trước tại app.flowstep.ai, sau đó quay lại cài đặt trình kết nối để xác thực.Cookie fallback
Nếu không có tiêu đềAuthorization, middleware sẽ quay lại một phiên Supabase dựa trên cookie. Điều này hoạt động khi truy cập /mcp trực tiếp từ một trình duyệt có một phiên Flowstep hoạt động. Các máy khách MCP luôn sử dụng đường dẫn Bearer.
Manual token (testing)
Để gọi điểm cuối trực tiếp mà không có luồng OAuth của máy khách:- Đăng nhập vào app.flowstep.ai trong trình duyệt của bạn
- Mở DevTools → Console, chạy:
- Truyền mã thông báo dưới dạng một tiêu đề: