Skip to main content
Điểm cuối /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ại https://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ỗi access_denied và không phát hành mã thông báo.
Tên máy khách được đặt bởi bất kỳ ai đã đăng ký máy khách, vì vậy hãy coi nó là một nhãn chứ không phải bằng chứng nhận dạng. Trước khi bạn nhấp Allow, hãy kiểm tra xem máy chủ dưới You’ll be redirected to có phải là máy chủ bạn mong đợi cho máy khách bạn kết nối hay không.

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. 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:
  1. Đăng nhập vào app.flowstep.ai trong trình duyệt của bạn
  2. Mở DevTools → Console, chạy:
  1. Truyền mã thông báo dưới dạng một tiêu đề:
MCP sessions last 30 days — the server refreshes the underlying token transparently, so clients using the OAuth flow don’t need to re-authenticate during normal use. A manually extracted token like the one above still expires after about an hour; it’s for quick testing only.