/mcp yêu cầu Bearer token trong header Authorization. Các máy khách MCP tự động lấy token thông qua luồng OAuth 2.1 PKCE. Bạn không cần tạo, dán hoặc thay đổi API key nào. Bạn cũng có thể cung cấp token thủ công để kiểm thử.
Luồng OAuth 2.1 PKCE
Flowstep vận hành máy chủ ủy quyền OAuth 2.1 riêng tạihttps://api.flowstep.ai. Các máy khách MCP tự động tìm và hoàn tất luồng này: chúng mở một cửa sổ trình duyệt để bạn đăng nhập và phê duyệt quyền truy cập, sau đó xử lý việc trao đổi token ở phía sau. Máy khách có thể tự đăng ký động, nên bạn không cần thiết lập client ID trước.
Các phương thức đăng nhập được hỗ trợ
Trang ủy quyền tại/oauth/authorize hỗ trợ:
- Email/password: mọi tài khoản Flowstep đã đặt mật khẩu
- Google SSO: chuyển hướng qua xác thực mạng xã hội của Supabase, sau đó tự động quay lại máy khách
Xem xét và phê duyệt quyền truy cập
Sau khi đăng nhập, Flowstep hiển thị màn hình chấp thuận trước khi cấp token. Không máy khách nào có thể hoàn tất kết nối nếu bạn chưa phê duyệt rõ ràng. Màn hình có tiêu đề Authorize access và nêu tên máy khách đang yêu cầu quyền truy cập. Tên máy khách hiển thị in đậm, theo sau là dòng “is requesting access to your Flowstep account” (đang yêu cầu quyền truy cập vào tài khoản Flowstep của bạn). Tiếp theo là You’ll be redirected to và tên máy chủ đích. Chọn Allow để hoàn tất kết nối, hoặc Deny để hủy. Khi bạn từ chối, máy khách nhận lỗiaccess_denied và không có token nào được cấp.
Tạo tài khoản cho người dùng connector claude.ai
Trang đăng nhập OAuth không có biểu mẫu đăng ký. Nếu bạn thêm connector Flowstep từ thư mục connector của Claude và chưa có tài khoản Flowstep, hãy tạo tài khoản trước tại app.flowstep.ai, sau đó quay lại Claude để hoàn tất kết nối.Dự phòng bằng cookie
Nếu không có headerAuthorization, middleware sẽ dùng phiên Supabase dựa trên cookie. Cách này hoạt động khi bạn truy cập /mcp trực tiếp từ trình duyệt đang có phiên Flowstep. Các máy khách MCP luôn dùng đường dẫn Bearer.
Token thủ công (kiểm thử)
Để gọi trực tiếp endpoint mà không cần 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, rồi chạy:
- Truyền token dưới dạng header: