Chuyển đến nội dung chính
Endpoint /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ại https://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ỗi access_denied và không có token nào được cấp.
Tên máy khách do người đã đăng ký máy khách đặt, vì vậy hãy xem đó là nhãn hiển thị chứ không phải bằng chứng danh tính. Trước khi nhấn Allow, hãy kiểm tra máy chủ đích dưới You’ll be redirected to có đúng với máy khách bạn đang kết nối không.

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. Nếu không có header Authorization, 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:
  1. Đăng nhập vào app.flowstep.ai trong trình duyệt của bạn
  2. Mở DevTools → Console, rồi chạy:
  1. Truyền token dưới dạng header:
Phiên MCP kéo dài 30 ngày. Máy chủ tự động làm mới token bên dưới, vì vậy các máy khách dùng luồng OAuth không cần xác thực lại trong quá trình sử dụng bình thường. Token thủ công được trích xuất như trên vẫn hết hạn sau khoảng một giờ; chỉ dùng cho kiểm thử nhanh.